Show Menu
SUJETS×

Contenu du fichier de données entrantes : Syntaxe, Caractères non valides, Variables et exemples

Champs, syntaxe et règles obligatoires à respecter lors du formatage d’un fichier de données de caractéristiques entrant.

Syntaxe du contenu du fichier

Les champs du fichier de données entrant doivent apparaître dans l’ordre indiqué ci-dessous. Dans cet exemple, les < symboles > ont été ajoutés afin de séparer visuellement chaque élément. Vous n’avez pas besoin de les inclure dans votre fichier de données.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

Pour consulter d’autres formats de contenu de fichier acceptés, voir Intégrations de partenaires personnalisés.
Nous avons une limite de 200 lignes que nous pouvons traiter pour chaque ID utilisateur envoyé dans le fichier de données entrant. Par exemple, si vous envoyez 300 lignes pour un ID utilisateur, les 200 premières lignes sont conservées et les 100 lignes supplémentaires sont ignorées. Dans l’exemple ci-dessous, vous êtes bien, car vous envoyez 3 lignes chacune pour l’ID utilisateur 1 et l’ID utilisateur 2. Nous n’imposons pas de limite au nombre de caractéristiques ou de paires clé-valeur que vous incluez dans une ligne.
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>

Définition des variables de fichier

Le tableau répertorie et définit les variables utilisées dans un fichier de données entrant correctement formaté. Le format italique indique un espace réservé variable.
Variable Description
User ID
Un ID utilisateur peut être :
  • ID utilisateur unique attribué par Audience Manager ( UUID Audience Manager ).
  • ID utilisateur unique affecté dans votre système de gestion de la relation client ( DPUUID, dans Audience Manager ).
  • ID de périphérique mobile Android ou iOS dans son formulaire d’origine, non modifié, tel qu’il est révélé par le système d’exploitation mobile.
Pour les ID mobiles :
  • Format IDFA : Les identifiants doivent être en majuscules et non pas hachés. For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Format Android : Les ID doivent être en minuscules et non en hachage. For example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Séparez l’ID utilisateur et les ID de caractéristiques à l’aide d’un délimiteur de tabulation unique.
trait ID
ID de caractéristique d’Audience Manager . Nous vous demandons d’inclure uniquement des caractéristiques intégrées dans les fichiers de données entrants. Nous ne traitons aucun autre type de caractéristique dans le transfert de données entrant.
Remarque : L’ID de caractéristique peut être trouvé en utilisant la méthode GET qui renvoie des détails sur toutes vos caractéristiques. Pour plus d’informations, voir Méthodes de l’API de caractéristiques .

Formatage des ID de caractéristiques

Le tableau suivant décrit les préfixes qui identifient les noms ou les ID de caractéristiques dans un fichier de données entrant. Voir les exemples de fichiers pour en savoir plus.
Préfixe Description
d_sid=
Le d_sid préfixe indique à notre système que l’ID est un identifiant de caractéristique d’Audience Manager. Il s’agit du même ID que celui qui est affiché dans l’interface utilisateur. Vous pouvez également renvoyer des ID de caractéristiques à l’aide de la GET méthode API. Voir Méthodes de l’API de caractéristiques .
d_unsid=
Le préfixe de données d_unsid supprime les utilisateurs de cette caractéristique. Le d_unsid préfixe est ignoré dans un overwrite fichier.
Le d_unsid= préfixe indique à notre système que l’ID est un identifiant de caractéristique d’Audience Manager. Il s’agit du même ID que celui qui est affiché dans l’interface utilisateur. Vous pouvez également renvoyer des ID de caractéristiques à l’aide de la GET méthode API. Voir Méthodes de l’API de caractéristiques .
ic=
Les règles de caractéristiques vous permettent de définir des critères pour la qualification des caractéristiques. Si vous mettez en forme une règle de caractéristique ic == trait ID , vous pouvez envoyer des caractéristiques dans une simple liste de valeurs au format virgule.
Supposons, par exemple, que vous créiez les 3 règles de caractéristiques suivantes :
  • ic == "123"
  • ic == "456"
  • ic == "789"
Ces caractéristiques sont associées à la ic clé. Vous pouvez ainsi créer une liste de caractéristiques plus simple dans le fichier de données. Et vous n’avez pas besoin d’inclure le ic préfixe. Par conséquent, le contenu de votre fichier de données peut se présenter comme suit :
                 user ID  <TAB> 123,456,789
Paires clé-valeur
Les données de caractéristiques peuvent être formatées sous forme de paires clé-valeur à l’aide de chaînes alphanumériques. Il existe plusieurs méthodes de formatage des paires clé-valeur, comme illustré ci-dessous :
  • key = value
  • "key" = value
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sont tous des exemples de paires clé-valeur correctement formatées.

Caractères non valides dans les ID de caractéristiques, les ID utilisateur et les paires clé-valeur

ID de caractéristiques

Les identifiants de caractéristiques sont constitués uniquement de caractères numériques. Nous vous demandons d’inclure uniquement des caractéristiques intégrées dans les fichiers de données entrants. Nous ne traitons aucun autre type de caractéristique dans le transfert de données entrant.

Identifiants d’utilisateurs

Type d’ID Condition
DPUUID
N’utilisez pas de deux-points codés ( %3A ) ou deux-points non codés ( : ) dans les DPUUID.
ID de périphérique mobile iOS (IDFA) ou Android
Les ID de périphérique mobile doivent être strictement formatés, comme illustré ici :
  • Format IDFA : Les identifiants doivent être en majuscules et non pas hachés. For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Format Android : Les ID doivent être en minuscules et non en hachage. For example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Paires clé-valeur

Des noms de valeur mal formatés dans une paire clé-valeur posent également problème. Suivez les règles suivantes lorsque vous créez ou nommez la valeur dans une paire clé-valeur :
Caractère Condition
Caractère de devis (")
Vous pouvez utiliser le caractère de guillemet dans la clé et dans la partie valeur de la paire clé-valeur, comme suit :
  • d_city = "New York", d_city = "San Francisco"
  • "d_city" = "New York", "d_city" = "San Francisco"
Caractère tiret (-)
Nous ignorons les signes de tirets au début des clés. Par exemple, -product = camera est interprété comme product = camera .
TAB
N’utilisez pas de valeur TAB au lieu de valeurs vides dans les paires clé-valeur. Utilisez uniquement TAB pour séparer les variables dans le fichier de données entrant.
\n, \t
N’utilisez pas les nouveaux caractères de ligne ou de tabulation ( \n, \t ) dans les clés ou dans les valeurs.

Exemples de fichiers de données

Format du fichier de données Description et exemple
Avec d_sid ou d_unsid
Ce fichier de données montre un utilisateur qualifié pour les caractéristiques 24, 26, 27 et a été supprimé des caractéristiques 28 et 29.
59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Remarque :
Au lieu d’utiliser d_unsid, vous pouvez également supprimer des caractéristiques des profils utilisateur en utilisant la syntaxe suivante :
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1
Avec ic==
Ces caractéristiques ont été ajoutées à une règle de caractéristiques avec le ic préfixe. Vous pouvez ainsi les ajouter au fichier de données en les séparant par des virgules, comme indiqué. Un onglet sépare l’UUID et les ID de caractéristique. Le ic préfixe n’est pas obligatoire dans le fichier.
ID numériques
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626
ID de chaîne
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55
Avec des paires clé-valeur
Ces données de fichier utilisent des paires clé-valeur pour transmettre les données à Audience Manager .
59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”
Téléchargez le fichier de données d’exemple si vous avez besoin d’exemples supplémentaires. Le fichier de téléchargement a une extension de .overwrite fichier. Vous pouvez l’ouvrir dans un éditeur de texte simple.

Exemple de matrice

Le graphique ci-dessous présente des exemples de la manière appropriée de formater vos fichiers entrants, selon le type d’ID et la méthode d’ajout de caractéristiques aux profils.
Type d’ID / Opération Utiliser d_sid pour ajouter des caractéristiques à un profil utilisateur Utiliser d_unsid pour supprimer des caractéristiques d’un profil utilisateur Envoyer des paires clé-valeur pour ajouter des caractéristiques à un profil utilisateur Utilisation du préfixe ic pour ajouter des caractéristiques à un profil utilisateur
UUID Audience Manager
Identifiant Google Advertising pour périphériques Android
Apple IDFA pour les périphériques iOS
Votre propre ID CRM (DPUUID)

Example 1

Utilisez les ID de caractéristique pour envoyer des informations de qualification de caractéristiques pour les UUID d’Audience Manager.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Utilisez les ID de caractéristique pour envoyer des informations de disqualification pour les UUID d’Audience Manager.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27

ou
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0

ou
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1

Example 3

Envoyez des paires clé-valeur pour ajouter des informations de qualification de caractéristiques pour les UUID d’Audience Manager.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

ou
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

Example 4

Utilisez le préfixe ic pour envoyer des informations de qualification de caractéristiques pour les UUID d’Audience Manager.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

ou
59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

Utilisez les ID de caractéristique pour envoyer des informations de qualification de caractéristique pour les périphériques Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Utilisez les ID de caractéristique pour envoyer des informations sur la disqualification des caractéristiques pour les périphériques Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0

ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1

Example 7

Envoyez des paires clé-valeur pour ajouter des informations de qualification des caractéristiques pour les périphériques Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

Example 8

Utilisez le préfixe ic pour envoyer des informations de qualification des caractéristiques pour les périphériques Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

Example 9

Utilisez les ID de caractéristiques pour envoyer des informations de qualification de caractéristiques pour les périphériques iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Utilisez les ID de caractéristique pour envoyer des informations sur la disqualification des caractéristiques pour les périphériques iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26

ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0

ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1

Example 11

Envoyez des paires clé-valeur pour ajouter des informations de qualification des caractéristiques pour les périphériques iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

Example 12

Utilisez le préfixe ic pour envoyer des informations de qualification des caractéristiques pour les périphériques iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

Example 13

Utilisez des ID de caractéristique pour envoyer des informations de qualification de caractéristique pour les DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Utilisez les ID de caractéristique pour envoyer des informations sur la disqualification des caractéristiques pour les DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0

ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1

Example 15

Envoyez des paires clé-valeur pour ajouter des informations de qualification des caractéristiques pour les DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

Example 16

Utilisez le préfixe ic pour envoyer des informations de qualification des caractéristiques pour les DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55