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. 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 Fichiers journaux pratiques. Mettez en forme vos fichiers de données conformément à 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 clics 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

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

Syntaxe :

type d’événement_aaammjj

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 :
    impressions_aaammjj.gz
  • Données du clic :
    clicks_yyyymmdd.gz
  • Données de conversion :
    conversions_aaaammdd.gz

Format de contenu des fichiers de données

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 2libellé 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 une balise -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 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.

Étiquette Description

Horodatage

Date et heure UTC de l’é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 du site, également appelé identifiant utilisateur unique du fournisseur de données ou DPUUID.

Advertiser-ID

L’identifiant de source de données ou le code d’intégration de votre annonceur.

BU-ID

Identifiant de l’unité opérationnelle.

Campaign-ID

ID de campagne.

Creative ID

ID d’élément créatif.

ID du site

ID du site.

Placement-ID

Identifiant d’emplacement numérique du serveur de publicités.

Insertion-Order-ID

Identifiant de l’ordre d’insertion.

ID tactique

ID tactique.

Identifiant vertical

Identifiant pour un secteur industriel vertical ou une catégorie.

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 de la landing page de conversion. Type de données : chaîne.

Pour les fichiers de données de conversion uniquement.

Event-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 distribution des fichiers de données

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.

IMPORTANT

Contactez votre conseiller en Audience Manager ou l’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 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_aaaaammdd

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

Paramètre de fichier Description

.../log_ingestion/

Il s’agit du début du chemin de stockage du répertoire. Vous recevrez le chemin complet lorsque tout sera configuré.

pid=AAM ID

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

dpid=d_src

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

logs

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

file type_yyyymmdd

Un 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 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

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 pour les fichiers de métadonnées.

Sur cette page