Objet de données StructuredSnippetAdExtension - Gestion des campagnes

Article
12/21/2023

Définit un objet qui associe un en-tête avec entre 3 et 10 valeurs d’extraits de code qui permettent aux clients d’en savoir plus sur votre entreprise.

Dans l’exemple suivant, Courses est l’en-tête, et .NET, Java, Python et PHP sont des exemples de valeurs individuelles.

Cours : .NET, Java, Python, PHP

Vous pouvez associer une extension publicitaire d’extrait de code structuré au compte ou à des campagnes et des groupes d’annonces dans le compte. Chaque entité (compte, campagne ou groupe d’annonces) peut être associée à jusqu’à 20 extensions publicitaires d’extraits de code structurés. Une annonce de texte développée n’inclut qu’un extrait de code structuré (un titre avec 3 à 10 valeurs) par impression.

Syntaxe

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q53="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q53:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet StructuredSnippetAdExtension contient les éléments suivants : Header, Values.

Élément	Description	Type de données
En-tête	En-tête ajouté avec un signe deux-points ( :) et précède les valeurs de l’extrait de code. Les en-têtes d’extraits de code structurés doivent être spécifiés dans le même langage que celui que vous souhaitez afficher. Par exemple, si vous souhaitez l’en-tête Commodités en anglais, vous devez spécifier l’en-tête Commodités. Si vous souhaitez l’en-tête Ausstattung en allemand, vous devez spécifier l’en-tête Ausstattung (Commodités en allemand). Pour obtenir la liste des en-têtes pris en charge par langue, consultez Langages d’en-tête d’extension d’annonce. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
Valeurs	Valeurs d’extrait de code qui suivent le composant En-tête de l’annonce affichée. Chaque valeur de texte que vous choisissez peut avoir une longueur maximale de 25 caractères. Notez que pour les caractères chinois traditionnels, chaque valeur peut avoir une longueur maximale de 12 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	tableau de chaînes

L’objet StructuredSnippetAdExtension a des éléments hérités.

Éléments hérités

Éléments hérités d’AdExtension

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

Élément	Description	Type de données
DevicePreference	Non pris en charge pour ce type d’extension d’annonce.	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. Il n’existe actuellement aucune modification de compatibilité avant pour l’objet AdExtension . Ajouter: En lecture seule Mettre à jour: En lecture seule	Tableau KeyValuePairOfstringstring
ID	Identificateur Microsoft Advertising unique de l’extension de publicité. Ajouter: En lecture seule Mettre à jour: Lecture seule et Obligatoire	Long
Planification	Détermine le jour calendaire et les intervalles de temps où l’extension d’annonce peut être affichée dans des annonces. Ajouter: Optionnel Mettre à jour: Optionnel. Si vous définissez cet élément null, tout jeu de planification existant pour l’extension d’annonce reste inchangé. Si vous définissez ce paramètre sur n’importe quel objet Schedule non null, vous remplacez efficacement les paramètres de planification existants pour l’extension d’annonce. Pour supprimer toutes les planifications, définissez cet élément sur un objet Schedule vide.	Schedule
Statut	Status de l’extension d’annonce. La valeur sera toujours Active , car le service Campaign Management ne retourne pas d’extensions publicitaires supprimées. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdExtensionStatus
Type	Type de l’extension d’annonce. Cette valeur est StructuredSnippetAdExtension lorsque vous récupérez une extension d’annonce d’extrait de code structuré. Ajouter: En lecture seule Mettre à jour: En lecture seule Pour plus d’informations sur les types d’extensions publicitaires, consultez les remarques relatives aux objets de données d’extension d’annonce.	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. Ajouter: Non autorisé Mettre à jour: Non autorisé	int

Configuration requise

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

Partager via