Fichiers de données pour les rapports Audience Optimization et les fichiers journaux exploitables data-files-for-audience-optimization-reports
Un fichier de données contient des données d’impression, de clic ou de conversion. Lorsque le format est correct, vous pouvez importer ces données dans Audience Manager pour les afficher dans les Rapports Audience Optimization et créer des caractéristiques à l’aide des données via Fichiers journaux exploitables. Formatez vos fichiers de données selon ces spécifications dans cette section.
Présentation overview
Un fichier de données correctement nommé et formaté vous permet d’importer des données d’impression, de clic ou de conversion dans les Rapports Audience Optimization. Cela s’avère utile lorsque vous travaillez avec un partenaire qui n’est pas intégré à Audience Manager et que vous souhaitez utiliser ses données dans cette suite de rapports. Ce processus nécessite des fichiers distincts pour les données d’impression, de clic et de conversion. Ne mélangez pas ces événements dans un seul fichier.
Un fichier de données doit être accompagné d’un fichier de métadonnées. Le contenu du fichier de métadonnées fait correspondre les informations du fichier de données aux libellés lisibles par l’utilisateur dans les menus de rapport. Pour plus d’informations, consultez Présentation et mappages des fichiers de métadonnées.
Conventions de dénomination pour les fichiers de données naming-conventions
La syntaxe suivante définit la structure d’un nom de fichier de données correctement formé. Notez que l’italique indique un espace réservé de variable qui change en fonction du contenu du fichier.
Syntaxe :
event type_yyymmdd
Dans un nom de fichier :
- Le type d’événement indique que le fichier contient des impressions, des clics ou des conversions. Créez un fichier distinct pour chaque type d’événement.
- Un trait de soulignement sépare le type d’événement d’un horodatage année-mois-date.
- Avant de télécharger, compressez vos fichiers à l’aide de gzip et enregistrez-les avec l’extension de fichier
.gz.
Compte tenu de ces exigences, nommez vos fichiers de données en fonction de leur contenu comme suit :
-
Données d’impression :
code language-none impressions_yyymmdd.gz -
Données de clic :
code language-none clicks_yyymmdd.gz -
Données de conversion :
code language-none conversions_aaammjj.gz
Format de contenu des fichiers de données content-format
La syntaxe suivante définit la structure du contenu dans un fichier de données bien formé. Notez que l’italique indique un espace réservé pour la variable et est remplacé par un libellé dans un fichier de données réel.
Syntaxe :
libellé d’en-tête 1 | libellé d’en-tête 2 … libellé d’en-tête n | version
Dans le contenu du fichier :
-
Les libellés d’en-tête doivent apparaître dans l’ordre, comme illustré dans le tableau ci-dessous. Les impressions et les clics utilisent les mêmes libellés. Les fichiers de conversion contiennent des en-têtes supplémentaires.
-
Si vous ne disposez pas des données pour une colonne particulière, renseignez ce champ avec un
-1. -
Les fichiers doivent se terminent par un numéro de version. La version actuelle est la version 1.1.
-
En-têtes de fichier et contenu distincts avec le caractère ASCII 001 non imprimable. Si vous ne pouvez pas utiliser ASCII 001, séparez les en-têtes et les données par un délimiteur de tabulation. Comme il s’agit de caractères non imprimables, l’exemple de syntaxe ci-dessus montre un
"|"de barre verticale à des fins d’affichage uniquement.
Libellés de champ
Le tableau ci-dessous répertorie et décrit les en-têtes de colonne de votre fichier de données. Les en-têtes sont sensibles à la casse et doivent apparaître dans l’ordre du tableau. Tous les types de données sont des entiers (INT), sauf indication contraire.
yyyy-MM-dd HH:mm:ss .Nombre d’articles vendus dans un événement de conversion.
Pour les fichiers de données de conversion uniquement.
Montant d’achat ou autre montant de conversion. Type de données : Flottant.
Pour les fichiers de données de conversion uniquement.
URL de la landing page de conversion. Type de données : chaîne.
Pour les fichiers de données de conversion uniquement.
Type de conversion. Indique si une conversion correspond ou non. Les options incluent :
0: impression1: cliquez sur-1: non attribué ou inconnu
Pour les fichiers de données de conversion uniquement.
Méthodes de diffusion des fichiers de données delivery-methods
Chargez les fichiers de données d’impression, de clic ou de conversion dans un répertoire Amazon S3 pour votre compte Audience Manager. Reportez-vous à cette section pour plus d’informations sur les chemins de diffusion/répertoire, les temps de traitement des fichiers et les mises à jour.
Syntaxe et exemples du chemin de diffusion
Les données sont stockées dans un espace de noms distinct pour chaque client dans un répertoire Amazon S3. Le chemin d’accès au fichier suit la syntaxe affichée ci-dessous. Notez que l’italique indique un espace réservé de variable. Les autres éléments sont des constantes ou des clés et ne changent pas.
Syntaxe :
…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ type de fichier_aaaammdd
Le tableau suivant définit chacun de ces éléments dans un chemin de diffusion de fichier.
.../log_ingestion/pid=AAM IDdpid=d_srclogsfile type_yyyymmddExemple de chemin de chargement et nom de fichier
Lorsque vous chargez un fichier, le chemin d’accès ressemble à ceci :
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Temps de traitement des fichiers et mises à jour
Les fichiers de données sont traités quatre fois par jour, à intervalles réguliers.
Pour mettre à jour vos données, envoyez un fichier contenant toutes les impressions, clics ou conversions d’un jour spécifique. Dans ce cas, un jour est la période de 24 heures d'une minuit à l'autre. Il est recommandé d’utiliser l’heure UTC pour définir l’intervalle de jours.
Étapes suivantes next-steps
Examinez les exigences relatives à la dénomination et à la création des fichiers de métadonnées. Pour commencer, reportez-vous à la section Présentation et mappages des fichiers de métadonnées.