Registo da Extensão do Ad de Promoção - Em massa
Define uma extensão de anúncios de promoção que pode ser transferida e carregada num ficheiro em massa.
Nota
As Extensões de Promoção estão disponíveis para clientes na AU, CA, DE, FR, E.U.A. e Reino Unido.
Pode associar uma extensão de anúncios de promoção à 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é 20 extensões de anúncios de promoção. Utilize os registos Account Promotion Ad Extension, Ad Group Promotion Ad Extension e Campaign Promotion Ad Extension para gerir associações de extensão de anúncios de promoção.
Pode transferir todos os registos da Extensão do Anúncio de Promoção na conta ao incluir o valor DownloadEntity de PromotionAdExtensions 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 Promoção à biblioteca partilhada da conta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD
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 BulkPromotionAdExtension , 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 BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
// '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
// PromotionAdExtension object of the Campaign Management service.
PromotionAdExtension = new PromotionAdExtension
{
// 'Id' column header in the Bulk file
Id = promotionAdExtensionIdKey,
// 'Currency Code' column header in the Bulk file
CurrencyCode = "USD",
// 'Discount Modifier' column header in the Bulk file
DiscountModifier = PromotionDiscountModifier.None,
// 'Language' column header in the Bulk file
Language = "English",
// 'Money Amount Off' column header in the Bulk file
MoneyAmountOff = null,
// 'Orders Over Amount' column header in the Bulk file
OrdersOverAmount = null,
// 'Percent Off' column header in the Bulk file
PercentOff = 20000000,
// 'Promotion Code' column header in the Bulk file
PromotionCode = "SAVE20",
// 'Promotion Target' column header in the Bulk file
PromotionItem = "shoes",
// 'Occasion' column header in the Bulk file
PromotionOccasion = PromotionOccasion.WomensDay,
// 'Promotion End' column header in the Bulk file
PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Promotion Start' column header in the Bulk file
PromotionStartDate = null,
// '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/womenshoesale"
},
// '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/womenshoesale"
},
// '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(bulkPromotionAdExtension);
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 de Extensão de Anúncio de Promoção , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- Agenda de Anúncios
- ID de Cliente
- Código de Moeda
- Parâmetro Personalizado
- Modificador de Descontos
- Localização Editorial
- Código do Motivo Editorial
- Estado Editorial
- Termo Editorial
- Data de Fim
- Final Url
- Sufixo de URL Final
- ID
- Idioma
- Url Final do Dispositivo Móvel
- Hora da Modificação
- Montante Do Dinheiro Desativado
- Ocasião
- Encomendas Acima do Montante
- ID principal
- Países do Publisher
- Código de Promoção
- Fim da Promoção
- Início da Promoção
- Destino da Promoção
- Data de Início
- Estado
- Modelo de Controlo
- 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
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 de Moeda
O código de moeda para o preço de promoção ou desconto.
Este campo só é aplicável se definir Montante Em Atraso ou Encomendas Acima do Montante.
Os códigos de moeda suportados são ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD e VEF.
Adicionar: Necessário se o Montante Do Dinheiro Desativado ou As Encomendas Por Excesso de Montante estiverem definidos.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir Percentagem de Desconto ou Código de Promoção, esta definição já não é aplicável e será eliminada.
Eliminar: Só de leitura
Parâmetro Personalizado
A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.
Num ficheiro em massa, a lista de parâmetros personalizados é formatada da seguinte forma.
Formate cada par de parâmetros personalizado como Key=Value, por exemplo {_promoCode}=PROMO1.
O Microsoft Advertising aceitará os três primeiros pares de chave e valor personalizados que incluir e quaisquer parâmetros personalizados adicionais serão ignorados. Para os clientes no piloto de Aumento do Limite de Parâmetros Personalizados Fase 3 (GetCustomerPilotFeatures devolve 635), o Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados incluídos e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro.
Cada par chave e valor é delimitado por um ponto e vírgula e espaço ("; "), por exemplo {_promoCode}=PROMO1; {_season}=verão.
Uma Chave não pode conter um ponto e vírgula. Se um Valor contiver um ponto e vírgula, tem de ser escapado como '\;'. Além disso, se o Valor contiver uma barra invertida, também terá de ser escapado como "\".
A Chave não pode exceder os 16 bytes UTF-8 e o Valor não pode exceder os 200 bytes UTF-8. Para os clientes no piloto de Aumento do Limite de Parâmetros Personalizados Fase 3 (GetCustomerPilotFeatures devolve 635), o Limite de valores aumenta para 250 bytes UTF-8. A Chave é necessária e o Valor é opcional. O tamanho máximo da Chave não inclui as chavetas e o caráter de sublinhado, ou seja, "{", "_" e "}".
Nota
Com o serviço em massa, a Chave tem de ser formatada com chavetas adjacentes e um caráter de sublinhado à esquerda, por exemplo, se a Chave for promoCode, tem de ser formatada como {_promoCode}. Com o serviço Gestão de Campanhas, não pode especificar as chavetas adjacentes e o caráter de sublinhado.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os parâmetros personalizados, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter e omita os que não pretende manter. O novo conjunto de parâmetros personalizados substituirá qualquer conjunto de parâmetros personalizados anterior.
Eliminar: Só de leitura
Modificador de Descontos
O modificador de desconto de promoção.
Os valores possíveis para este campo são None e UpTo.
- Nenhum: o desconto de promoção não é modificado.
- UpTo: o desconto de promoção é modificado com o prefixo de cadeia "Até". Por exemplo, se o desconto de promoção não modificado for "$20 fora dos sapatos", a promoção modificada será "Até 20 $ sem sapatos".
Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de Nenhum será definido.
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
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
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
Sufixo de URL Final
O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.
Nota
Esta funcionalidade só está disponível para clientes no piloto Fase 3 do Sufixo de URL Final (GetCustomerPilotFeatures devolve 636). Se não estiver no piloto, esta propriedade será ignorada e não será devolvido nenhum erro.
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
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 Promoção de Grupo do Ad e a Extensão do Anúncio de Promoção de 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
Idioma
O idioma em que a extensão de anúncios será fornecida.
A extensão será sempre servida neste idioma, independentemente das definições de idioma da campanha ou do grupo de anúncios.
As cadeias de idioma suportadas são: dinamarquês, neerlandês, inglês, finlandês, francês, alemão, italiano, norueguês, português, espanhol, sueco e tradicionalchinês.
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
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
Montante Do Dinheiro Desativado
O dinheiro fora do valor de promoção.
Por exemplo, para promover "$20 desativado - Em encomendas superiores a 100 $", defina o Destino da Promoção como "sapatos", defina o Código de Moeda como "USD", defina Montante Monetário Desativado para 20 e defina Encomendas Acima do Valor para 100.
Adicionar: Obrigatório. Tem de definir o Valor Do Dinheiro Desativado ou a Percentagem de Desconto, mas não pode definir ambos.
Atualização: Opcional. Pode definir o Valor Do Dinheiro Desativado ou a Percentagem de Desconto, mas não pode definir ambos.
Eliminar: Só de leitura
Ocasião
A ocasião de promoção.
Tanto os campos Ocasião de promoção como Agendamento (Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher ) determinam quando a promoção é elegível para ser apresentada em anúncios.
A Ocasião de promoção determina o período de tempo ou sazonalidade, por exemplo, WomensDay de 15 de fevereiro a 31 de março de cada ano. A promoção só será executada nas datas correspondentes à ocasião que definiu. Consulte a tabela abaixo para obter detalhes sobre o intervalo de datas definido para cada ocasião.
O Agendamento pode limitar a promoção a um período de tempo mais curto dentro do intervalo de datas da ocasião, por exemplo, limitar a promoção a ser executada de 20 de fevereiro a 8 de março. O Agendamento também pode ser usado para executar a mesma promoção vários anos, por exemplo, executar a promoção WomensDay todos os anos de 15 de fevereiro a 31 de março.
Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de Nenhum será definido.
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, o Início da Promoção e o Fim da Promoção também têm de ser definidos para manter ou atualizar as definições anteriores.
Eliminar: Só de leitura
Encomendas Acima do Montante
O valor das encomendas sobre o valor acrescentado ao destino da promoção.
Por exemplo, para promover "$20 desativado - Em encomendas superiores a 100 $", defina o Destino da Promoção como "sapatos", defina o Código de Moeda como "USD", defina Montante Monetário Desativado para 20 e defina Encomendas Acima do Valor para 100.
Adicionar: Opcional. Não pode definir Encomendas Acima do Montante e Código de Promoção.
Atualização: Opcional. Não pode definir Encomendas Acima do Montante e Código de Promoção. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo como "0" (zero), a definição anterior será eliminada.
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
Percentagem de Desconto
O valor de promoção de percentagem de desconto como um valor duplo.
Por exemplo, 10,0 representa um desconto de 10%.
Adicionar: Obrigatório. Tem de definir o Valor Do Dinheiro Desativado ou a Percentagem de Desconto, mas não pode definir ambos.
Atualização: Opcional. Pode definir o Valor Do Dinheiro Desativado ou a Percentagem de Desconto, mas não pode definir ambos. Se definir este campo, a definição Código de Moeda já não é aplicável e será eliminada se tiver sido definida anteriormente.
Eliminar: Só de leitura
Código de Promoção
O código de promoção acrescentado ao destino da promoção.
Por exemplo, para promover "$20 off shoes - Promocode SAVE20", defina o Destino da Promoção como "sapatos", defina Código de Moeda como "USD", defina Money Amount Off como 20 e defina Código de Promoção como "SAVE20".
A cadeia pode conter um máximo de 15 carateres.
Adicionar: Opcional. Não pode definir Encomendas Acima do Montante e Código de Promoção.
Atualização: Opcional. Não pode definir Encomendas Acima do Montante e Código de Promoção. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo como a cadeia de delete_value , a definição anterior será eliminada. Se definir este campo, a definição Código de Moeda já não é aplicável e será eliminada se tiver sido definida anteriormente.
Eliminar: Só de leitura
Fim da Promoção
A data de fim ajuda a informar a data ou datas de promoção que serão apresentadas no anúncio.
Por exemplo, se as datas de Início de Promoção e Fim da Promoção estiverem definidas para 14 de fevereiro, o texto "14 de fevereiro válido" pode ser incluído na promoção apresentada.
A data de Início da Promoção tem de ser anterior ou igual à data de Fim da Promoção .
Esta propriedade não substitui o intervalo de entrega inerente para uma promoção. Tanto os campos Ocasião de promoção como Agendamento (Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher) determinam quando a promoção é elegível para ser apresentada em anúncios.
Se a data de fim já tiver passado para o ano atual, cada data de início e de fim tem de ser definida para datas durante o ano seguinte.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para eliminar a data de fim atual e definir efetivamente nenhuma data de fim, defina este campo como a cadeia de delete_value . Quando obter a extensão de anúncios de promoção da próxima vez, este campo não será definido.
Eliminar: Só de leitura
Início da Promoção
A data de início ajuda a informar a data ou datas de promoção que serão apresentadas no anúncio.
Por exemplo, se as datas de Início de Promoção e Fim da Promoção estiverem definidas para 14 de fevereiro, o texto "14 de fevereiro válido" pode ser incluído na promoção apresentada.
A data de Início da Promoção tem de ser anterior ou igual à data de Fim da Promoção .
Esta propriedade não substitui o intervalo de entrega inerente para uma promoção. Tanto os campos Ocasião de promoção como Agendamento (Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher) determinam quando a promoção é elegível para ser apresentada em anúncios.
Se a data de fim já tiver passado para o ano atual, cada data de início e de fim tem de ser definida para datas durante o ano seguinte.
Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para eliminar a data de fim atual e definir efetivamente nenhuma data de fim, defina este campo como a cadeia de delete_value . Quando obter a extensão de anúncios de promoção da próxima vez, este campo não será definido.
Eliminar: Só de leitura
Destino da Promoção
O destino ou item de promoção.
Por exemplo, pode fazer uma promoção para "sapatos" com um desconto de 20 $ ou 20%. Para executar uma promoção para "Até 20 $ sem sapatos", defina o Destino de Promoção como "sapatos", defina o Modificador de Desconto como "UpTo", defina o Código de Moeda como "USD" e defina Money Amount Off como 20.
A cadeia pode conter um máximo de 20 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
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
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.
Modelo de Controlo
O modelo de controlo a utilizar para os URLs de promoção.
As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?
Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.
O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.
O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.
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
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