Registo da Extensão do Ad de Localização - Em Massa
Define uma extensão de anúncio de localização que pode ser transferida e carregada num ficheiro em massa.
Pode associar uma extensão de anúncio de localização à conta ou a campanhas na conta. Cada entidade (conta ou campanha) pode ser associada ao número de extensões de anúncios de localização que decidir, até ao número total de extensões de anúncios de localização na sua conta. Utilize os registos Extensão de Anúncios de Localização da Conta e Extensão de Anúncios de Localização da Campanha para gerir associações de extensão de anúncios de localização.
Pode transferir todos os registos da Extensão do Ad de Localização na conta ao incluir o valor DownloadEntity de LocationAdExtensions no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.
O seguinte exemplo de CSV em Massa adicionaria uma nova Extensão de Anúncio de Localização à biblioteca partilhada da conta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US
Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkLocationAdExtension , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LocationAdExtension object of the Campaign Management service.
LocationAdExtension = new LocationAdExtension
{
Address = new Address
{
// 'City' column header in the Bulk file
CityName = "Woodinville",
// 'Country Code' column header in the Bulk file
CountryCode = "US",
// 'Postal Code' column header in the Bulk file
PostalCode = "98608",
// 'State Or Province Code' column header in the Bulk file
ProvinceCode = null,
// 'Province Name' column header in the Bulk file
ProvinceName = "WA",
// 'Address Line 1' column header in the Bulk file
StreetAddress = "1234 Washington Place",
// 'Address Line 2' column header in the Bulk file
StreetAddress2 = "Suite 1210",
},
// 'Business Name' column header in the Bulk file
CompanyName = "Contoso Shoes",
// 'Geo Code Status' column header in the Bulk file
GeoCodeStatus = null,
GeoPoint = new GeoPoint
{
// 'Latitude' column header in the Bulk file
LatitudeInMicroDegrees = 0,
// 'Longitude' column header in the Bulk file
LongitudeInMicroDegrees = 0,
},
// 'Id' column header in the Bulk file
Id = locationAdExtensionIdKey,
// 'Phone Number' column header in the Bulk file
PhoneNumber = "206-555-0100",
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkLocationAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Para um registo da Extensão do Ad de Localização , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- Agenda de Anúncios
- Linha de Endereço 1
- Linha de Endereço 2
- Nome da Empresa
- Localidade
- ID de Cliente
- Código do País
- Localização Editorial
- Código do Motivo Editorial
- Estado Editorial
- Termo Editorial
- Data de Fim
- Estado do Código Geográfico
- ID
- Latitude
- Longitude
- Hora da Modificação
- ID principal
- Número de Telefone
- Código Postal
- Nome da Província
- Países do Publisher
- Data de Início
- Código do Estado ou da Província
- Estado
- Utilizar Fuso Horário do Searcher
- Versão
Agenda de Anúncios
A lista de intervalos de dia e hora que pretende que a extensão de anúncios seja apresentada com os seus anúncios. Cada dia e intervalo de tempo inclui o dia agendado da semana, a hora de início/fim e o minuto de início/fim. Cada dia e intervalo de tempo é colocado entre parênteses esquerdo e direito e separado de outros intervalos de dia e hora com um delimitador de ponto e vírgula (;). Dentro de cada dia e intervalo de tempo, o formato é Day[StartHour:StartMinue-EndHour:EndMinute].
Os valores possíveis de StartHour variam entre 00 e 23, em que 00 é equivalente a 00:00 e 12 é 12:00PM.
Os valores possíveis de EndHour variam entre 00 e 24, em que 00 é equivalente a 12:00 E 12 é 12:00PM.
Os valores possíveis de StartMinute e EndMinute variam entre 00 e 60.
O exemplo seguinte demonstra os intervalos de dias e horas durante os dias úteis das 9:00 às 21:00: (Segunda-feira[09:00-21:00]);( Terça-feira[09:00-21:00]); (Quarta-feira[09:00-21:00]); (Quinta-feira[09:00-21:00]); (Sexta-feira[09:00-21:00])
Adicionar: Opcional. Se não definir este campo, a extensão de anúncios será elegível para agendamento em qualquer altura durante as datas de início e de fim do calendário.
Atualização: Opcional. Não é possível atualizar os intervalos de dia e de tempo individuais. Pode atualizar efetivamente os intervalos de dia e hora ao enviar um novo conjunto que deve substituir o conjunto anterior. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura
Linha de Endereço 1
A primeira linha do endereço.
A primeira linha pode conter um máximo de 80 carateres.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
Linha de Endereço 2
A segunda linha do endereço.
A segunda linha pode conter um máximo de 80 carateres.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, a definição anterior será removida.
Eliminar: Só de leitura
Nome da Empresa
O nome da empresa.
O nome pode conter um máximo de 80 carateres.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
Localidade
O nome da cidade onde se encontra o endereço da rua.
O nome pode conter um máximo de 80 carateres.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
ID de Cliente
Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.
Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura
Código do País
O país ou região onde se encontra o endereço da rua.
O código de país tem de conter um código de país de 2 carateres. Os valores de código de país/região suportados incluem AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE e VN.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
Localização Editorial
O componente ou propriedade da extensão de anúncio que falhou na revisão editorial.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Código do Motivo Editorial
Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Estado Editorial
O estado editorial da extensão de anúncios.
Os valores possíveis estão descritos na tabela abaixo.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Termo Editorial
O termo que falhou na revisão editorial.
Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Data de Fim
A cadeia de data de fim agendada da extensão de anúncio formatada como MM/DD/AAAA.
A data de fim é inclusiva. Por exemplo, se definir este campo como 31/12/2020, as extensões de anúncio deixarão de ser apresentadas às 23:59 a 31/12/2020.
Adicionar: Opcional. Se não especificar uma data de fim, a extensão de anúncios continuará a ser entregue, a menos que coloque em pausa as campanhas, grupos de anúncios ou anúncios associados.
Atualização: Opcional. A data de fim pode ser abreviada ou prolongada, desde que a data de início seja nula ou ocorra antes da nova data de fim. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de fim. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura
Estado do Código Geográfico
Um valor de estado que indica se as coordenadas de latitude e longitude da empresa foram determinadas.
Se fornecer as coordenadas, o estado será definido como Concluído; caso contrário, o estado indicará o progresso da determinação das coordenadas do endereço da empresa especificada.
Os valores possíveis estão descritos na tabela abaixo.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
ID
O identificador gerado pelo sistema da extensão de anúncios.
Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a extensão de anúncios pode, em seguida, ser referenciado no campo ID de tipos de registo dependentes, como a Extensão do Anúncio de Localização da Campanha. Isto é recomendado se estiver a adicionar novas extensões de anúncios e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório
Latitude
A latitude especificada em graus. A latitude tem de ser maior ou igual a -85 e menor ou igual a +85.
Nota
O serviço Gestão de Campanhas utiliza micro graus, ou seja, de -850000000 a 850000000. Quando utiliza BulkLocationAdExtension através dos SDKs, deve utilizar micro graus, porque a implementação BulkLocationAdExtension é convertida a partir de micro graus e escreve o valor como graus no ficheiro em massa.
As coordenadas de latitude e longitude são utilizadas para marcar a localização da empresa no Mapas Bing quando o utilizador clica no endereço no anúncio. Se as coordenadas especificadas não estiverem dentro do intervalo de valores válidos, o serviço determina as coordenadas com base no endereço.
Se especificar as coordenadas conhecidas, o serviço não confirma se as coordenadas especificadas correspondem ao endereço empresarial especificado. Se não fornecer as coordenadas, o Serviço em massa utiliza o endereço das empresas para determinar as coordenadas.
Nota
Ao adicionar mais de 10 extensões de anúncios de localização, o serviço resolve coordenadas offline e resolve coordenadas antecipadamente durante a execução da operação de serviço. A localização não será utilizada num anúncio até que as coordenadas sejam determinadas, o que pode demorar de segundos a minutos, consoante o número de extensões de anúncios de localização que estão a ser adicionadas e a procura atual.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura
Longitude
A longitude especificada em graus. A longitude tem de ser maior ou igual a -180 e menor ou igual a +180.
Nota
O serviço Gestão de Campanhas utiliza micro graus, ou seja, de -180000000 a 180000000. Quando utiliza BulkLocationAdExtension através dos SDKs, deve utilizar micro graus, porque a implementação BulkLocationAdExtension é convertida a partir de micro graus e escreve o valor como graus no ficheiro em massa.
As coordenadas de latitude e longitude são utilizadas para marcar a localização da empresa no Mapas Bing quando o utilizador clica no endereço no anúncio. Se as coordenadas especificadas não estiverem dentro do intervalo de valores válidos, o serviço determina as coordenadas com base no endereço.
Se especificar as coordenadas conhecidas, o serviço não confirma se as coordenadas especificadas correspondem ao endereço empresarial especificado. Se não fornecer as coordenadas, o Serviço em massa utiliza o endereço das empresas para determinar as coordenadas.
Nota
Ao adicionar mais de 10 extensões de anúncios de localização, o serviço resolve coordenadas offline e resolve coordenadas antecipadamente durante a execução da operação de serviço. A localização não será utilizada num anúncio até que as coordenadas sejam determinadas, o que pode demorar de segundos a minutos, consoante o número de extensões de anúncios de localização que estão a ser adicionadas e a procura atual.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura
Hora da Modificação
A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).
Nota
O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
ID principal
O identificador gerado pelo sistema da conta que contém a extensão de anúncios.
Este campo em massa mapeia para o campo ID do registo conta .
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Número de Telefone
O número de telefone clicável da empresa a incluir no anúncio.
O número de telefone pode conter um máximo de 35 carateres e tem de ser válido para o país ou região especificado.
Se a campanha também incluir uma extensão de chamada, o número de telefone na extensão da chamada substituirá o número de telefone da extensão de anúncio de localização.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura
Código Postal
O código postal ou postal.
O código postal pode conter um máximo de 80 carateres.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, a definição anterior será removida.
Eliminar: Só de leitura
Nome da Província
O nome do estado ou da província onde se encontra o endereço da rua, por exemplo Washington.
O nome pode conter um máximo de 50 carateres.
Tem de especificar o Nome da Província ou o Código do Estado ou da Província.
Nota
O State Or Province Code e o Province Name não são necessários se o campo Código do País estiver definido como FR, IE ou SG.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
Países do Publisher
A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.
Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Data de Início
A cadeia de data de início agendada da extensão de anúncio formatada como MM/DD/AAAA.
A data de início é inclusiva. Por exemplo, se definir StartDate como 5/05/2020, as extensões de anúncios começarão a ser apresentadas às 00:00 a 5/05/2020.
Adicionar: Opcional. Se não especificar uma data de início, a extensão de anúncio é imediatamente elegível para ser agendada.
Atualização: Opcional. A data de início pode ser abreviada ou prolongada, desde que a data de fim seja nula ou ocorra após a nova data de início. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de início e a extensão de anúncio é imediatamente elegível para ser agendada. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura
Código do Estado ou da Província
Um código que identifica o estado ou a província onde se encontra o endereço da rua, por exemplo WA.
O código pode conter um máximo de 50 carateres.
Tem de especificar o Nome da Província ou o Código do Estado ou da Província.
Nota
O State Or Province Code e o Province Name não são necessários se o campo Código do País estiver definido como FR, IE ou SG.
Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura
Estado
O estado da extensão de anúncios.
Os valores possíveis são Ativos ou Eliminados.
Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.
Utilizar Fuso Horário do Searcher
Determina se deve utilizar o fuso horário da conta ou o fuso horário do utilizador de pesquisa onde os anúncios podem ser entregues.
Defina esta propriedade como VERDADEIRO se quiser que as extensões de anúncios sejam apresentadas no fuso horário do utilizador de pesquisa e, caso contrário, defina-a como FALSO.
Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido e o fuso horário da conta será utilizado.
Atualização: Opcional. Se definir este campo para a cadeia de delete_value, está efetivamente a repor para o valor predefinido falso. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura
Versão
O número de vezes que o conteúdo da extensão de anúncios foi atualizado. A versão é definida como 1 quando adiciona a extensão e é incrementada sempre que é revista.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura