Fichiers de données pour les rapports d’Audience Optimization et les fichiers journaux pratiques 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 d’Audience Optimization et créer des caractéristiques à l’aide des données via les fichiers journaux pratiques. Mettez en forme vos fichiers de données conformément à 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 d’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 correspond aux informations du fichier de données aux libellés associés, lisibles par l’utilisateur, dans les menus du rapport. Pour plus d’informations, voir Présentation et mappages des fichiers de métadonnées.
Conventions de dénomination des fichiers de données naming-conventions
La syntaxe suivante définit la structure d’un nom de fichier de données correctement formé. Remarque : italics indique un espace réservé de variable qui change en fonction du contenu du fichier.
Syntaxe :
{type d’événement_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 d’un mois d’année.
- Avant de 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 du clic :
code language-none clicks_yyymmdd.gz -
Données de conversion :
code language-none conversions_yyymmdd.gz
Format de contenu des fichiers de données content-format
La syntaxe suivante définit la structure de contenu dans un fichier de données correctement formé. Remarque : italics indique un espace réservé de 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 s’afficher dans l’ordre indiqué 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 de données pour une colonne particulière, renseignez ce champ avec un
-1. -
Les fichiers must se terminent par un numéro de version. La version actuelle est 1.1.
-
Séparez les en-têtes de fichier et le contenu par le caractère non imprimable ASCII 001 . 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 une barre verticale
"|"à des fins d’affichage uniquement.
Étiquettes 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’éléments vendus dans un événement de conversion.
Pour les fichiers de données de conversion uniquement.
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 distribution des fichiers de données delivery-methods
Chargez vos 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 du chemin de diffusion et exemples
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 illustrée ci-dessous. Remarque : italics 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_yyymmdd
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 téléchargement et nom de fichier
Lorsque vous chargez un fichier, le chemin d’accès se présente comme suit :
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Temps et mises à jour de traitement de fichier
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 pour un jour spécifique. Dans ce cas, un jour correspond à la période de 24 heures allant 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 en matière de dénomination et de création de fichiers de métadonnées. Pour commencer, reportez-vous à la section Présentation et mappages des fichiers de métadonnées.