Partager via

Enregistrement de liste de clients - En bloc

  • Article

Définit une liste de clients qui peut être téléchargée et chargée dans un fichier en bloc.

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.

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 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 une nouvelle liste de clients.

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

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

Type d’action

Détermine s’il faut ajouter, supprimer ou remplacer les enregistrements d’éléments de liste de clients que vous incluez dans le même fichier de chargement en bloc.

Si le type d’action est « Ajouter », le service tente d’ajouter les enregistrements d’éléments de liste de clients que vous incluez dans le même fichier de chargement en bloc.

Si le type d’action est défini sur « Supprimer », le service tente de supprimer les enregistrements d’éléments de liste des clients que vous incluez dans le même fichier de chargement en bloc.

Si le type d’action est défini sur « Remplacer », toutes les données de correspondance client précédentes pour cette liste sont supprimées et le service tente d’ajouter les enregistrements d’éléments de liste clients que vous incluez dans le même fichier de chargement en bloc.

Ajouter: Optionnel. Par défaut, le type d’action « Ajouter » est utilisé pour les nouvelles listes de clients. Que vous définissiez ou non une valeur, ce champ est ignoré pour les nouvelles listes de clients.
Mettre à jour: Obligatoire si vous incluez également des enregistrements d’éléments de liste de clients pour une audience existante dans le même fichier de chargement en bloc ; sinon, ce champ est facultatif.
Supprimer: En lecture seule

Audience

Nom de la liste des clients.

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é.
Supprimer: En lecture seule

Taille du réseau d’audience

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
Supprimer: En lecture seule

Taille de la recherche d’audience

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 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 des clients, la règle ou l’identificateur de balise.

Cette propriété est vide si la balise de suivi des conversions associée à la liste de clients a un status non vérifié ou inactif, car la liste de clients 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
Supprimer: En lecture seule

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
Mettre à jour: Optionnel
Supprimer: En lecture seule

Description

Description de la liste des clients. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez avec cette liste de clients.

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é. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID

Identificateur généré par le système de la liste des clients.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour la liste de clients peut ensuite être référencé dans le champ Id parent des types d’enregistrements dépendants tels que l’élément de liste des clients. Cela est obligatoire si vous ajoutez une nouvelle liste de clients et de nouveaux éléments de 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.
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Durée de l’appartenance

Lorsque vous créez une liste de clients, vous pouvez spécifier la durée pendant laquelle les utilisateurs restent dans ce segment.

La durée minimale est de 1 jour. Note: Si un utilisateur n’a aucune activité pendant 180 jours, il est supprimé de tous les segments.

Si la durée d’appartenance est « -1 », il n’y a pas d’expiration.

Si la durée d’appartenance est null, la durée par défaut (30 jours) est utilisée.

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

Parent Id

Identificateur Microsoft Advertising du client qui contient la liste des clients.

Ajouter: Optionnel
Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’ID parent.
Supprimer: En lecture seule

Portée

L’étendue définit les comptes qui peuvent utiliser cette liste de clients. Pour une liste de clients, la seule étendue prise en charge est Client, et la liste de clients peut être associée à n’importe quelle campagne et groupe d’annonces sur tous les comptes du client.

Ajouter: Obligatoire
Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’étendue.
Supprimer: En lecture seule

Statut

La liste des clients status.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: En lecture seule
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Types de campagnes pris en charge

Liste délimitée par des points-virgules des types de campagne qui prennent en charge cette liste de clients.

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
Supprimer: En lecture seule