Objeto de Dados de Imagem - Gestão de Campanhas

Artigo
11/13/2024

Define uma imagem que pode ser adicionada à biblioteca de multimédia de uma conta.

Sintaxe

XML
JSON

<xs:complexType name="Image" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Media">
      <xs:sequence>
        <xs:element minOccurs="0" name="Data" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "Id": "LongValueHere",
  "MediaType": "ValueHere",
  "Text": "ValueHere",
  "Type": "Image",
  "Data": "ValueHere"
}

Elementos

O objeto Imagem tem os seguintes elementos: Dados.

Elemento	Descrição	Tipo de Dados
Dados	Uma cadeia base64 que representa a imagem ou o ícone a adicionar à biblioteca. A cadeia base64 pode conter um máximo de 102 400 carateres. Para obter informações sobre restrições e tipos de dados suportados, veja Observações abaixo.	cadeia

O objeto Imagem tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Suporte de Dados

O objeto Imagem deriva do objeto Multimédia e herda os seguintes elementos: ID, MediaType, Texto, Tipo. As descrições abaixo são específicas de Imagem e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Multimédia .

Elemento	Descrição	Tipo de Dados
ID	O identificador exclusivo do Microsoft Advertising dos suportes de dados. Adicionar: Só de leitura	Longo
MediaType	O tipo de suporte de dados a adicionar à biblioteca. O tipo de suporte de dados recomendado é "GenericImage". Para suportes de dados que serão utilizados com uma ImageAdExtension, os valores suportados são GenericImage, Image16x9, Image15x10, Image4x3 e Image12x10. Para suportes de dados que serão utilizados com um ResponsiveAd, os valores suportados são GenericImage, Image1x1, Image191x100 e Image4x1. Para obter mais informações sobre as proporções suportadas, veja a secção Observações abaixo. Adicionar: Necessário	cadeia
Text	O texto alternativo da imagem.	cadeia
Tipo	O tipo de suporte de dados. Para obter mais informações sobre tipos de multimédia, veja Comentários sobre Objetos de Dados de Multimédia. Adicionar: Só de leitura	cadeia

Observações

O tipo de suporte de dados de imagem indica a proporção suportada da imagem carregada.

Recomendamos o "GenericImage" com dimensões de 703 largura x 368 de altura ou superior, em píxeis.

Todos os valores de subtipo suportados com restrições de dimensão e proporção correspondentes são descritos abaixo.

Subtipo	Proporção	Dimensão Mínima
GenericImage	Varia	40 largura x 20 alturas, em píxeis
Imagem16x9	16:9	640 largura x 360 altura, em píxeis
Imagem15x10	1.5:1	300 largura x 200 alturas, em píxeis
Imagem4x3	4:3	100 largura x 75 alturas, em píxeis
Imagem1x1	1:1	128 largura x 128 alturas, em píxeis
Imagem191x100	1.91:1	703 largura x 368 altura, em píxeis
Imagem4x1	4:1	512 largura x 128 alturas, em píxeis

Nota

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 subtipo for Image191x100 e a largura for 2592, a altura tem de ser 1357.

As imagens com animação não são suportadas. São suportados os seguintes tipos de MIME.

GIF
JPEG
PNG

Sugestão

As imagens PNG são convertidas em JPEG. Se não estiver satisfeito com a qualidade após a conversão, recomendamos que forneça o JPEG diretamente.

Requisitos

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

Utilizado Por

AdRecommendationImageSuggestion

Partilhar via