Partilhar via

Objeto de Dados ResponsiveAd - Gestão de Campanhas

  • Artigo

Um formato de anúncio reativo para anúncios de audiência e anúncios multimédia.

O objeto ResponsiveAd é utilizado para anúncios multimédia na rede de pesquisa e anúncios de Audiência na Rede de Audiências da Microsoft. Veja a secção observações abaixo para obter detalhes sobre os principais diferenciadores.

Nota

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

Sintaxe

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto ResponsiveAd tem os seguintes elementos: AdSubType, BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.

Elemento Descrição Tipo de Dados
AdSubType Os possíveis subtipos de anúncios. AdSubType
Nome da Empresa O nome da empresa.

O nome da sua empresa pode aparecer no seu anúncio, consoante o posicionamento do 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.		 cadeia
CallToAction Uma breve razão para os clientes clicarem no seu anúncio neste momento.

Esta opção é apresentada no botão de chamada à ação.

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.		 CallToAction
CallToActionLanguage 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.		 LanguageName
Descrições As descrições apresentadas abaixo do caminho no seu anúncio. Para maximizar as impressões em todos os formatos de anúncios, as descrições podem nem sempre ser apresentadas no seu anúncio.

Para maximizar as impressões em todos os formatos de anúncios, as descrições podem nem sempre ser apresentadas no seu anúncio.

A menos que afixe uma das descrições a uma posição específica, o Bing otimizará dinamicamente o esquema de anúncios com as melhores manchetes e descrições para a consulta de pesquisa do utilizador.

Numa perspetiva de modelo de dados, as desriptações e os títulos são armazenados como recursos de texto, ou seja, um TextAsset por AssetLink. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 1 a 5 descrições. O Texto de cada descrição tem de conter, pelo menos, uma palavra. Para uma utilização eficiente dos recursos, recomendamos que utilize cadeias de texto dinâmicas, como {keyword} em vez de criar uma nova cópia de anúncios para cada palavra-chave. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

O comprimento máximo de entrada do Texto de cada descrição é de 1000 carateres, incluindo cadeias de texto dinâmicas, e desses 1000 não são permitidos mais de 90 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 90 carateres após a substituição de texto dinâmico ocorrer. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 500 carateres, incluindo cadeias de texto dinâmicas, e desses 500 não são permitidos mais de 45 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 45 carateres após a substituição de texto dinâmico ocorrer. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

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

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. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir este elemento, todas as descrições anteriormente ligadas a este anúncio serão substituídas.		 Matriz AssetLink
Cabeçalho 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. Precisamos de vários cabeçalhos para que o anúncio possa ser apresentado 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.		 cadeia
Cabeçalhos 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. Precisamos de vários cabeçalhos para que o anúncio possa ser apresentado de forma flexível em vários editores e posicionamentos.

A menos que afixe um dos cabeçalhos a uma posição específica, o Bing otimizará dinamicamente o esquema de anúncios com as melhores manchetes e descrições para a consulta de pesquisa do utilizador.

Numa perspetiva de modelo de dados, as desriptações e os títulos são armazenados como recursos de texto, ou seja, um TextAsset por AssetLink. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 1 a 15 cabeçalhos. O Texto de cada cabeçalho tem de conter, pelo menos, uma palavra. Para uma utilização eficiente dos recursos, recomendamos que utilize cadeias de texto dinâmicas, como {keyword} em vez de criar uma nova cópia de anúncios para cada palavra-chave. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

O comprimento máximo de entrada do Texto de cada título é de 1000 carateres, incluindo cadeias de texto dinâmicas, e desses 1000 não são permitidos mais de 30 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 30 carateres após a substituição de texto dinâmico ocorrer.

Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 500 carateres, incluindo cadeias de texto dinâmicas, e desses 500 não são permitidos mais de 15 carateres finais após a substituição. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder 15 carateres após a substituição de texto dinâmico ocorrer. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

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

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. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir este elemento, quaisquer títulos que tenham sido anteriormente ligados a este anúncio serão substituídos.		 Matriz AssetLink
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.

Inclua um ou mais objetos AssetLink que contêm cada um um ImageAsset com o Subtipo e as definições de recorte que correspondem à proporção pretendida. Para obter mais informações, veja as observações abaixo.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se incluir imagens durante a atualização, todas as imagens definidas anteriormente serão substituídas.		 Matriz AssetLink
ImpressionTrackingUrls 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 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.

Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor ImpressionTrackingUrls no elemento ReturnAdditionalFields quando chama as operações do serviço GetAdsByAdGroupId, GetAdsByEditorialStatus e GetAdsByIds .

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 URLs de controlo de impressões, defina este elemento como uma matriz de cadeia vazia.		 matriz de cadeia
LongHeadline Para campanhas de Audiência, LongHeadline é o maior de dois títulos de anúncios reativos possíveis. AssetLink
LongHeadlines Tem de definir entre 1 a 5 títulos longos. O Texto de cada cabeçalho tem de conter, pelo menos, uma palavra. O Texto não pode conter o caráter newline (\n).

Se a campanha principal associar a uma loja e especificar LongHeadlines, também tem de especificar Manchetes, Descrições e Imagens.

Adicionar: opcional se a campanha principal associar a uma loja, necessário se a campanha principal não se associar a uma loja. Utilizará LongHeadlineString se estiver vazio.
Atualização: opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este elemento nulo. Se definir um valor para este elemento, quaisquer títulos que tenham sido anteriormente ligados a este grupo de recursos serão substituídos. Se a campanha principal associar a uma loja e definir este elemento para uma lista vazia, a definição anterior será eliminada.		 Matriz AssetLink
LongHeadlineString 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. Precisamos de vários cabeçalhos para que o anúncio possa ser apresentado de forma flexível em vários editores e posicionamentos.

O comprimento da cadeia está limitado a 90 carateres.

Adicionar: Opcional. Ignorado quando são fornecidos LongHeadlines . Iremos preencher LongHeadlines com LongHeadlineString se LongHeadlines estiver vazio. 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.		 cadeia
Text Este texto será apresentado abaixo ou adjacente ao título longo ou curto do seu anúncio, consoante o posicionamento do 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 multimédia e anúncios de audiência.
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).		 cadeia
VerifiedTrackingSettings VerifiedTrackingSetting relaciona as definições de medição de terceiros. Isto permite-lhe controlar a visualizabilidade, a segurança da marca e as métricas de tráfego inválidas através de um fornecedor de verificação de terceiros, como a Integral Ad Science. Esta funcionalidade está disponível para anúncios de vídeo nativos, de apresentação e online com a estratégia de oferta do CPM.

Nota: atualmente, a IAS é o único fornecedor suportado (vendorName), mas outros fornecedores de verificação estão disponíveis em breve. O exemplo abaixo diz respeito a IAS.

Existem três pares chave-valor para IAS:
  • "vendorName"
  • "advertiserEntityID" (ID de cliente do fornecedor de verificação)
  • "publisherEntityID" (ID de relatório do seu fornecedor de verificação)
Exemplo (necessário para IAS):
  • vendorName: "IAS"
  • advertiserEntityID: "12345678"
  • publisherEntityID: "12345678"
 VerifiedTrackingSetting
Vídeos Recursos de vídeo com diferentes tamanhos e proporções para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

Inclua um ou mais objetos AssetLink que contêm um VideoAsset com um Subtipo.

Adicionar: Necessário para 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. Se incluir vídeos durante uma atualização, todos os vídeos anteriormente definidos serão substituídos.		 Matriz AssetLink

O objeto ResponsiveAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto ResponsiveAd deriva do objeto Ad e herda os seguintes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. As descrições abaixo são específicas do ResponsiveAd e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Ad .

Elemento Descrição Tipo de Dados
AdFormatPreference Não suportado para este tipo de anúncio. cadeia
DevicePreference Não suportado para este tipo de anúncio. Longo
EditorialStatus O estado de revisão editorial do anúncio, que indica se o anúncio está pendente de revisão, foi aprovado ou foi desaprovado.

Adicionar: Só de leitura
Atualização: Só de leitura		 AdEditorialStatus
FinalAppUrls Não suportado para este tipo de anúncio. Matriz appUrl
FinalMobileUrls 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 FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
- 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 FinalMobileUrls, também tem de especificar FinalUrls.
- Não pode especificar FinalMobileUrls se a preferência do dispositivo estiver definida como móvel.

Este URL só é utilizado se a palavra-chave não especificar um URL móvel 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 elemento para uma lista vazia, a definição anterior será eliminada.		 matriz de cadeia
FinalUrls 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 FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
- 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 FinalMobileUrls, também tem de especificar FinalUrls.
- Não pode especificar FinalMobileUrls se a preferência do dispositivo estiver definida como móvel. Tenha também em atenção que, se o elemento TrackingUrlTemplate ou UrlCustomParameters deste anúncio estiver definido, é necessário, pelo menos, um URL final.

Este URL é utilizado apenas se a palavra-chave não especificar um URL final.

Adicionar: Necessário
Atualização: Opcional		 matriz de cadeia
FinalUrlSuffix 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 elemento como uma cadeia vazia ("", a definição anterior será eliminada.		 cadeia
ForwardCompatibilityMap A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API.

As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.		 Matriz KeyValuePairOfstringstring
ID O identificador exclusivo do Microsoft Advertising do anúncio.

Adicionar: Só de leitura
Atualização: Necessário e Read-Only		 Longo
Estado O estado do anúncio.

Pode definir o estado do anúncio como Ativo ou Em Pausa.

Adicionar: Opcional
Atualização: Opcional		 AdStatus
TrackingUrlTemplate O modelo de controlo a utilizar como predefinição para todos os URLs de página de destino.

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?
- 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 elemento como uma cadeia vazia ("", a definição anterior será eliminada.		 cadeia
Tipo O tipo do anúncio. Este valor é ResponsiveAd quando obtém um anúncio reativo. Para obter mais informações sobre tipos de anúncios, veja Ad Data Object Remarks (Comentários de Objetos de Dados do Ad).

Adicionar: Só de leitura
Atualização: Só de leitura		 AdType
UrlCustomParameters A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

O Microsoft Advertising aceitará os primeiros 8 objetos CustomParameter que incluir no objeto CustomParameters e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada CustomParameter inclui elementos Chave e Valor .

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina o elemento UrlCustomParameters como nulo ou vazio para manter quaisquer parâmetros personalizados existentes. Para remover todos os parâmetros personalizados, defina o elemento Parâmetros do objeto CustomParameters como nulo ou vazio. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter no elemento Parâmetros do objeto CustomParameters .		 CustomParameters

Observações

O objeto ResponsiveAd é utilizado para anúncios multimédia na rede de pesquisa e anúncios de Audiência na Rede de Audiências da Microsoft.

A maioria das propriedades suportadas são as mesmas, mas aqui estão alguns dos principais diferenciadores.

Nota

Os dados para Imagens são aprovisionados através da operação AddMedia . Pode utilizar os tipos DE MIME GIF, JPEG ou PNG. As imagens com animação não são suportadas. Embora só possa adicionar suportes de dados com algumas proporções através da operação AddMedia , pode utilizar as definições de recorte ImageAsset para determinar a relação de aspeto eficaz no contexto de cada ad AssetLink reativo. A proporção da imagem armazenada seria inalterada na biblioteca de multimédia ao nível da conta.

O tamanho máximo do ficheiro é de 5 MB. A largura e altura máximas em píxeis são 2592 e 2048 de forma independente e tem de manter uma das proporções suportadas. Por exemplo, se o recurso de imagem com o subtipo LandscapeImageMedia tiver 2592 de largura, a altura tem de ser 1357.

Imagens de anúncios multimédia

Para anúncios multimédia, irá criar vários recursos de imagem com diferentes tamanhos e proporções. Tem de adicionar, pelo menos, uma imagem com uma proporção de 1,91:1 e uma imagem com proporção de 1:1.

No elemento Imagens , inclua um ou mais objetos AssetLink . Cada ligação de recurso contém um ImageAsset com SubType definido para um dos valores de cadeia na tabela abaixo.

Subtipo Proporção Dimensões mínimas em píxeis
LandscapeImageMedia 1.91:1 703 largura x 368 alturas
ImagemMedia4x1 4:1 608 largura x 152 alturas
SquareImageMedia 1:1 470 largura x 470 altura
ImageMedia1x2 1:2 470 largura x 940 altura

Logótipos de anúncios multimédia

Para anúncios multimédia, irá criar vários recursos de logótipo com diferentes tamanhos, proporções e definições de recorte para que possam ser apresentados de forma flexível na lista de miniaturas.

O subtipo tem de ser definido como "Logótipo" se a imagem estiver associada a um anúncio como "LandscapeLogoMedia" ou "SquareLogoMedia".

Subtipo Proporção Dimensões mínimas em píxeis
LandscapeLogoMedia 4:1 512 largura x 128 alturas
SquareLogoMedia 1:1 128 largura x 128 alturas

Imagens de anúncios da audiência

Para anúncios de audiência, irá criar vários recursos de imagem com diferentes tamanhos, proporções e definições de recorte para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

No elemento Imagens , inclua um ou mais objetos AssetLink . Cada ligação de recurso contém um ImageAsset com SubType definido para um dos valores de cadeia na tabela abaixo.

Nota

Os subtipos de imagem e na tabela abaixo para Anúncios de audiência versão 2 e estão atualmente em piloto.

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

Nota

Os subtipos de imagem na tabela abaixo destinam-se a Anúncios de audiência versão 1.

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

Só é necessário fornecer um recurso de imagem OriginalImage predefinido (a imagem predefinida era LandscapeImageMedia anteriormente). No elemento Imagens , inclua um AssetLink que contém um ImageAsset com SubType 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.

Tendo em conta o exemplo de resposta GetAdsByAdGroupId abaixo, 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.
  • O Microsoft Advertising utilizará as definições de recorte da 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. As definições de recorte dos recursos de imagem gerados automaticamente baseiam-se nas definições de recorte da ligação do recurso OriginalImage.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13