Show Menu
SUJETS×

Amazon S3Exigences en matière de nom et de taille de fichier pour les fichiers de données entrants

Décrit les champs obligatoires, la syntaxe, les conventions d’affectation de nom et les tailles de fichiers que vous devez respecter lors de l’envoi de données à Audience Manager. Définissez les noms et tailles de vos fichiers selon ces spécifications lorsque vous envoyez des données vers un Audience Manager / Amazon S3 répertoire.
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 .

Syntaxe du nom de fichier

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é.
Audience Manager uniquement les processus ASCII et les fichiers UTF-8 codés.

Nommer les éléments

Le tableau définit les éléments d’un nom de S3 fichier.
Elément Nom Description
AWS_directory
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.
date= yyyy-mm-dd
Horodatage (basé sur l’heure UTC) du moment où vous envoyez les fichiers à votre compartiment S3.
DPID
L’ID de fournisseur de données (DPID) est un identifiant qui indique à l’Audience Manager si un fichier de données contient vos propres ID d’utilisateur, Android ou iOS. Accepte les options suivantes :
ID de partenaire de données
Il s’agit d’une Audience Manager d’ID unique attribuée à votre société ou organisation. Utilisez cet ID affecté dans un nom de fichier lors de l’envoi de données contenant vos propres ID utilisateur. Par exemple, ...ftp_dpm_21_123456789.sync indique à l’Audience Manager qu’un partenaire doté de l’ID 21 a envoyé le fichier et qu’il contient les ID utilisateur attribués par ce partenaire.
Identifiants Android (GAID)
Utilisez ID 20914 comme DPID dans un nom de fichier de données si le fichier contient des ID Android. Lorsque vous utilisez ID 20914 comme DPID, vous devez toujours identifier votre société à l’Audience Manager . Cela signifie que le nom de fichier doit utiliser le _DPID_TARGET_DATA_OWNER paramètre pour conserver votre ID de société. Supposons, par exemple, que vous transfériez des fichiers avec des ID Android et que votre ID de fournisseur de données soit 21. Dans ce cas, le nom de fichier ressemble à ...ftp_dpm_20914_21_123456789.sync . Cela indique à l’Audience Manager que le fichier contient des ID Android et provient d’un partenaire identifié par l’ID 21.
ID iOS (IDFA)
Utilisez ID 20915 comme DPID dans un nom de fichier de données si le fichier contient des ID iOS. Lorsque vous utilisez ID 20915 comme DPID, vous devez toujours identifier votre société à l’Audience Manager . Cela signifie que le nom de fichier doit utiliser le _DPID_TARGET_DATA_OWNER paramètre pour conserver votre ID de société. Supposons, par exemple, que vous transfériez des fichiers avec des ID Android et que votre ID de fournisseur de données soit 21. Dans ce cas, le nom de fichier ressemble à ...ftp_dpm_20915_21_123456789.sync . Cela indique à l’Audience Manager que le fichier contient des ID iOS et provient d’un partenaire identifié par l’ID 21.
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.
Consultez les sources de données globales pour en savoir plus.
Voir aussi l' _DPID_TARGET_DATA_OWNER entrée ci-dessous.
_DPID_TARGET_DATA_OWNER
Espace réservé pour un identifiant. Par exemple, vous pouvez définir l’ID d’ Audience Manager si vous définissez le DPID sur un ID de source de données ou un ID Android ou iOS. Cela permet à l’Audience Manager de lier les données de fichier à votre entreprise.
Par exemple :
  • ...ftp_dpm_33_21_1234567890.sync La montre un partenaire avec l'ID 21 a envoyé des données d'une source de données qui utilise l'ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync La montre un partenaire avec l'ID 21 a envoyé des données qui contiennent des ID Android.
  • ...ftp_dpm_20915_21_1234567890.sync La montre un partenaire doté de l'ID 21 a envoyé des données contenant des ID iOS.
partner_name
Nom de la société ou de l’organisation que vous utilisez dans l’Audience Manager .
TIMESTAMP
Horodatage UTC UNIX à 10 chiffres en secondes. L’horodatage permet de rendre chaque nom de fichier unique.
(.sync|.overwrite)
Options de synchronisation comprenant :
  • sync : Scénario normal lorsque des fournisseurs de données tiers envoient des caractéristiques par utilisateur pour être ajoutées ou supprimées dans le système d’Audience Manager.
  • overwrite : Permet aux fournisseurs de données d’envoyer une liste de caractéristiques par utilisateur qui doit remplacer toutes les caractéristiques tierces existantes de cet utilisateur pour ce fournisseur de données dans l’Audience Manager. Vous n’avez pas besoin d’inclure tous vos utilisateurs dans un fichier de remplacement. Incluez uniquement les utilisateurs que vous souhaitez modifier.
[ SPLIT_NUMBER ]
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é :
  • Non compressé : 1 Go
  • Comprimé : 200 à 300 Mo
Consultez les 2 premiers exemples de noms de fichier ci-dessous.
[.gz]
Lors de l’envoi de fichiers vers Amazon S3, utilisez la compression gzip uniquement. Une fois compressés, ces fichiers obtiennent l’ .gz extension. N’utilisez pas la compression .zip.
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 .

Exemples de noms de fichier

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 l’exemple de fichier si vous souhaitez d’autres exemples. Ce fichier a été enregistré avec l'extension de .overwrite fichier. Ouvrez-le dans un éditeur de texte simple.

Taille de fichier acceptée

Tenez compte des chiffres ci-dessous pour le traitement le plus rapide/le plus précoce de vos fichiers ainsi que pour les limitations de taille de fichier lorsque vous envoyez des données à un Audience Manager / Amazon S3 répertoire.
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.