Objet de données ProductAd - Gestion des campagnes

Article
11/13/2024

Définit une annonce de produit. Une annonce de produit n’est pas utilisée directement pour la copie de l’annonce remise. Au lieu de cela, le moteur de livraison génère des annonces de produits à partir des détails du produit qu’il trouve dans le magasin Microsoft Merchant Center du client.

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

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "Product",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "PromotionalText": "ValueHere"
}

Éléments

L’objet ProductAd contient les éléments suivants : PromotionalText.

Élément	Description	Type de données
PromotionalText	Cette propriété est réservée à un usage interne et sera supprimée d’une version ultérieure de l’API. Vous pouvez utiliser les promotions du marchand si vous souhaitez que les étiquettes apparaissent en bas de votre annonce de produit sous forme de liens « offres spéciales », ce qui contribue à augmenter l’engagement des clients. Ajouter: Optionnel Mettre à jour: Optionnel	chaîne

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

Éléments hérités

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

L’objet ProductAd dérive de l’objet Ad et hérite des éléments suivants : AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Les descriptions ci-dessous sont spécifiques à ProductAd et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Ad .

Élément	Description	Type de données
AdFormatPreference	Non pris en charge pour ce type d’annonce.	chaîne
DevicePreference	Non pris en charge pour ce type d’annonce.	long
EditorialStatus	La révision éditoriale status de l’annonce, qui indique si la publicité est en attente d’examen, a été approuvée ou a été désapprouvée. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdEditorialStatus
FinalAppUrls	Non pris en charge pour ce type d’annonce.	Tableau AppUrl
FinalMobileUrls	Non pris en charge pour ce type d’annonce.	tableau de chaînes
FinalUrls	Non pris en charge pour ce type d’annonce.	tableau de chaînes
FinalUrlSuffix	Non pris en charge pour ce type d’annonce.	chaîne
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 paire clé/valeur ForwardCompatibilityMap applicable aux annonces de produit.	Tableau KeyValuePairOfstringstring
Id	Identificateur Microsoft Advertising unique pour la publicité. Ajouter: En lecture seule Mettre à jour: Obligatoire et en lecture seule	long
Statut	Status de l’annonce. Vous pouvez définir la status publicitaire sur Actif ou Suspendu. Ajouter: Optionnel Mettre à jour: Optionnel	AdStatus
TrackingUrlTemplate	Non pris en charge pour ce type d’annonce.	chaîne
Type	Type de la publicité. Cette valeur est Product lorsque vous récupérez une annonce de produit. Pour plus d’informations sur les types d’annonces, consultez remarques sur les objets de données publicitaires. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdType
UrlCustomParameters	Non pris en charge pour ce type d’annonce.	CustomParameters

Configuration requise

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

Partager via