DocumentationAudience ManagerGuide d’utilisation d’Audience Manager

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

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Champs obligatoires, syntaxe et règles à suivre 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 pour aider à 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 les autres formats de contenu de fichier acceptés, voir Intégrations de partenaires personnalisées.

NOTE
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 identifiant utilisateur, les 200 premières lignes sont conservées et les 100 lignes supplémentaires sont ignorées. Dans l’exemple ci-dessous, tout va bien, car vous envoyez 3 lignes chacune pour les ID d’utilisateur 1 et 2. Nous n’imposons pas de limite au nombre de caractéristiques ou de paires clé-valeur que vous incluez dans une ligne.
code language-none 
<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>

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.

Variable
Description
User ID

Un identifiant utilisateur peut être :

  • ID d’utilisateur unique attribué par Audience Manager ( UUID Audience Manager).
  • Un identifiant utilisateur unique attribué dans votre système CRM ( DPUUID, dans Audience Manager).
  • Identifiant d’appareil mobile Android ou iOS dans sa forme d’origine non modifiée, tel qu’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
Séparez les ID d’utilisateur et de caractéristique par un seul délimiteur de tabulation.
trait ID

L’identifiant de caractéristique de 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 lors du transfert de données entrantes.

Remarque : l’ID de caractéristique se trouve à l’aide de la méthode GET qui renvoie des détails sur toutes vos caractéristiques. Pour plus d’informations, voir Méthodes de l’API Trait .

Formatage des Trait IDs formatting-trait-ids

Le tableau suivant décrit les préfixes qui identifient les noms ou identifiants trait dans un fichier de données entrant. Voir exemples de fichiers pour obtenir des exemples.

Préfixe
Description
d_sid=
Le préfixe d_sid indique à notre système que l’identifiant est un identifiant de caractéristique Audience Manager . Il s’agit du même identifiant que celui affiché dans l’interface utilisateur d’. Vous pouvez également renvoyer des identifiants de caractéristique avec la méthode GET de l’API. Voir Méthodes d’API de caractéristique .
d_unsid=

Les données dotées du préfixe d_unsid suppriment 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’identifiant est un identifiant de caractéristique Audience Manager . Il s’agit du même identifiant que celui affiché dans l’interface utilisateur d’. Vous pouvez également renvoyer des identifiants de caractéristique avec la méthode GET de l’API. Voir Méthodes d’API de caractéristique .

ic=

règles de caractéristique vousde définir des critères pour la qualification de la caractéristique. Si vous formatez une règle de caractéristique en tant que ic == trait ID , vous pouvez envoyer des caractéristiques dans une simple liste formatée par des virgules.

Supposons, par exemple, que vous créiez ces 3 règles de caractéristique :

  • 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. De plus, il n’est pas nécessaire d’inclure le préfixe ic . Par conséquent, le contenu de votre fichier de données peut ressembler à ceci :

                 user ID <TAB> 123,456,789

Paires clé-valeur

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 manières de formater 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 paires Trait IDs, User IDs et clé-valeur invalid-chars

Trait IDs

Trait IDs se composent 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 de trait lors du transfert de données entrantes.

User IDs

Type d’ID
Condition
DPUUID
N’utilisez pas signe deux-points codé ( %3A ) ou non codé ( : ) dans les DPUUID.
Identifiant de l’appareil Mobile iOS (IDFA) ou Android

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

Des 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 l’attribution d’un nom à la valeur dans une paire clé-valeur :

Caractère
Condition
Guillemet ( »)

Vous pouvez utiliser le 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"

Tiret (-)
Nous ignorons les tirets au début des clés. Par exemple, -product = camera est interprété comme product = camera .
TAB
Ne pas utiliser utilisez TAB au lieu de valeurs vides dans les paires clé-valeur. N’utilisez TAB que 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 les valeurs.

Exemples de fichiers de données data-file-examples

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  d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

Remarque :

Au lieu d_unsid, vous pouvez également supprimer des caractéristiques des profils utilisateur à l’aide de la syntaxe suivante :

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 29:-1

Avec ic==

Ces caractéristiques ont été ajoutées à une règle de caractéristique avec le préfixe ic . Vous pouvez donc les ajouter au fichier de données en les séparant par des virgules, comme illustré ci-dessous. Un onglet sépare l’UUID et les identifiants de caractéristique. Le préfixe ic n’est pas requis dans le fichier .

Identifiants numériques

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

ID de chaîne

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

Avec des paires clé-valeur

Ces données de fichier utilisent des paires clé-valeur pour transmettre des données à ’ Audience Manager.

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

Télécharger l’exemple de fichier de données si vous avez besoin d’exemples supplémentaires. Le fichier de téléchargement a une extension de fichier .overwrite. Vous pouvez l’ouvrir à l’aide d’un simple éditeur de texte.

Matrice des exemples examples-matrix

Le graphique ci-dessous présente des exemples de mise en forme correcte de vos fichiers entrants, en fonction du type d’ID et de la méthode par laquelle vous souhaitez ajouter des traits aux profils.

Type d’identifiant/opération
Utilisez d_sid pour ajouter des caractéristiques à un profil utilisateur
Utilisez d_unsid pour supprimer des caractéristiques d’un profil utilisateur
Envoi de paires clé-valeur pour ajouter des caractéristiques à un profil utilisateur
Utiliser le préfixe ic pour ajouter des caractéristiques à un profil utilisateur
UUID AUDIENCE MANAGER
Exemple 1
Exemple 2
Exemple 3
Exemple 4
Google Advertising ID pour les appareils Android
Exemple 5
Exemple 6
Exemple 7
Exemple 8
Apple IDFA pour les appareils iOS
Exemple 9
Exemple 10
Exemple 11
Exemple 12
Votre propre identifiant CRM (DPUUID)
Exemple 13
Exemple 14
Exemple 15
Exemple 16

Exemple 1 example-1

Utilisez trait IDs pour envoyer des informations de qualification de 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 trait informations de disqualification 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 trait informations de qualification 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 de trait pour les appareils 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 de trait pour les appareils 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 de trait pour les appareils 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 de trait pour les appareils 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 de trait pour les appareils 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 de trait pour les appareils 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 de 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 de 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 les 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 de trait pour DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

ou

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695