Objet de données d’image - Gestion des campagnes

Article
12/21/2023

Définit une image qui peut être ajoutée à la bibliothèque multimédia d’un compte.

Syntaxe

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

Éléments

L’objet Image contient les éléments suivants : Data.

Élément	Description	Type de données
Données	Chaîne base64 qui représente l’image ou l’icône à ajouter à la bibliothèque. La chaîne base64 peut contenir un maximum de 102 400 caractères. Pour plus d’informations sur les restrictions et les types de données pris en charge, consultez les remarques ci-dessous.	chaîne

L’objet Image contient des éléments hérités.

Éléments hérités

Éléments hérités du média

L’objet Image dérive de l’objet Media et hérite des éléments suivants : Id, MediaType, Type. Les descriptions ci-dessous sont spécifiques à Image et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Media .

Élément	Description	Type de données
ID	Identificateur Microsoft Advertising unique du média. Ajouter: En lecture seule	Long
MediaType	Type de média à ajouter à la bibliothèque. Le type de média recommandé est « GenericImage ». Pour les médias qui seront utilisés avec une ImageAdExtension, les valeurs prises en charge sont GenericImage, Image16x9, Image15x10, Image4x3 et Image12x10. Pour les médias qui seront utilisés avec un ResponsiveAd, les valeurs prises en charge sont GenericImage, Image1x1, Image191x100 et Image4x1. Pour plus d’informations sur les proportions prises en charge, consultez la section Remarques ci-dessous. Ajouter: Obligatoire	chaîne
Type	Type de média. Pour plus d’informations sur les types de médias, consultez remarques sur les objets de données multimédias. Ajouter: En lecture seule	chaîne

Remarques

Le type de média d’image indique les proportions prises en charge de l’image chargée.

Nous vous recommandons la « GenericImage » avec des dimensions de 703 largeur x 368 hauteur ou plus, en pixels.

Toutes les valeurs de sous-type prises en charge avec des restrictions de dimension et de proportion correspondantes sont décrites ci-dessous.

Sous-type	Proportions	Dimension minimale
GenericImage	Variables	40 largeur x 20 hauteur, en pixels
Image16x9	16:9	640 largeur x 360 hauteur, en pixels
Image15x10	1.5:1	300 largeur x 200 hauteur, en pixels
Image4x3	4:3	100 largeur x 75 hauteur, en pixels
Image1x1	1:1	128 largeur x 128 hauteur, en pixels
Image191x100	1.91:1	703 largeur x 368 hauteur, en pixels
Image4x1	4:1	512 largeur x 128 hauteur, en pixels

Remarque

La largeur et la hauteur maximales en pixels sont de 2592 et 2048 indépendamment, et vous devez toujours conserver l’un des proportions prises en charge. Par exemple, si le sous-type est Image191x100 et que la largeur est 2592, la hauteur doit être 1357.

Les images avec animation ne sont pas prises en charge. Les types MIME suivants sont pris en charge.

GIF
JPEG
PNG

Conseil

Les images PNG sont converties en JPEG. Si vous n’êtes pas satisfait de la qualité après la conversion, nous vous recommandons de fournir jpeg directement.

Configuration requise

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Partager via