Registo da Extensão do Ad de Imagem - Em Massa

Artigo
12/21/2023

Define uma extensão de anúncio de imagem que pode ser transferida e carregada num ficheiro em massa.

Pode associar uma extensão de anúncio de imagem à conta ou a campanhas e grupos de anúncios na conta. Cada conta pode ter até 250.000 associações de extensão de imagem de campanha e até 250.000 associações de extensão de imagem de grupo de anúncios. Cada entidade (conta, campanha ou grupo de anúncios) pode ser associada a até 25 extensões de anúncios de imagem. Utilize os registos Account Image Ad Extension, Ad Group Image Ad Extension e Campaign Image Ad Extension para gerir associações de extensões de anúncios de imagem.

Pode transferir todos os registos da Extensão do Image Ad na conta ao incluir o valor DownloadEntity de ImageAdExtensions 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 Imagem à biblioteca partilhada da conta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

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 BulkImageAdExtension , 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 BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // '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 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

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 Imagem , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Agenda de Anúncios
Texto Alternativo
ID de Cliente
Parâmetro Personalizado
URL de Destino
Apresentar Texto
Localização Editorial
Código do Motivo Editorial
Estado Editorial
Termo Editorial
Data de Fim
Final Url
Sufixo de URL Final
ID
Imagens
Esquemas
IDs de Multimédia
Url Final do Dispositivo Móvel
Hora da Modificação
ID principal
Países do Publisher
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

Texto Alternativo

Descrição alternativa do suporte de dados de imagem para utilização. Se não for possível apresentar a imagem, é utilizado o texto alternativo.

O comprimento máximo para este campo é de 90 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 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

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

URL de destino

O URL da página Web para onde levar o utilizador quando clicar na imagem.

O URL pode conter cadeias de texto dinâmicas, como {keyword}. Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?.

O URL pode conter um máximo de 1024 carateres. Se o URL não especificar um protocolo, o sistema utiliza o protocolo HTTP quando um utilizador clica no anúncio. Se o URL especificar o protocolo HTTP ao adicionar um anúncio, o serviço removerá a cadeia de protocolo http:// (a cadeia de protocolo HTTP não conta para o limite de 1024 carateres); no entanto, o serviço não removerá uma cadeia de protocolo HTTPS (https://) do URL.

Nota

Se o URL não for especificado para a extensão de anúncio de imagem, é utilizado o URL do anúncio.

Adicionar: Opcional. Nota: Este campo é necessário para extensões de anúncios com várias imagens. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Nota: Este campo é necessário para extensões de anúncios com várias imagens.
Eliminar: Só de leitura

Apresentar Texto

O texto a apresentar da sua extensão de imagem.

O comprimento máximo para este campo é de 35 carateres.

Adicionar: Necessário
Atualização: Obrigatório. 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.

Valor	Descrição
Ativo	A extensão de anúncios passou na revisão editorial.
ActiveLimited	A extensão de anúncios aprovou uma revisão editorial em um ou mais mercados, e um ou mais elementos da extensão de anúncios estão a ser analisados editorialmente noutro mercado. Por exemplo, a extensão de anúncios passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	A extensão de anúncio falhou na revisão editorial.
Inativo	Um ou mais elementos da extensão de anúncios estão a ser submetidos a uma revisão editorial.

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: 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

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 da Imagem de Grupo do Ad e a Extensão do Anúncio da Imagem 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

Imagens

Recursos de imagem com diferentes tamanhos e proporções para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

Só tem de fornecer um recurso de imagem horizontal, ou seja, este campo tem de conter um elemento de imagem com o subtipo definido como LandscapeImageMedia. As dimensões recomendadas para LandscapeImageMedia têm 1200 larguras x 628 de altura. Opcionalmente, pode incluir ligações de recursos adicionais, ou seja, um recurso de imagem para cada subtipo suportado. Para os subtipos de recursos de imagem que não definir explicitamente, o Microsoft Advertising criará automaticamente ligações de elementos de imagem ao recortar LandscapeImageMedia.

Os recursos de imagem são representados no ficheiro em massa como uma cadeia JSON. Estão incluídas sete imagens no JSON de exemplo abaixo e apenas o LandscapeImageMedia subType não é recortado. O id é uma propriedade do recurso, enquanto que , cropHeightcropWidth, cropX, cropYe subType são propriedades da ligação do elemento, ou seja, a relação entre o elemento e o anúncio. Para obter mais detalhes, veja cropHeight, cropWidth, cropX, cropY, id e subType abaixo.

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Nota

No ficheiro em massa separado por vírgulas, terá de colocar a lista de ligações de recursos, cada chave de atributo e cada valor de cadeia de atributo com um conjunto extra de aspas duplas, por exemplo, a cadeia JSON acima seria escrita como "[{""id"":1234567890000,""subType"":""LandscapeImageMedia""},{"id"":1234567890000,""subType"":""SquareImageMedia"","cropX":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{"id"":1234567890000, ""subType"":""ImageMedia169X100"","cropX"":70,""cropY":0,""cropWidth"":1061,""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia93X100"","cropX":308,""cropY":0,""cropWidth"":584,""cropHeight"":628},{"""id":1234567890000,""subType":""ImageMedia15X10"","cropX":129,""cropY":0,""cropWidth"":942,""cropHeight"":628},{"id"":1234567890000,""subType":""ImageMedia155X100"","cropX":114,""cropY":0,""cropWidth"":973,""cropHeight"" :628},{""id"":1234567890000,""subType"":""ImageMedia133X100"","cropX":183,""cropY"":0,""cropWi "":835,""cropHeight"":628},{"id":1234567890000,""subType":""ImageMedia178X100"","cropX""":41,""cropY":0,""cropWidth":1118,""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia172X100"","cropX":60,""cropY":0,""cropWidth"":1080,""cropHeight"":628}]".

Tendo em conta o exemplo JSON de resposta ao carregamento acima, tome nota do seguinte:

O mesmo identificador de recurso de imagem (por exemplo, 1234567890000) é utilizado para todos os subtipos de recursos de imagem gerados automaticamente. Quer permita ou não que o Microsoft Advertising gere automaticamente as imagens recortadas, o ID não tem de ser exclusivo entre os recursos de imagem associados ao mesmo anúncio.
Uma vez que o anúncio neste exemplo foi criado sem definições de recorte para o sub-tipo de recurso de imagem LandscapeImageMedia, todos os recursos de imagem são recortados, exceto a imagem horizontal original.
Quer a imagem horizontal tenha ou não as suas próprias definições de recorte, o Microsoft Advertising utiliza a altura real da imagem horizontal para todas as predefinições de recorte. Neste exemplo, a altura de recorte para todos os recursos de imagem gerados pelo sistema é 628 e podemos inferir que a imagem horizontal (sub tipo horizontalImageMedia) com uma proporção de 1,91:1 tem largura e altura de 1200x628. Mesmo que a ligação do elemento de imagem horizontal tivesse sido criada com definições de recorte, por exemplo, 703x368, as definições de recorte dos recursos de imagem gerados automaticamente baseiam-se nas dimensões completas da imagem horizontal (mais uma vez, seria 1200x628 neste exemplo).

cropHeight

O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição cropY e movendo-se para cima.

cropWidth

O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição cropX e movendo-se para a direita.

cropX

A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a ignorar para a direita no eixo x antes de aplicar a cropWidth.

recortarY

A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a saltar para cima no eixo y antes de aplicar o cropHeight.

ID

O id atributo é um identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising.

O mesmo identificador de recurso de imagem pode ser utilizado várias vezes no mesmo anúncio para diferentes proporções e também pode ser utilizado por vários anúncios na mesma conta microsoft Advertising. O identificador do recurso de imagem com SubType definido como LandscapeImageMedia é utilizado para todos os subtipos de recursos de imagem gerados automaticamente no mesmo anúncio. Quer permita ou não que o Microsoft Advertising gere automaticamente as imagens recortadas, o ID não tem de ser exclusivo entre os recursos de imagem associados ao mesmo anúncio.

Pode criar imagens para extensões de anúncios de imagens através do registo em massa Imagem . Em seguida, pode utilizar o identificador de multimédia devolvido como o ID do recurso de imagem. A proporção da imagem que adicionou tem de ser suportada para o subtipo de recurso de imagem.

subtipo

O subType atributo representa a proporção deste recurso de imagem.

A verdadeira proporção da Imagem armazenada na biblioteca de multimédia ao nível da conta pode variar, desde que as dimensões resultantes resultem na proporção esperada por subtipo. Se não especificar as definições de recorte, o serviço irá recortar automaticamente para a área máxima possível a partir do centro da imagem. Por exemplo, tendo em conta uma imagem de 1000x1000 píxeis, para a proporção de 1,91:1, a definição de recorte automático será cropWidth=1000, cropHeight=524, cropX=0 e cropY=238.

Os valores de subtipo possíveis incluem LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X10, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 e ImageMedia172X100. Poderão ser adicionados novos subtipos no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

Subtipo	Dimensões mínimas em píxeis
LandscapeImageMedia	703 largura x 368 alturas Rádio de aspeto 1.91:1
SquareImageMedia	300 largura x 300 alturas Rádio de aspeto 1:1
ImagemMedia169X100	622 largura x 368 altura Rádio de aspeto 1.69:1
ImagemMedia93X100	311 largura x 333 altura Rádio de aspeto 0.93:1
ImagemMedia15X10	300 largura x 200 alturas Rádio de aspeto 1.5:1
ImagemMedia155X100	300 larguras x 194 alturas Rádio de aspeto 1.55:1
ImagemMedia133X100	100 larguras x 75 alturas Rádio de aspeto 1.33:1
ImageMedia178X100	624 largura x 350 alturas Rádio de aspeto 1.78:1
ImagemMedia172X100	300 largura x 174 alturas Rádio de aspeto 1.72:1

Adicionar: Obrigatório. Apenas o ID e o subtipo são necessários para cada ligação de recurso.
Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este campo vazio. Se definir este campo, todas as imagens anteriormente ligadas a este anúncio serão substituídas. Se definir este campo, apenas o ID e o subtipo são necessários para cada ligação de recurso.
Eliminar: Só de leitura

Esquemas

A lista de esquemas de imagem elegíveis.

Os valores suportados são SearchSingle e SearchMultiple. Poderão ser adicionados novos esquemas no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

Num ficheiro em massa, a lista de cadeias de esquema é delimitada com um ponto e vírgula (;).

Adicionar: Opcional. Se não definir este campo, todos os esquemas suportados atuais e futuros serão definidos por predefinição.
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

IDs de Multimédia

Os identificadores das imagens a incluir no anúncio. Não pode especificar identificadores de multimédia para mais do que uma imagem da mesma proporção. Por outras palavras, cada uma das imagens referenciadas tem de ter proporções diferentes.

Pode especificar até quatro (4) identificadores de imagem . Embora o mínimo necessário seja um ID de multimédia de imagem, para se qualificar para todas as colocações de anúncios, tem de fornecer quatro identificadores de multimédia de imagem.

Num ficheiro em massa, a lista de identificadores de multimédia é delimitada com um ponto e vírgula (;).

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.

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.

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.

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

Partilhar via

Registo da Extensão do Ad de Imagem - Em Massa

Agenda de Anúncios

Texto Alternativo

ID de Cliente

Parâmetro Personalizado

URL de destino

Apresentar Texto

Localização Editorial

Código do Motivo Editorial

Estado Editorial

Termo Editorial

Data de Fim

Final Url

Sufixo de URL Final

ID

Imagens

cropHeight

cropWidth

cropX

recortarY

ID

subtipo

Esquemas

IDs de Multimédia

Url Final do Dispositivo Móvel

Hora da Modificação

ID principal

Países do Publisher

Data de Início

Estado

Modelo de Controlo

Utilizar Fuso Horário do Searcher

Versão

Comentários

Recursos adicionais