Fichiers de données pour les rapports Audience Optimization et fichiers journaux pratiques

Un fichier de données contient des données d’impression, de clic ou de conversion. Une fois formatées correctement, vous pouvez importer ces données dans l'Audience Manager pour les vue dans les rapports d'Audience Optimization et créer des caractéristiques à l'aide des données par l'intermédiaire de Fichiers journaux utilisables. Mettez en forme vos fichiers de données selon ces spécifications dans cette section.

Présentation

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 relatives au fichier de données et aux étiquettes lisibles dans les menus du rapport. Pour plus d’informations, voir Aperçu et mappages pour les fichiers de métadonnées.

Conventions d'appellation des fichiers de données

La syntaxe suivante définit la structure d’un nom de fichier de données bien formé. Remarque : italics indique un espace réservé de variable qui change en fonction du contenu du fichier.

Syntaxe :

type d'événement_yyyyymmdd

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 et l’horodatage de l’année du mois.
• Avant de télécharger, compressez vos fichiers à l’aide de gzip et enregistrez-les avec l’extension de fichier .gz.

Pour ces raisons, nommez vos fichiers de données en fonction de leur contenu comme suit :

• Données d’impression :

  impressions_yyyymmdd.gz

• Données du clic :

  clicks_yyyymmdd.gz

• Données de conversion :

  conversions_yyyymmdd.gz

Format de contenu pour les fichiers de données

La syntaxe suivante définit la structure de contenu dans un fichier de données bien 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 doivent se terminer par un numéro de version. La version actuelle est 1.1.

• Séparez les en-têtes de fichier et le contenu avec le caractère ASCII 001 non imprimé. 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.

Libellés des champs

Le tableau ci-dessous liste 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 selon l’ordre indiqué dans le tableau. Tous les types de données sont des entiers (INT), sauf indication contraire.

Méthodes de diffusion pour les fichiers de données

Transférez vos fichiers de données d’impression, de clic ou de conversion vers un répertoire Amazon S3 pour votre compte Audience Manager. Reportez-vous à cette section pour obtenir des informations sur les chemins d’accès aux diffusions/répertoires, les délais 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 nommage 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_inged/pid= AAM ID/dpid= d_src/logs/ type de fichier_yyyymmdd