Objet de données CalloutAdExtension - Gestion des campagnes

Article
11/14/2024

Définit un objet qui spécifie du texte supplémentaire sur votre entreprise, vos produits ou services à inclure dans une annonce textuelle.

Vous pouvez associer une extension de publicité d’application au compte ou à des campagnes et des groupes d’annonces dans le compte. Vous devez associer entre 2 et 20 extensions de légende par entité (compte, campagne ou groupe d’annonces). Si vous associez une ou plusieurs extensions de légende à votre compte, campagne ou groupe d’annonces, aucun texte de légende ne sera affiché avec votre annonce. Une annonce peut inclure entre 2 et 4 légendes par impression.

Les extensions publicitaires associées au niveau du groupe d’annonces remplacent les extensions publicitaires du même type que celles associées au niveau de la campagne. Par exemple, si vous avez 2 extensions de légende définies pour la campagne A, aucune extension de légende associée au groupe d’annonces AA et une extension de légende associée à Ad Group AB, seul le groupe d’annonces AA est éligible pour que ses annonces textuelles soient décorées avec des légendes.

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

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "CalloutAdExtension",
  "Version": IntValueHere,
  "Text": "ValueHere"
}

Éléments

L’objet CalloutAdExtension contient les éléments suivants : Text.

Élément	Description	Type de données
Texte	Texte de légende supplémentaire sur votre entreprise, produits ou services à inclure dans une annonce textuelle. Le texte de l’extension de légende doit être différent du texte de votre annonce. La longueur de cette chaîne doit être comprise entre 1 et 25 caractères. Notez que pour les caractères chinois traditionnels, la longueur de cette chaîne doit être comprise entre 1 et 12 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne

L’objet CalloutAdExtension possède des éléments hérités.

Éléments hérités

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

L’objet CalloutAdExtension 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 à CalloutAdExtension 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 CalloutAdExtension lorsque vous récupérez une extension d’annonce de légende. 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
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Partager via