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.

Étiquette Description

Horodatage

Date et heure UTC pour le événement d’impression, de clic ou de conversion. Utilisez le format yyyy-MM-dd HH:mm:ss.

User-ID

Votre identifiant pour un visiteur de site, également appelé identifiant utilisateur unique du fournisseur de données ou DPUUID.

Advertiser-ID

ID de source de données ou code d’intégration pour votre annonceur.

BU-ID

ID de l'unité opérationnelle.

Campaign-ID

ID de campagne.

Creative-ID

ID d’élément créatif.

ID du site

ID du site.

Emplacement-ID

Identifiant de placement numérique du serveur d’annonces.

Insertion-Ordre-ID

ID d’ordre d’insertion.

ID tactique

ID tactique.

ID vertical

ID d’une catégorie ou d’un secteur industriel vertical.

Quantité

Nombre d’éléments vendus dans un événement de conversion.

Pour les fichiers de données de conversion uniquement.

Recettes

Achat ou autre montant de conversion. Type de données : Flottant.

Pour les fichiers de données de conversion uniquement.

Autres données

URL du landing page de conversion. Type de données : chaîne.

Pour les fichiers de données de conversion uniquement.

Événement-Type

Type de conversion. Indique si une conversion correspond ou non. Les options incluent :

  • 0: Impression
  • 1: Cliquez sur
  • -1: Non attribué ou inconnu

Pour les fichiers de données de conversion uniquement.

Version

Numéro de version requis qui apparaît à la fin de chaque ligne dans un fichier de données d’impression, de clic ou de conversion. La version actuelle est 1.1.

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.

IMPORTANT

Contactez votre conseiller en Audience Manager ou le service d’assistance clientèle pour commencer et configurer un répertoire Amazon S3 pour vos fichiers de données.

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

Le tableau suivant définit chacun de ces éléments dans un chemin de diffusion de fichiers.

Paramètre de fichier Description

.../log_ingestion/

Début du chemin d'enregistrement de l'annuaire. Vous recevrez le chemin complet lorsque tout sera configuré.

pid=AAM ID

Cette paire clé-valeur contient votre Audience Manager identifiant client.

dpid=d_src

Cette paire clé-valeur contient l’identifiant de source de données transmis lors d’un appel de événement. Il identifie l'organisme d'où proviennent les données et les lie à un fichier de métadonnées.

logs

Répertoire de niveau supérieur pour les fichiers de données.

file type_yyyymmdd

Nom de type de fichier qui indique le type de données qu’il contient et un horodatage de diffusion.

Exemple de chemin de téléchargement et de nom de fichier

Lorsque vous téléchargez un fichier, le chemin d’accès se présente comme suit :

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Heures 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 qui contient toutes les impressions, les clics ou les conversions pour un jour donné. Dans ce cas, un jour correspond à la période de 24 heures allant d’un minuit à l’autre. Il est recommandé d’utiliser l’heure UTC pour définir l’intervalle de jour.

Étapes suivantes

Examinez les exigences relatives au nommage et à la création de fichiers de métadonnées. Pour commencer, voir Aperçu et mappages pour les fichiers de métadonnées.

Sur cette page