Objet de données AdExtension - Gestion des campagnes

Article
11/13/2024

Définit l’objet de base d’une extension d’annonce.

N’essayez pas d’instancier une adExtension. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

Syntaxe

<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element xmlns:q43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q43:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet AdExtension a les éléments suivants : DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version.

Élément	Description	Type de données
DevicePreference	Cet élément détermine si la préférence est que l’extension d’annonce s’affiche sur les appareils mobiles ou sur tous les appareils. Pour spécifier une préférence pour les appareils mobiles, définissez cet élément sur 30001. Pour spécifier tous les appareils, définissez cet élément sur 0 (zéro) ou laissez l’élément zéro. Par défaut, cet élément est nul. Cet élément s’applique uniquement aux types AppAdExtension et SitelinkAdExtension .	Long
ForwardCompatibilityMap	Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API. Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.	Tableau KeyValuePairOfstringstring
ID	Identificateur Microsoft Advertising unique de l’extension de publicité.	Long
Planification	Détermine le jour calendaire et les intervalles de temps où l’extension d’annonce peut être affichée dans des annonces.	Schedule
État	État de l’extension d’annonce. La valeur sera toujours Active , car le service Campaign Management ne retourne pas d’extensions publicitaires supprimées.	AdExtensionStatus
Type	Type d’extension d’annonce. Pour plus d’informations, consultez Remarques.	chaîne
Version	Effectue le suivi du nombre de mises à jour de l’extension d’annonce. La version est définie sur 1 lors de la création de l’extension d’annonce et incrémente d’un après chaque mise à jour.	int

Remarques

Si vous générez manuellement le soap, utilisez l’attribut type du <AdExtension> nœud comme indiqué dans l’exemple suivant pour spécifier le type d’extension d’annonce.

<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</AdExtension>

Configuration requise

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

Utilisé par

AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions

Partager via