Objet de données ReviewAdExtension - Gestion des campagnes

Article
11/13/2024

Définit un objet qui spécifie des révisions tierces (exactes ou paraphrasées) sur votre entreprise, produits ou services à inclure dans une annonce de texte développée.

Vous pouvez associer une extension de révision d’annonce 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 d’annonces de révision. Une annonce de texte développée n’inclut qu’une seule révision par impression.

<xs:complexType name="ReviewAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExact" type="xs:boolean" />
        <xs:element minOccurs="0" name="Source" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Url" 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": "ReviewAdExtension",
  "Version": IntValueHere,
  "IsExact": "ValueHere",
  "Source": "ValueHere",
  "Text": "ValueHere",
  "Url": "ValueHere"
}

Éléments

L’objet ReviewAdExtension contient les éléments suivants : IsExact, Source, Text, Url.

Élément	Description	Type de données
IsExact	Détermine si le texte de révision est une citation exacte ou paraphrasée. Si elle n’est pas spécifiée, la valeur par défaut false indique que le texte de révision est paraphrasé à partir de la source. Si la valeur est true, le texte de révision est automatiquement entouré de guillemets lorsqu’il est affiché avec l’annonce. Ajouter: Optionnel Mettre à jour: Optionnel. Si vous définissez cet élément null, le paramètre précédent est supprimé.	boolean
Source	Nom de la source de révision. La longueur combinée des chaînes Source et Texte ne doit pas dépasser 67 caractères. Notez que pour les caractères chinois traditionnels, la longueur combinée des chaînes Source et Text Source et Text est limitée à 33 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
Texte	Texte qui est une paraphrase ou une citation exacte de la source de la révision. La longueur combinée des chaînes Source et Texte ne doit pas dépasser 67 caractères. Notez que pour les caractères chinois traditionnels, la longueur combinée des chaînes Source et Text Source et Text est limitée à 33 caractères. N’entourez pas le texte de guillemets. Si IsExact a la valeur True, le texte de révision est automatiquement entouré de guillemets lorsqu’il est affiché avec l’annonce. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
URL	URL de la source de révision. L’URL doit commencer par le préfixe http:// ou https:// . La longueur de cette chaîne est limitée à 2 048 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne

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

Éléments hérités

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

L’objet ReviewAdExtension 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 à ReviewAdExtension 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 ReviewAdExtension lorsque vous récupérez une extension d’annonce de révision. 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