Champs, syntaxe et règles requis à respecter lors du formatage d’un fichier de données de caractéristiques entrant.
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.
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>
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 |
---|---|
|
Un identifiant utilisateur peut être :
Pour les identifiants mobiles :
|
|
Séparez l’ID utilisateur et les ID de caractéristiques à l’aide d’un délimiteur de tabulation unique. |
|
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 . |
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 |
---|---|
|
Le |
|
Données précédées du préfixe Le |
|
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 Par exemple, supposons que vous créiez ces 3 règles de caractéristiques :
Ces caractéristiques sont associées à la variable
|
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 :
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sont tous des exemples de paires clé-valeur correctement formatées. |
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.
Type d’ID | Condition |
---|---|
DPUUID |
Ne pas utilisez un deux-points codé ( |
Identifiant de l’appareil mobile iOS (IDFA) ou Android |
Les identifiants d’appareil mobile doivent être strictement formatés, comme illustré ici :
|
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 :
|
Caractère de tiret (-) |
Nous ignorons les signes de tiret au début des clés. Par exemple : |
|
Ne pas use |
|
N’utilisez pas les nouveaux caractères de ligne ou de tabulation ( |
Format du fichier de données | Description et exemple |
---|---|
Avec |
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.
Remarque : Au lieu d’utiliser d_unsid, vous pouvez également supprimer des caractéristiques des profils utilisateur en utilisant la syntaxe suivante :
|
Avec |
Ces caractéristiques ont été ajoutées à une règle de caractéristique avec la variable Identifiants numériques
ID de chaîne
|
Avec des paires clé-valeur |
Ces données de fichier utilisent des paires clé-valeur pour transmettre des données à Audience Manager .
|
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.
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 |
||||
Identifiant Google Advertising pour les appareils Android |
||||
Apple IDFA pour les appareils iOS |
||||
Votre propre identifiant CRM (DPUUID) |
Utilisation trait IDs envoyer trait informations de qualification pour Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
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
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"
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
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
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
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"
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
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
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
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"
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
Utilisation trait IDs envoyer trait informations de qualification pour DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
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
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"
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