Objet de données CustomerList - Gestion des campagnes
Définit un objet de données CustomerList.
Importante
Avant de créer des données de liste de clients via l’API Gestion des campagnes, vous devez d’abord créer une audience de liste de clients et accepter les conditions générales dans l’interface utilisateur Microsoft Advertising. La liste initiale des clients n’a pas besoin de contenir de données client, mais vous devez sélectionner J’ACCEPTE. En sélectionnant « J’accepte », vous (1) acceptez que vous êtes en mesure de divulguer légalement les détails de l’audience, qui sont des données personnelles, à Microsoft et (2) acceptez les Conditions de correspondance client, le Contrat Microsoft Advertising et les politiques de Microsoft Advertising. Microsoft utilisera les données que vous chargez conformément aux Conditions de correspondance client.
Syntaxe
<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Audience">
<xs:sequence />
</xs:extension>
</xs:complexContent>
</xs:complexType>
Éléments
L’objet CustomerList contient des éléments hérités.
Éléments hérités
Éléments hérités de l’audience
L’objet CustomerList 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 à CustomerList 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 390 jours. Vous pouvez également définir la durée sur -1 sans expiration. 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’à 48 heures pendant la génération de l’audience, par exemple si vous ajoutez ou mettez à jour la durée d’appartenance à la liste des clients. 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 CustomerList lorsque vous récupérez une audience de liste de clients. 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