Objet de données RemarketingList - Gestion des campagnes

Article
07/19/2024

Définit une liste de remarketing.

Conseil

Pour obtenir une vue d’ensemble de l’implémentation, consultez le guide technique du suivi des événements universels .

Remarque

Microsoft Advertising génère automatiquement des audiences similaires pour les listes de remarketing si vous êtes un participant pilote. Vous ne pouvez pas créer ou modifier l’audience similaire pour une liste de remarketing. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions de liste de remarketing similaires. Si vous supprimez la liste de remarketing source, l’audience similaire est également supprimée. Si une audience similaire est associée à une campagne ou un groupe d’annonces, vous ne pouvez pas supprimer la liste de remarketing source. Pour plus d’informations, consultez SimilarRemarketingList .

Syntaxe

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

Éléments

L’objet RemarketingList contient les éléments suivants : Rule, TagId.

Élément	Description	Type de données
Règle	Une règle inclut des conditions utilisées pour déterminer qui ajouter à votre liste de remarketing. Vous pouvez choisir l’un des quatre types de règles pour cibler différentes audiences : CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule et PageVisitorsWhoVisitedAnotherPageRule. Ajouter: Obligatoire Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous souhaitez conserver l’un des éléments de règle précédents, vous devez les définir explicitement à nouveau lors de la mise à jour. Vous pouvez choisir de modifier le type de règle pendant la mise à jour.	RemarketingRule
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 RemarketingList contient des éléments hérités.

Éléments hérités

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

L’objet RemarketingList 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 à RemarketingList 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	Détermine la liste des clients et des comptes qui partagent l’audience. Les détails incluent le nombre d’associations d’audiences. 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: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Définissez cet élément sur null ou vide pour conserver les partages de compte client existants. Pour supprimer tous les partages de compte client, définissez l’élément CustomerAccountShares de l’objet CustomerShare sur Null ou vide. Pour supprimer un sous-ensemble de partages de comptes clients, spécifiez les partages de compte client que vous souhaitez conserver dans l’élément CustomerAccountShares de l’objet CustomerShare .	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 à la liste de remarketing, la règle ou l’identificateur de balise. Cette propriété est nulle ou vide si la balise de suivi des conversions associée à la liste de remarketing a une status non vérifiée ou inactive, car la liste de remarketing ne peut pas recevoir les informations client de votre site web dont elle a besoin pour créer la liste. 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 RemarketingList lorsque vous récupérez une audience de liste de remarketing. 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
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Partager via