Contenu du fichier de données entrant : syntaxe, caractères non valides, variables et exemples

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

Les champs du fichier de données entrant doivent apparaître dans l’ordre indiqué ci-dessous. Dans cet exemple, la variable < > des 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, voir Intégrations personnalisées des partenaires.

REMARQUE

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, vous êtes bon car vous envoyez 3 lignes chacune pour l’identifiant utilisateur 1 et l’identifiant utilisateur 2. Nous n’appliquons 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>

Variables de fichier définies

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 :

  • Un identifiant utilisateur unique attribué par Audience Manager ( UUID Audience Manager ).
  • Identifiant utilisateur unique attribué dans votre système de gestion de la relation client ( DPUUID, en Audience Manager ).
  • Identifiant d’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

Séparez l’ID utilisateur et les ID de caractéristiques à l’aide d’un délimiteur de tabulation unique.

trait ID

Le Audience Manager ID de caractéristique. Nous vous demandons d’inclure seules 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éristique .

Formatage Trait IDs

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

Préfixe Description

d_sid=

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

d_unsid=

Données précédées du préfixe d_unsid supprime les utilisateurs de cette caractéristique. Le d_unsid est ignoré dans un overwrite fichier .

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

ic=

Règles de caractéristiques vous permet de définir des critères pour la qualification des caractéristiques. 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 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 variable ic clé. Vous pouvez ainsi créer une liste de caractéristiques plus simple dans le fichier de données. De plus, vous n’avez pas besoin d’inclure la variable 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 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 Trait IDs, User IDs et paires clé-valeur

Trait IDs

Trait IDs se composent uniquement de caractères numériques. Nous vous demandons d’inclure onlyonboarded traits dans les fichiers de données entrants. Nous ne traitons aucun autre trait dans le transfert de données entrant.

User IDs

Type d’ID Condition

DPUUID

Ne pas utilisez un deux-points codé ( %3A ) ou deux-points non codés ( : ) 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

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 :

Caractère Condition

Caractère de citation (")

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"

Caractère de tiret (-)

Nous ignorons les signes de tiret au début des clés. Par exemple : -product = camera est interprété comme product = camera .

TAB

Ne pas use TAB au lieu de valeurs vides dans les paires clé-valeur. Uniquement utiliser 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 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

Avec ic==

Ces caractéristiques ont été ajoutées à une règle de caractéristique avec la variable ic préfixe. 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 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 le fichier de données d’exemple si vous avez besoin d’exemples supplémentaires. Le fichier de téléchargement comporte une balise .overwrite extension de fichier. Vous pouvez l’ouvrir à l’aide d’un simple éditeur de texte.

Matrice d’exemples

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

Type d’ID/opération Utilisation de d_sid pour ajouter des caractéristiques à un profil utilisateur Utiliser d_unsid pour supprimer des caractéristiques d’un profil utilisateur Envoi de 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

Exemple 1

Exemple 2

Exemple 3

Exemple 4

Identifiant Google Advertising 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

Utilisation trait IDs envoyer trait informations de qualification pour Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Exemple 2

Utilisation trait IDs 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

Envoyer des paires clé-valeur à ajouter trait informations de qualification pour Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

ou

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

Exemple 4

Utilisez la variable ic préfixe à 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

Utilisation trait IDs envoyer trait informations de qualification pour Android périphériques.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Exemple 6

Utilisation trait IDs envoyer trait informations de disqualification pour Android périphériques.

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

Envoyer des paires clé-valeur à ajouter trait informations de qualification pour Android périphériques.

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

ou

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

Exemple 8

Utilisez la variable ic préfixe à envoyer trait informations de qualification pour Android périphériques.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

ou

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

Exemple 9

Utilisation trait IDs envoyer trait informations de qualification pour iOS périphériques.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Exemple 10

Utilisation trait IDs envoyer trait informations de disqualification pour iOS périphériques.

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

Envoyer des paires clé-valeur à ajouter trait informations de qualification pour iOS périphériques.

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

ou

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

Exemple 12

Utilisez la variable ic préfixe à envoyer trait informations de qualification pour iOS périphériques.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

ou

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

Exemple 13

Utilisation trait IDs envoyer trait informations de qualification pour DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Exemple 14

Utilisation trait IDs envoyer trait informations de disqualification 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

Envoyer des paires clé-valeur à ajouter trait informations de qualification pour DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

ou

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

Exemple 16

Utilisez la variable ic préfixe à envoyer trait informations de qualification pour DPUUIDs.

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

ou

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
Articles connexes

Sur cette page