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

Champs, syntaxe et règles obligatoires que vous devez suivre 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 entrantes 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. Il n’est pas nécessaire 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 de partenaire personnalisées.

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 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 satisfait car vous envoyez 3 lignes chacune pour l’ID utilisateur 1 et l’ID 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 liste et définit les variables utilisées dans un fichier de données entrantes 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 d'Audience Manager ).
  • ID utilisateur unique affecté dans votre système de gestion de la relation client ( DPUUID, en Audience Manager ).
  • Identifiant de périphérique mobile Android ou iOS sous sa forme originale, non modifiée, 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 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

ID 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'ID 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 de l'API de caractéristiques .

Formatage 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 les exemples de fichiers pour 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 qui est affiché dans l’interface utilisateur. Vous pouvez également renvoyer des ID de caractéristiques à l’aide de la méthode API GET . Voir Méthodes de l'API de caractéristiques .

d_unsid=

Les données précédées de 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 qui est affiché dans l’interface utilisateur. Vous pouvez également renvoyer des ID de caractéristiques à l’aide de la méthode API GET . 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 de 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 format virgule.

Supposons, par exemple, que vous créiez les trois règles de caractéristiques suivantes :

  • ic == "123"
  • ic == "456"
  • ic == "789"

Ces caractéristiques sont associées à la clé ic . Cela vous permet de 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

Paires clé-valeur

Les données de caractéristiques peuvent être formatées en 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 Trait IDs, User IDs et paires clé-valeur

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

Type d’ID Condition

DPUUID

N’utilisez pas de deux-points codés ( %3A ) ou de deux-points non codés ( : ) dans DPUUIDs.

ID de périphérique mobile iOS (IDFA) ou Android

Les ID des dispositifs portables doivent être strictement formatés, comme indiqué 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 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 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 tirets au début des clés. Par exemple, -product = camera est interprété comme product = camera .

TAB

N’utilisez pas TAB 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 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 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éristique. Le préfixe ic n'est pas requis 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 des données à Audience Manager .

59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”

[] (assets/ftp_dpm_1234_1445374061.overwrite) 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 fichier .overwrite. 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, en fonction du type d’ID et de la méthode par laquelle vous souhaitez ajouter traits 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 Utilisez le préfixe ic pour ajouter des caractéristiques à un profil utilisateur.

UUID Audience Manager

Exemple 1

Exemple 2

Exemple 3

Exemple 4

Identifiant de publicité Google pour les périphériques Android

Exemple 5

Exemple 6

Exemple 7

Exemple 8

Apple IDFA pour périphériques iOS

Exemple 9

Exemple 10

Exemple 11

Exemple 12

Votre propre ID CRM (DPUUID)

Exemple 13

Exemple 14

Exemple 15

Exemple 16

Exemple 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

Utilisez trait IDs pour envoyer des informations d'exclusion 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

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

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

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

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

Envoyez des paires clé-valeur pour ajouter des informations de qualification trait 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"

Exemple 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

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

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

Envoyez des paires clé-valeur pour ajouter des informations de qualification trait 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"

Exemple 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

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

Utilisez trait IDs pour envoyer des informations d'exclusion 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

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

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
Articles connexes

Sur cette page