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.
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.
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 :
.gz
.Pour ces raisons, nommez vos fichiers de données en fonction de leur contenu comme suit :
impressions_yyyymmdd.gz
clicks_yyyymmdd.gz
conversions_yyyymmdd.gz
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 |
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 :
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. |
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.
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 |
---|---|
|
Début du chemin d'enregistrement de l'annuaire. Vous recevrez le chemin complet lorsque tout sera configuré. |
|
Cette paire clé-valeur contient votre Audience Manager identifiant client. |
|
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. |
|
Répertoire de niveau supérieur pour les fichiers de données. |
|
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.
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.