Partager via

Objet de données ProductAudience - Gestion des campagnes

  • Article

Définit une audience de produits que vous pouvez utiliser pour le remarketing des produits à partir de votre magasin Microsoft Merchant Center.

Remarque

Les listes de remarketing dynamiques étaient auparavant appelées audiences de produits dans Microsoft Advertising. Vous verrez « Liste de remarketing dynamique » dans l’interface utilisateur Microsoft Advertising, mais pour éviter les modifications cassantes, les objets d’API sont toujours nommés « audience de produit ».

Les listes de remarketing dynamiques associent des clients à des produits spécifiques en fonction de ce qu’ils ont examiné, considéré ou déjà acheté sur votre site web. Vous pouvez utiliser des listes de remarketing dynamiques dans les campagnes de recherche et les campagnes d’audience (tout le monde n’a pas encore de campagnes d’audience).

Les listes de remarketing dynamique fonctionnent mieux avec les campagnes Shopping et les campagnes d’audience basées sur les flux, c’est-à-dire les campagnes qui tirent parti d’un ID de magasin Microsoft Merchant Center.

Importante

Veillez à modifier le script correspondant à l’ID de balise de suivi des conversions sur votre site web pour inclure les ecomm_prodid paramètres et ecomm_pagetype . Le paramètre ecomm_prodid est l’ID de produit du produit sur la page. Il est unique pour chaque élément et doit correspondre à l’attribut id ou item_group_id dans votre flux de produit. Caractères numériques et alphanumériques (y compris les traits d’union) uniquement, avec un maximum de 50 caractères. Le paramètre ecomm_pagetype identifie le type de page visité par l’utilisateur. Options valides : accueil, searchresults, catégorie, produit, panier, achat, autre.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Syntaxe

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet ProductAudience contient les éléments suivants : ProductAudienceType, TagId.

Élément Description Type de données
ProductAudienceType Détermine s’il faut faire du remarketing de vos produits pour les visiteurs généraux, les utilisateurs de recherche de produits, les visionneuses de produits, les abandonnaires de panier d’achat ou les anciens acheteurs.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 ProductAudienceType
TagId Identificateur Microsoft Advertising de la balise Suivi des événements universels (UET) utilisée avec la liste de remarketing.

Avant de prendre une dépendance sur l’ID de balise, notez que la balise de suivi des conversions peut être partagée avec ou à partir d’un autre client. Les audiences et les balises de suivi des conversions partagées sont uniquement disponibles pour les clients pilotes. Pour obtenir une vue d’ensemble du partage d’audiences et de balises de suivi des conversions dans une hiérarchie de clients, consultez le guide technique Partager les audiences et les balises de suivi des conversions.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 long

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

Éléments hérités

Éléments hérités de l’audience

L’objet ProductAudience dérive de l’objet Audience et hérite des éléments suivants : AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Les descriptions ci-dessous sont spécifiques à ProductAudience et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Audience .

Élément Description Type de données
AudienceNetworkSize Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau Audience. Cela vous donne une idée du nombre d’utilisateurs du réseau Audience que vous pouvez cibler.

L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 long
CustomerShare Cet élément n’est pas pris en charge pour les audiences de produits.

Vous pouvez utiliser un TagId partagé avec des audiences de produit, mais une audience de produit elle-même ne peut pas être partagée.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge		 CustomerShare
Description Description de l’audience. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez.

La description peut contenir un maximum de 1 024 caractères.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 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.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour l’objet Audience .		 Tableau KeyValuePairOfstringstring
Id Identificateur Microsoft Advertising de l’audience.

Ajouter: En lecture seule
Mettre à jour: Obligatoire et en lecture seule		 long
MembershipDuration Lorsque vous créez une audience, vous pouvez spécifier dans quelle mesure Microsoft Advertising doit rechercher les actions qui correspondent à votre définition d’audience.

La durée minimale est de 1 jour et la durée maximale autorisée est de 180 jours.

Ajouter: Optionnel. Si elle n’est pas spécifiée, la durée d’appartenance est définie sur 30 par défaut.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 int
Nom Nom de l’audience. Le nom peut contenir un maximum de 128 caractères.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
ParentId Identificateur Microsoft Advertising du compte ou du client.

Si l’étendue est définie sur Compte, il s’agit de l’ID de compte et, sinon, il s’agit de l’ID client.

Ajouter: Obligatoire
Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’ID parent.		 long
Portée L’étendue définit les comptes qui peuvent utiliser cette audience.

Si l’étendue est définie sur Compte, l’audience ne peut être associée qu’à des campagnes et des groupes d’annonces dans un seul compte, c’est-à-dire via le ParentId. Si l’étendue est définie sur Client, l’audience peut être associée à des campagnes et des groupes d’annonces dans tous les comptes du client.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Vous pouvez modifier l’étendue de Compte en Client, mais vous ne pouvez pas modifier l’étendue de Client à Compte.		 EntityScope
SearchSize Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau de recherche. Cela vous donne une idée du nombre d’utilisateurs de recherche que vous pouvez cibler.

L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations.

Cette propriété sera nulle ou vide pendant jusqu’à 24 heures pendant la génération de l’audience, par exemple si vous ajoutez ou mettez à jour la durée d’appartenance ou l’identificateur de balise.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 long
SupportedCampaignTypes Liste des types de campagne qui prennent en charge cette audience.

Les valeurs prises en charge sont Audience, DynamicSearchAds, Search et Shopping. De nouveaux types de campagne peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 tableau de chaînes
Type Type de l’audience. Cette valeur est ProductAudience lorsque vous récupérez une audience de produit. Pour plus d’informations sur les types d’audience, consultez Les remarques sur les objets de données d’audience.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 Type d’audience

Configuration requise

Service : CampaignManagementService.svc v13
Espace de noms: https://bingads.microsoft.com/CampaignManagement/v13