Enregistrement d’élément de la liste des clients - En bloc

Définit un élément de liste de clients qui peut être chargé dans un fichier en bloc.

Remarque

Le téléchargement en bloc des éléments de liste de clients n’est pas pris en charge.

Importante

Avant de pouvoir charger des données de liste de clients via l’API en bloc, 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.

Une liste de clients est un ensemble d’informations de contact client que vous avez compilées pour activer la correspondance client. Chaque liste peut inclure plusieurs éléments Email.

• Incluez l’enregistrement Liste des clients dans le fichier de chargement en bloc et définissez son champ Type d’action sur « Ajouter », « Supprimer » ou « Remplacer ».
• Incluez un ou plusieurs enregistrements d’élément de liste de clients dans le même fichier de chargement en bloc et définissez les champs Id parent, Sous-type et Texte .

Vous pouvez ajouter ou mettre à jour un enregistrement de liste de clients sans enregistrement d’élément de liste de clients dans le même fichier de chargement en bloc ; Toutefois, vous ne pouvez pas charger d’enregistrements d’éléments de liste de clients sans l’enregistrement de liste de clients parent associé.

Après 48 heures, case activée les champs Taille de l’audience, par exemple, Taille de recherche d’audience pour voir le nombre de ces clients que nous avons mis en correspondance sur le réseau Bing. À ce stade, vos annonces peuvent commencer à s’afficher pour cette nouvelle audience.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les audiences, consultez le guide technique des API d’audience .

Vous pouvez télécharger tous les enregistrements d’éléments de liste de clients dans le compte en incluant la valeur DownloadEntity de CustomerLists dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute un nouvel élément de liste de clients.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue

Pour un enregistrement d’élément de liste de clients , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Audience
• Client Id
• Parent Id
• Sous-type
• Text

Audience

Nom de l’audience de la liste de clients parente.

Le nom peut contenir un maximum de 128 caractères.

Ajouter: Obligatoire. Vous devez spécifier le champ Id parent ou Audience .
Supprimer: Obligatoire. Vous devez spécifier le champ Id parent ou Audience .

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Supprimer: Optionnel

Parent Id

Identificateur de l’audience de la liste de clients parente.

Vous devez spécifier le champ Id parent ou Audience .

Ajouter: En lecture seule et Obligatoire. Vous devez spécifier un identificateur de liste de clients existant ou un identificateur négatif égal au champ Id de l’enregistrement de liste de clients parent. Cela est obligatoire si vous ajoutez de nouveaux éléments de liste de clients à une nouvelle liste de clients dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Supprimer: Obligatoire.

Sous-type

Détermine si le champ Texte représente une valeur de Email hachée.

Actuellement, la seule valeur prise en charge est « Email ».

Ajouter: Obligatoire
Supprimer: Obligatoire

Texte

La Email hachée en tant que texte.

Si le sous-type est « Email », ce champ ne peut pas contenir de texte brut. La chaîne doit être hachée à l’aide de l’algorithme SHA-256. Le Email haché doit être une chaîne hexadécimale de longueur 64. Par exemple, vous devez charger une chaîne hachée telle que « f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101 » au lieu de «test@contoso.com ».

Ajouter: Obligatoire
Supprimer: Obligatoire