Champs, syntaxe et règles obligatoires que vous devez suivre lors du formatage d’un fichier de données de caractéristiques entrant.
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.
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>
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 |
---|---|
|
Un ID utilisateur peut être :
Pour les ID mobiles :
|
|
Séparez l’ID utilisateur et les ID de caractéristiques à l’aide d’un délimiteur de tabulation unique. |
|
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 . |
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 |
---|---|
|
Le préfixe |
|
Les données précédées de Le préfixe |
|
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 Supposons, par exemple, que vous créiez les trois règles de caractéristiques suivantes :
Ces caractéristiques sont associées à la clé
|
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 :
"age"="32" , "gender"=m model = "pickup truck" , product = tablet sont tous des exemples de paires clé-valeur correctement formatées. |
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.
Type d’ID | Condition |
---|---|
DPUUID |
N’utilisez pas de deux-points codés ( |
ID de périphérique mobile iOS (IDFA) ou Android |
Les ID des dispositifs portables doivent être strictement formatés, comme indiqué ici :
|
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 :
|
Caractère tiret (-) |
Nous ignorons les tirets au début des clés. Par exemple, |
|
N’utilisez pas |
|
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 montre 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éristiques avec le préfixe ID 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 .
|
[] (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.
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 |
||||
Identifiant de publicité Google pour les périphériques Android |
||||
Apple IDFA pour périphériques iOS |
||||
Votre propre ID CRM (DPUUID) |
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
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
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"
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
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
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
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"
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
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
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
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"
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
Utilisez trait IDs pour envoyer des informations de qualification trait pour DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
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
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"
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