Contenu du fichier de données entrant : syntaxe, caractères non valides, variables et exemples inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Champs, syntaxe et règles requis à respecter lors du formatage d’un fichier de données de caractéristiques entrant.
Syntaxe du contenu du fichier file-content-syntax
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 connaître les autres formats de contenu de fichier acceptés, reportez-vous à la section Intégrations personnalisées des partenaires.
code language-none |
---|
|
Variables de fichier définies file-variables-defined
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.
User ID
Un identifiant utilisateur peut être :
- Identifiant utilisateur unique attribué par l’ Audience Manager ( Audience Manager UUID).
- Identifiant utilisateur unique attribué dans votre système CRM ( DPUUID, en Audience Manager).
- Identifiant de l’appareil mobile Android ou iOS sous sa forme d’origine non modifiée, tel qu’il est exposé par le système d’exploitation mobile.
Pour les identifiants mobiles :
- Format IDFA : les identifiants doivent être en majuscules et non hachés. Par exemple,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Format Android : les identifiants doivent être en minuscules et non hachés. Par exemple,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
L’identifiant de caractéristique de l’Audience Manager . Nous vous demandons d’inclure uniquement les 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’identifiant de caractéristique est accessible à l’aide de la méthode de GET qui renvoie des détails sur toutes vos caractéristiques. Pour plus d’informations, voir Méthodes d’API de caractéristiques.
Formatage Trait IDs formatting-trait-ids
Le tableau suivant décrit les préfixes qui identifient trait noms ou identifiants dans un fichier de données entrant. Voir les fichiers d’exemple pour obtenir des exemples.
d_sid=
d_sid
indique à notre système que l’ID est un ID de caractéristique d’Audience Manager . Il s’agit du même identifiant que celui affiché dans l’interface utilisateur. Vous pouvez également renvoyer des identifiants de caractéristique avec la méthode API GET
. Voir Méthodes d’API de caractéristiques.d_unsid=
Le préfixe de données d_unsid
supprime les utilisateurs de cette caractéristique. Le préfixe d_unsid
est ignoré dans un fichier overwrite
.
Le préfixe d_unsid=
indique à notre système que l’ID est un ID de caractéristique d’Audience Manager . Il s’agit du même identifiant que celui affiché dans l’interface utilisateur. Vous pouvez également renvoyer des identifiants de caractéristique avec la méthode API GET
. Voir Méthodes d’API de caractéristiques.
ic=
Les règles de caractéristiquesvous permettent de définir des critères pour la qualification des caractéristiques. Si vous mettez en forme une règle de caractéristique en tant que ic == trait ID
, vous pouvez envoyer des caractéristiques dans une simple liste au format virgule.
Par exemple, supposons que vous créiez ces 3 règles de caractéristiques :
ic == "123"
ic == "456"
ic == "789"
Ces caractéristiques sont associées à la clé ic
. 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 préfixe ic
. Par conséquent, le contenu de votre fichier de données peut se présenter comme suit :
user ID <TAB> 123,456,789
Les données de caractéristiques peuvent être formatées en tant que paires clé-valeur à l’aide de chaînes alphanumériques. Il existe plusieurs façons de mettre en forme les 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 paires Trait IDs, User IDs et clé-valeur invalid-chars
Trait IDs
Trait IDs se compose uniquement de caractères numériques. Nous vous demandons d’inclure uniquementonboarded traits dans les fichiers de données entrants. Nous ne traitons aucun autre type trait dans le transfert de données entrant.
User IDs
%3A
) ou de deux-points non codés ( : ) dans les DPUUID.Les identifiants d’appareil mobile doivent être strictement formatés, comme illustré ici :
- Format IDFA : les identifiants doivent être en majuscules et non hachés. Par exemple,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Format Android : les identifiants doivent être en minuscules et non hachés. Par exemple,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Paires clé-valeur
Les noms de valeurs mal formatés dans une paire clé-valeur entraînent également des problèmes. Suivez ces règles lors de la création ou de la dénomination de la valeur dans une paire clé-valeur :
Vous pouvez utiliser le caractère guillemet 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"
-product = camera
est interprété comme product = camera
.TAB
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, \t
) dans les clés ou dans les valeurs.Exemples de fichiers de données data-file-examples
d_sid
ou d_unsid
Ce fichier de données présente un utilisateur qualifié pour les caractéristiques 24, 26, 27 et a été supprimé des caractéristiques 28 et 29.
59767559181262060060278870901087098252 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 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Ces caractéristiques ont été ajoutées à une règle de caractéristique avec le préfixe ic
. Ainsi, vous pouvez 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éristiques. Le préfixe ic
n’est pas requis dans le fichier .
ID numériques
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
ID de chaîne
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Ces données de fichier utilisent des paires clé-valeur pour transmettre des données à l’Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
Téléchargez l’exemple de fichier de données si vous avez besoin d’exemples supplémentaires. Le fichier de téléchargement possède une extension de fichier .overwrite
. Vous pouvez l’ouvrir à l’aide d’un simple éditeur de texte.
Matrice d’exemples examples-matrix
Le graphique ci-dessous montre des exemples de la manière correcte de formater vos fichiers entrants, en fonction du type d'ID et de la méthode par laquelle vous souhaitez ajouter traits aux profils.
Exemple 1 example-1
Utilisez trait IDs pour envoyer des informations de qualification trait pour Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Exemple 2 example-2
Utilisez trait IDs pour envoyer des informations de disqualification trait pour Audience Manager UUIDs.
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
Exemple 3 example-3
Envoyez des paires clé-valeur pour ajouter des informations de qualification trait pour Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
ou
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Exemple 4 example-4
Utilisez le préfixe ic
pour envoyer des informations de qualification trait pour Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
ou
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Exemple 5 example-5
Utilisez trait IDs pour envoyer des informations de qualification trait pour les périphériques Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Exemple 6 example-6
Utilisez trait IDs pour envoyer des informations de disqualification trait 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
Exemple 7 example-7
Envoyez des paires clé-valeur pour ajouter des informations de qualification trait pour les appareils Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Exemple 8 example-8
Utilisez le préfixe ic
pour envoyer des informations de qualification trait 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
Exemple 9 example-9
Utilisez trait IDs pour envoyer des informations de qualification trait pour les périphériques iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Exemple 10 example-10
Utilisez trait IDs pour envoyer des informations de disqualification trait 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
Exemple 11 example-11
Envoyez des paires clé-valeur pour ajouter des informations de qualification trait pour les appareils iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Exemple 12 example-12
Utilisez le préfixe ic
pour envoyer des informations de qualification trait 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
Exemple 13 example-13
Utilisez trait IDs pour envoyer des informations de qualification trait pour DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Exemple 14 example-14
Utilisez trait IDs pour envoyer des informations de disqualification trait pour DPUUIDs.
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
Exemple 15 example-15
Envoyez des paires clé-valeur pour ajouter des informations de qualification trait pour DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Exemple 16 example-16
Utilisez le préfixe ic
pour envoyer des informations de qualification trait pour DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55