Fichiers de données pour les rapports Audience Optimization et 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 la variable Rapports sur les Audiences Optimization et créer des caractéristiques à l’aide des données via 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 clics ou de conversion dans le Rapports sur les Audiences Optimization. Cela s’avère utile lorsque vous travaillez avec un partenaire qui n’est pas intégré à Audience Manager et vous souhaitez utiliser leurs 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 : italique indique un espace réservé variable qui change en fonction du contenu du fichier.
Syntaxe :
type d'événement_aaaammdd
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’événement
.gzextension de fichier.
Compte tenu de ces exigences, nommez vos fichiers de données en fonction de leur contenu comme suit :
- Données d’impression :
impressions_aaaammdd.gz - Données du clic :
clicks_aaaammdd.gz - Données de conversion :
conversions_aaaammdd.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 : italique indique un espace réservé 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 spécifique, renseignez ce champ avec une
-1. -
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 illustre une 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 format.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 Audience Manager compte . 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 Amazon S3 répertoire . Le chemin d’accès au fichier suit la syntaxe illustrée ci-dessous. Remarque : 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= ID AAM/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 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
Heures et mises à jour de traitement des fichiers
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, voir Présentation et mappages des fichiers de métadonnées.