Registo de Anúncios Reativo - Em Massa

Define um anúncio reativo que pode ser transferido e carregado num ficheiro em massa.

Os anúncios reativos ajustam-se automaticamente para acomodar os tamanhos e formas dos formatos de anúncios de audiência. Estes anúncios funcionam melhor com texto informativo em vez de chamadas à ação.

Nota

Esta funcionalidade está atualmente disponível nos Estados Unidos, Canadá, Reino Unido e Austrália. Se anunciar nos Estados Unidos, Canadá, Reino Unido ou Austrália e quiser optar ativamente por participar em anúncios de audiência, contacte o suporte.

Nota

Os anúncios reativos duplicados são permitidos no mesmo grupo de anúncios.

Pode transferir todos os registos de Anúncios Reativos na conta ao incluir o valor DownloadEntity de ResponsiveAds 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 um novo anúncio reativo se fosse fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

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 BulkResponsiveAd , 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 BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // '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"
        },
        // '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"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveAd);

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

• Grupo de Anúncios
• Nome da Empresa
• Chamada à Ação
• Chamar para idioma de ação
• Campanha
• ID de Cliente
• Parâmetro Personalizado
• Descrições
• Estatuto de Recurso Editorial
• Localização Editorial
• Código do Motivo Editorial
• Estado Editorial
• Termo Editorial
• Final Url
• Cabeçalho
• Cabeçalhos
• Sufixo de URL Final
• ID
• Imagens
• Urls de Controlo de Impressões
• ID de Multimédia de Imagem Horizontal
• ID do Suporte de Dados do Logótipo horizontal
• Cabeçalho Longo
• Cabeçalhos Longos
• Cadeia de Cabeçalho Longo
• Url Final do Dispositivo Móvel
• Hora da Modificação
• ID principal
• Países do Publisher
• Estado
• ID de Multimédia de Imagem Quadrada
• ID do Suporte de Dados do Logótipo Quadrado
• Text
• Modelo de Controlo

Grupo de Anúncios

O nome do grupo de anúncios que contém o anúncio.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Nome da Empresa

O nome da empresa.

Consoante a colocação do seu público-alvo, o nome da sua empresa pode aparecer no seu anúncio.

O comprimento da cadeia está limitado a 25 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

Chamada à Ação

Uma breve razão para os clientes clicarem no seu anúncio neste momento.

Os valores possíveis são AddToCart, ApplyNow, BookNow, BookTravel, Buy, BuyNow, ContactUs, Download, GetQuote, Install, LearnMore, NoButton, OpenLink, OrderNow, RegisterNow, SeeMore, ShopNow, SignUp, Subscribe e VisitSite.

Adicionar: Não aplicável para anúncios de audiência.
Atualização: Só de leitura
Eliminar: Só de leitura

Chamada à Ação Langauge

O idioma em que a chamada à ação será servida.

A chamada à ação será sempre servida neste idioma, independentemente das definições de idioma da campanha.

Adicionar: Não aplicável para anúncios de audiência; Necessário para anúncios multimédia.
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

Campanha

O nome da campanha que contém o grupo de anúncios e o anúncio.

Adicionar: Só de leitura
Atualização: Só de leitura
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 primeiros oito pares de chave e valor personalizados que incluir 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 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

Descrições

Consoante a colocação do seu anúncio de audiência, este texto será apresentado abaixo ou adjacente ao título longo ou curto do seu anúncio.

Tem mais espaço de carateres para trabalhar no texto do anúncio do que no cabeçalho. Assim que as imagens e o cabeçalho tiverem a atenção de um potencial cliente, o texto do anúncio tem de convencê-lo a clicar no mesmo. O que distingue o seu produto ou serviço?

O texto tem de conter, pelo menos, uma palavra.

O limite superior de descrições é 5. O comprimento da cadeia está limitado a 90 carateres. O formato de dados dos títulos está incluído no JSON de exemplo abaixo.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Adicionar: Necessário para anúncios de audiência e anúncios multimédia. Não aplicável a anúncios de vídeo. 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

Estatuto de Recurso Editorial

Determina se pode recorrer das questões encontradas pela revisão editorial.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Apelativo	A questão editorial é apelativa.
Recurso Pendente	A questão editorial é recorrida e foi apresentado um recurso.
Não Aplicável	A questão editorial não é apelativa.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Localização Editorial

O componente ou propriedade do 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 do anúncio.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O anúncio passou na revisão editorial.
ActiveLimited	O anúncio passou na revisão editorial em um ou mais mercados, e um ou mais elementos do anúncio estão a ser revistos editorialmente noutro mercado. Por exemplo, o anúncio passou na revisão editorial para o Canadá e ainda está pendente de revisão nos Estados Unidos.
Reprovado	O anúncio falhou na revisão editorial.
Inativo	Um ou mais elementos do anúncio estão a ser analisados editorialmente.

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

Final Url

O URL da página de destino.

A parte do domínio do URL em combinação com as cadeias de caminho 1 e caminho 2 não pode exceder os 67 carateres.

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 para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 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}".

• Cada URL tem de ser um URL bem formado, começando com http:// ou https://.

• Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Tenha também em atenção que, se os campos Modelo de Controlo ou Parâmetro Personalizado estiverem definidos, é necessário, pelo menos, um URL Final.

Nota

Este URL é utilizado apenas se a palavra-chave não especificar um 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.

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
k

Cabeçalho

Este é um dos dois títulos possíveis que podem aparecer nos seus anúncios de vídeo.

Uma vez que os anúncios de vídeo são reativos, precisamos de vários títulos para que possam servir de forma flexível em vários editores e posicionamentos.

O comprimento da cadeia está limitado a 30 carateres.

Adicionar: Necessário para anúncios de vídeo. Não aplicável a anúncios multimédia e anúncios de audiência. Atualização: Opcional. Preterido para anúncios multimédia e audiência. Em alternativa, utilize Cabeçalhos.
Eliminar: Só de leitura

Cabeçalhos

Uma vez que os anúncios de audiência são reativos, precisamos de vários títulos para que possam servir de forma flexível em vários editores e posicionamentos.

O limite superior das manchetes é 15. E o comprimento de cada título está limitado a 30 carateres. O formato de dados dos títulos está incluído no JSON de exemplo abaixo.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Adicionar: Necessário para anúncios multimédia e anúncios de audiência. Não aplicável a anúncios de vídeo. 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 do anúncio.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para o anúncio pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como Etiqueta de Anúncio Reativo. Isto é recomendado se estiver a adicionar novos 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

Uma vez que os anúncios de audiência são reativos, pode criar múltiplos recursos de imagem com tamanhos e proporções diferentes para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

Nota

A partir de agora, SubType OriginalImage substitui a função landscapeImageMedia como a imagem predefinida para ResponsiveAd of Audience Campaign.

Só tem de fornecer um recurso OriginalImage, ou seja, este campo tem de conter um elemento de imagem com o subtipo definido como OriginalImage. As dimensões recomendadas para OriginalImage têm uma largura de 1200 x 628 alturas. 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 definiu explicitamente, o Microsoft Advertising criará automaticamente ligações de recursos de imagem ao recortar o OriginalImage.

Nota

Se este campo estiver definido (não vazio), o ID do Suporte de Dados da Imagem Horizontal e o ID do Suporte de Dados da Imagem Quadrada são ignorados.

Os recursos de imagem são representados no ficheiro em massa como uma cadeia JSON. Estão incluídas nove imagens no exemplo JSON abaixo e apenas a Imagem Original subType não é recortada. 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": "OriginalImage"
},
{
	"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"":""OriginalImage"""},{"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 OriginalImage, todos os recursos de imagem são recortados, exceto a imagem associada originalImage.
• Quer a OriginalImage tenha ou não as suas próprias definições de recorte, o Microsoft Advertising utiliza a altura verdadeira da imagem associada originalImage 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 o sub-tipo OriginalImage (OriginalImage) com proporção de 1,91:1 tem largura e altura de 1200x628. Mesmo que a ligação do recurso OriginalImage 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 OriginalImage (mais uma vez, seria 1200x628 neste exemplo).
• Embora na versão 12 da API de Anúncios do Bing possa utilizar o ID de Multimédia de Imagem Horizontal e o ID de Multimédia da Imagem Quadrada, estes campos são preteridos e serão removidos numa versão futura. Tem mais flexibilidade e controlo sobre as imagens recortadas através do campo Imagens .

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 anúncios reativos 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 OriginalImage, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 e ImageMedia153X100. Poderão ser adicionados novos subtipos no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

Subtipo	Proporção	Dimensões mínimas em píxeis
OriginalImage	N/D	703 largura x 368 alturas
LandscapeImageMedia	1.91:1	300 largura x 157 alturas
SquareImageMedia	1:1	114 largura x 114 alturas
ImagemMedia4x1	4:1	608 largura x 152 alturas
ImageMedia1x2	1:2	470 largura x 940 altura
ImageMedia201X100	2.01:1	612 largura x 304 altura
ImageMedia120X100	1.2:1	300 largura x 250 alturas
ImageMedia200X100	2:1	200 larguras x 100 alturas
ImagemMedia169X100	1.69:1	628 largura x 372 alturas
ImagemMedia124X100	1.24:1	104 largura x 84 alturas
ImagemMedia153X100	1.53:1	306 largura x 200 alturas

Adicionar: Necessário se o ID do Suporte de Dados da Imagem Horizontal estiver vazio. 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

Urls de Controlo de Impressões

Os URLs dos pixéis de controlo de impressões 1x1. Cada pixel irá comunicar impressões da Rede de Audiências da Microsoft à sua ferramenta de relatórios de anúncios de terceiros.

Pode incluir até 2 URLs de controlo de impressões para cada anúncio reativo. Cada URL é delimitado por um ponto e vírgula e espaço ("; ").

Cada URL tem de estar acessível. O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

Para cada impressão da Rede de Audiências da Microsoft, a Microsoft enviará pings para o URL para ativar o controlo de impressões na sua ferramenta de relatórios de anúncios de terceiros. O controlo de utilizadores de nível avançado, como o controlo ou o controlo de conversão com base em cookies ou endereços IP, não é suportado.

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 de Multimédia de Imagem Horizontal

O identificador do recurso de imagem utilizado para imagens paisagísticas com uma proporção de 1,91:1 que pode aparecer nos anúncios da sua audiência.

A proporção do suporte de dados de imagem armazenado pode variar, desde que as definições de recorte de recursos de imagem resultem na proporção suportada para este campo. Para confirmar a proporção efetiva com as definições de recorte, utilize o campo Imagens .

Nota

Embora na versão 12 da API de Anúncios do Bing possa utilizar o Landscape Image Media Id e o SquareImageMediaId, estes campos são preteridos e serão removidos numa versão futura. Tem mais flexibilidade e controlo sobre as imagens recortadas através do campo Imagens .

Adicionar: Necessário se a opção Imagens não estiver definida. Se a opção Imagens estiver definida, este campo é ignorado.
Atualização: Opcional. Se a opção Imagens estiver definida, este campo é ignorado. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID do Suporte de Dados do Logótipo horizontal

Este campo está reservado para utilização interna e será removido de uma versão futura da API de Anúncios do Bing.

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

Cabeçalho Longo

Esta é uma das duas manchetes possíveis que podem aparecer nos anúncios da sua audiência.

Uma vez que os anúncios de audiência são reativos, precisamos de vários títulos para que possam servir de forma flexível em vários editores e posicionamentos.

O comprimento da cadeia está limitado a 90 carateres.

Adicionar: Necessário
Atualização: Preterido. Em alternativa, utilize Cabeçalhos Longos.
Eliminar: Só de leitura

Cabeçalhos Longos

Uma vez que os anúncios de audiência são reativos, precisamos de vários títulos para que possam servir de forma flexível em vários editores e posicionamentos.

O limite superior das manchetes longas é 5. E o comprimento de cada título está limitado a 90 carateres. O formato de dados de títulos longos está incluído no JSON de exemplo abaixo.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Adicionar: Necessário para anúncios multimédia e anúncios de audiência. Não aplicável a anúncios de vídeo. 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

Cadeia de Cabeçalho Longo

Os títulos são o texto mais proeminente que aparece no seu anúncio, pelo que deve tirar o máximo partido dos carateres disponíveis. Uma vez que os anúncios de audiência são reativos, precisamos de vários títulos para que possam servir de forma flexível em vários editores e posicionamentos.

O comprimento de cada título está limitado a 90 carateres. O formato de dados de títulos longos está incluído no JSON de exemplo abaixo.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Adicionar: Necessário para anúncios de audiência e anúncios de vídeo. Não aplicável a anúncios multimédia. 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 móvel.

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 para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 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}".

• Cada URL tem de ser um URL bem formado, começando com http:// ou https://.

• Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Nota

Este URL só é utilizado se a palavra-chave não especificar um Url Final móvel.

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 do grupo de anúncios que contém o anúncio.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novos anúncios a um novo grupo de anúncios 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
Eliminar: Só de leitura

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

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

Estado

O estado do anúncio.

Os valores possíveis são Ativo, Em Pausa ou Eliminado.

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: Necessário. O Estado tem de ser definido como Eliminado.

ID de Multimédia de Imagem Quadrada

O identificador do elemento de imagem utilizado para imagens quadradas com proporção de 1:1 que pode aparecer nos anúncios da sua audiência.

A proporção do suporte de dados de imagem armazenado pode variar, desde que as definições de recorte de recursos de imagem resultem na proporção suportada para este campo. Para confirmar a proporção efetiva com as definições de recorte, utilize o campo Imagens .

Nota

Embora na versão 12 da API de Anúncios do Bing possa utilizar o Landscape Image Media Id e o SquareImageMediaId, estes campos são preteridos e serão removidos numa versão futura. Tem mais flexibilidade e controlo sobre as imagens recortadas através do campo Imagens .

Adicionar: Opcional. Se a opção Imagens estiver definida, este campo será ignorado e o Microsoft Advertising criará automaticamente um novo recurso de imagem quadrada ao recortar o recurso de imagem LandscapeImageMedia. Se a opção Imagens não estiver definida e se não definir este campo, o Microsoft Advertising criará automaticamente um novo recurso de imagem quadrada ao recortar o ID de Multimédia de Imagem Horizontal.
Atualização: Opcional. Se a opção Imagens estiver definida, este campo será ignorado e o Microsoft Advertising criará automaticamente um novo recurso de imagem quadrada ao recortar o recurso de imagem LandscapeImageMedia. Se a opção Imagens não estiver definida e se não definir este campo, o Microsoft Advertising criará automaticamente um novo recurso de imagem quadrada ao recortar o ID de Multimédia de Imagem Horizontal. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID do Suporte de Dados do Logótipo Quadrado

Este campo está reservado para utilização interna e será removido de uma versão futura da API de Anúncios do Bing.

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

Text

Consoante a colocação do seu anúncio de vídeo, este texto será apresentado abaixo ou adjacente ao título longo ou curto do seu anúncio.

Tem mais espaço de carateres para trabalhar no texto do anúncio do que no cabeçalho. Assim que as imagens e o cabeçalho tiverem a atenção de um potencial cliente, o texto do anúncio tem de convencê-lo a clicar no mesmo. O que distingue o seu produto ou serviço?

O texto tem de conter, pelo menos, uma palavra.

O comprimento da cadeia está limitado a 90 carateres.

O texto não pode conter o caráter newline (\n).

Adicionar: Necessário para anúncios de vídeo. Não aplicável a anúncios de audiência ou anúncios multimédia. Atualização: Opcional para anúncios de vídeo. Em vez disso, utilize Descrições para anúncios de audiência ou anúncios multimédia (preteridos).
Eliminar: Só de leitura

Modelo de Controlo

O modelo de controlo a utilizar como predefinição para o URL especificado com FinalUrls.

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