Décrit les champs obligatoires, la syntaxe, les conventions d’affectation de nom et les tailles de fichiers à respecter lors de l’envoi de données à Audience Manager. Définissez les noms et les tailles de vos fichiers en fonction de ces spécifications lorsque vous envoyez des données dans un répertoire Audience Manager / Amazon S3.
Les styles de texte (monospaced text
, italiques, crochets [ ]
( )
, etc.) dans ce document, indiquez les éléments de code et les options. Pour plus d’informations, voir les conventions de style relatives aux éléments de code et de texte.
S3 les noms de fichier contiennent les éléments obligatoires et facultatifs suivants :
S3préfixe : s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
Eléments de nom de fichier : ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Pour connaître les autres formats de nom de fichier acceptés, voir Intégrations de partenaire personnalisées.
Audience Manager traite uniquement ASCII et UTF-8 les fichiers codés.
Le tableau définit les éléments dans un nom de fichier S3.
Elément Nom | Description |
---|---|
|
Chemin d’accès et nom du compartiment Amazon S3. Contactez votre gestionnaire de compte pour connaître le nom, le chemin et les informations d’identification de votre répertoire S3. |
|
Horodatage (basé sur l’heure UTC) du moment où vous envoyez les fichiers à votre compartiment S3. |
|
Un identifiant qui indique à Audience Manager si un fichier de données contient vos propres ID utilisateur, ID Android, ID iOS ou autres ID appartenant à les sources de données globales . Accepte les options suivantes :
Remarque : Ne mélangez pas les types d’ID dans vos fichiers de données. Par exemple, si votre nom de fichier contient l’identifiant Android, n’insérez pas d’ID iOS ou vos propres ID dans le fichier de données. |
|
Ce champ indique à l’Audience Manager à quelle source de données intégrer les données. Ce champ est obligatoire si vous définissez le DPID sur un ID Android, un ID iOS ou un autre ID appartenant à des sources de données globales. Cela permet à Audience Manager de lier les données de fichier à votre organisation. Par exemple :
|
|
Nom de la société ou de l'organisation que vous utilisez dans Audience Manager. |
|
Horodatage UTC UNIX à 10 chiffres en secondes. L’horodatage permet de rendre chaque nom de fichier unique. |
|
Options de synchronisation comprenant :
|
|
Entier. Utilisé lorsque vous divisez des fichiers volumineux en plusieurs parties afin d’améliorer les temps de traitement. Le numéro indique la partie du fichier d'origine que vous envoyez. Pour un traitement efficace des fichiers, fractionnez vos fichiers de données comme indiqué :
|
|
Lors de l’envoi de fichiers vers Amazon S3, utilisez la compression gzip uniquement. Une fois compressés, ces fichiers obtiennent l'extension Les fichiers compressés doivent être de 3 Go ou moins. Si vos fichiers sont plus volumineux, contactez le service à la clientèle. Bien que l'Audience Manager puisse gérer des fichiers volumineux, nous pouvons vous aider à réduire la taille de vos fichiers et à rendre les transferts de données plus efficaces. Voir Compression de fichiers pour les fichiers de transfert de données entrants. |
Les exemples suivants montrent des noms de fichier correctement formatés. Vos noms de fichier peuvent ressembler.
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Vous pouvez [télécharger] (assets/ftp_dpm_1234_1445374061.overwrite) le fichier exemple si vous souhaitez d’autres exemples. Ce fichier a été enregistré avec l'extension de fichier .overwrite
. Ouvrez-le dans un éditeur de texte simple.
Tenez compte des chiffres ci-dessous pour le traitement le plus rapide/le plus précoce de vos fichiers ainsi que pour les limites de taille de fichier lorsque vous envoyez des données dans un répertoire Audience Manager / Amazon S3.
Type de fichier | Taille optimale | Taille maximale |
---|---|---|
Compressé | 200 à 300 Mo |
3 Go |
Non compressé | 1 Go |
5 Go |
Le processus de validation des données entrantes marquera les fichiers vides comme non valides et ne les traitera pas.
Les fichiers de données entrants ont une longueur de ligne limitée à 10 2400 octets. Les lignes dépassant cette limite sont exclues du transfert.