Registo da Extensão do Flyer Ad - Em massa
Define uma extensão de anúncio de panfleto que pode ser transferida e carregada num ficheiro em massa.
As Extensões flyer permitem que os anunciantes distribuam catálogos de produtos ou lojas (panfletos) a potenciais clientes.
Podem apresentar-se de forma proeminente em consultas abrangentes como "ofertas semanais" ou "vendas semanais" e, assim, incentivar os compradores a clicar no seu anúncio em vez do do concurso. Por natureza, ajudam a informar melhor os searchers e, como resultado, a aumentar a cativação dos utilizadores, por exemplo, clique através da taxa.
Nota
As Extensões flyer estão disponíveis para clientes no piloto de funcionalidades (GetCustomerPilotFeatures devolve 802).
Pode associar uma extensão de anúncio de panfleto à conta ou a campanhas e grupos de anúncios na conta. Cada entidade (conta, campanha ou grupo de anúncios) pode ser associada a até 3 extensões de anúncios de panfleto. Utilize os registos Account Flyer Ad Extension, Ad Group Flyer Ad Extension e Campaign Flyer Ad Extension para gerir associações de extensões de anúncios de panfleto.
Pode transferir todos os registos da Extensão flyer Ad na conta ao incluir o valor DownloadEntity de FlyerAdExtensions 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 flyer Ad à biblioteca partilhada da conta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,
Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkFlyerAdExtension , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.
// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
// '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
// FlyerAdExtension object of the Campaign Management service.
FlyerAdExtension = new FlyerAdExtension
{
// 'Description' column header in the Bulk file
Description = "Flyer description",
// 'Id' column header in the Bulk file
Id = flyerAdExtensionIdKey,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Flyer Name' column header in the Bulk file
FlyerName = "Flyer name",
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new[] {
(long)12345678,
},
// 'Media Urls' column header in the Bulk file
ImageMediaUrls = null,
// 'Store Id' column header in the Bulk file
StoreId = 12345678,
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
// '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(bulkFlyerAdExtension);
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 flyer Ad , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- Agenda de Anúncios
- ID de Cliente
- Descrição
- Localização Editorial
- Código do Motivo Editorial
- Estado Editorial
- Termo Editorial
- Data de Fim
- Final Url
- Nome do Panfleto
- ID
- IDs de Multimédia
- URLs de Multimédia
- Url Final do Dispositivo Móvel
- Hora da Modificação
- ID principal
- Países do Publisher
- Data de Início
- Estado
- ID da Loja
- 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 Agendamento de Anúncios e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar ambos os campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para cada um destes campos serão removidos ou substituídos.
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
Descrição
Descrição que pode ser utilizada pelo anunciante, agência ou gestor de conta para controlar, etiquetar ou gerir extensões de panfleto.
Esta descrição não é apresentada com o anúncio ou imagem.
O comprimento máximo para este elemento é de 1024 carateres.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
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.
A Data de Fim tem de ser até 30 dias após a Data de Início.
Adicionar: Necessário
Atualização: Opcional. A data de fim pode ser abreviada ou prolongada, desde que a data de início não esteja definida ou ocorra até 30 dias antes da nova data de fim.
Eliminar: Só de leitura
Final Url
O URL da página de destino.
As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.
- O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
- Pode especificar até 10 itens de lista para Url Final e Url Final móvel; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 itens de lista para potencial compatibilidade de reencaminhamento.
- Cada URL é delimitado por um ponto e vírgula e espaço ("; ").
- A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo {lpurl}.
- Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://.
- Se especificar Url Final para Dispositivos Móveis, também tem de especificar Url Final.
Adicionar: Necessário
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
Nome do Panfleto
O nome do panfleto.
O comprimento máximo para este elemento é de 150 carateres.
Adicionar: Necessário
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
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 Ad Group Flyer Ad e a Extensão do Ad Campaign Flyer Ad. 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
IDs de Multimédia
O identificador da imagem a incluir no anúncio.
Só pode definir um ID de multimédia.
Cada ID de multimédia corresponde a uma Imagem do subtipo "GenericImage".
A imagem deve ter uma largura e altura mínimas de 220 px e um tamanho de ficheiro máximo de 3,9 MB.
Adicionar: Necessário
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
URLs de Multimédia
O URL do suporte de dados que já adicionou.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Url Final do Dispositivo Móvel
O URL da página de destino para dispositivos móveis.
As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.
- O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
- Pode especificar até 10 itens de lista para Url Final e Url Final móvel; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 itens de lista para potencial compatibilidade de reencaminhamento.
- Cada URL é delimitado por um ponto e vírgula e espaço ("; ").
- A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo {lpurl}.
- Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://.
- Se especificar Url Final para Dispositivos Móveis, também tem de especificar Url Final.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
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
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.
A Data de Fim tem de ser até 30 dias após a Data de Início.
Adicionar: Necessário
Atualização: Opcional. A data de início pode ser abreviada ou prolongada, desde que a data de fim não esteja definida ou ocorra até 30 dias após a nova data de início.
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.
ID da Loja
O identificador exclusivo de uma loja do Microsoft Merchant Center utilizada para anúncios de produtos.
Adicionar: Opcional
Atualização: Só de leitura. Não é possível atualizar o ID da loja depois de ter sido definido.
Eliminar: Só de leitura
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 Agendamento de Anúncios e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar ambos os campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para cada um destes campos serão removidos ou substituídos.
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