Exigences relatives au nom et à la taille de fichier FTP pour les fichiers de données entrants ftp-name-and-file-size-requirements-for-inbound-data-files
Décrit les champs obligatoires, la syntaxe, les conventions de nommage et les tailles de fichier que vous devez suivre lors de l’envoi de données à Audience Manager. Définissez les noms et tailles de vos fichiers en fonction de ces spécifications lorsque vous envoyez des données à un répertoire FTP Audience Manager.
monospaced text
, italique, crochets [ ]
( )
, etc.) de ce document indiquent 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 file-name-syntax
FTP noms de fichier contiennent les éléments obligatoires et facultatifs suivants :
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Pour les autres formats de nom de fichier acceptés, voir Intégrations de partenaires personnalisées.
Nommer les éléments
Le tableau définit les éléments dans un nom de fichier FTP.
ftp_dpm_
DPID
Un identifiant qui indique Audience Manager si un fichier de données contient vos propres identifiants d’utilisateur, Android ID, iOS ID ou d’autres identifiants appartenant à sources de données globales. Accepte les options suivantes :
- Identifiant du Source de données (également appelé identifiant du fournisseur de données) : il s’agit d’un identifiant unique qu’Audience Manager attribue à une source de données (consultez la Index des identifiants Audience Manager). 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 Audience Manager d’intégrer des données aux identifiants appartenant à la source de données 21. - Android IDs (GAID) : utilisez l’ID 20914 dans un nom de fichier de données s’il contient des Android ID. Vous devez utiliser le
_DPID_TARGET_DATA_OWNER
de champs lorsque vous utilisez les Android ID. Par exemple,...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync
indique Audience Manager que le fichier de données contient uniquement les Android ID et que les ID doivent être qualifiés pour les caractéristiques appartenant à la source de données_DPID_TARGET_DATA_OWNER
. - iOS IDs (IDFA) : utilisez ID 20915 dans un nom de fichier de données s’il contient des iOS IDs. Vous devez utiliser le
_DPID_TARGET_DATA_OWNER
de champs lorsque vous utilisez les iOS ID. Par exemple,...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync
indique Audience Manager que le fichier de données contient uniquement les iOS ID et que les ID doivent être qualifiés pour les caractéristiques appartenant à la source de données_DPID_TARGET_DATA_OWNER
. - ID appartenant à d’autres sources de données globales : vous pouvez intégrer des ID Roku pour Advertising (RIDA), des ID Microsoft Advertising (MAID) et d’autres ID. Utilisez l’identifiant correspondant à chaque source de données, comme décrit dans l’article les sources de données globales.
Remarque : ne mélangez pas les types d’ID dans vos fichiers de données. Par exemple, si votre nom de fichier comprend l’identifiant Android, ne placez pas d’iOS ID ou vos propres ID dans le fichier de données.
_DPID_TARGET_DATA_OWNER
Ce champ indique à Audience Manager la source de données à laquelle intégrer des données. Ce champ est obligatoire si vous définissez le DPID sur un Android ID ou un iOS ID ou un autre ID appartenant aux sources de données globales. Cela permet à Audience Manager de lier les données du fichier à votre organisation.
Cette source de données cible doit appartenir à votre société. À des fins de partage de données tierces, pour ingérer des données dans une source de données cible appartenant à une autre société, vous devez disposer d’un mappage d’accès entre votre société et la source de données cible. Contactez votre consultant Adobe ou le service clientèle afin de configurer le mappage.
Remarque importante : vous pas devez demander un mappage pour les relations de partage de données existantes (pour les sources de données cibles appartenant à d’autres sociétés auxquelles vous avez intégré des données avant le 14 mars 2022). Le mappage n’est pas non plus requis lors de l’intégration de données dans des sources de données cibles qui appartiennent à votre PID.
Par exemple :
...ftp_dpm_33_21_1234567890.sync
indique à Audience Manager que vous qualifiez des ID de client appartenant à la source de données 33 pour des caractéristiques ou des signaux appartenant à la source de données 21.- Android IDs (GAID) :
...ftp_dpm_20914_21_1234567890.sync
indique à Audience Manager que le fichier de données contient uniquement des Android ID et que les ID doivent être qualifiés pour les caractéristiques appartenant à la source de données 21. - iOS IDs (IDFA) :
...ftp_dpm_20915_21_1234567890.sync
indique à Audience Manager que le fichier de données contient uniquement des iOS ID et que les ID doivent être qualifiés pour les caractéristiques appartenant à la source de données 21. - ID appartenant à d’autres sources de données globales :
...ftp_dpm_121963_21_1234567890.sync
indique à Audience Manager que le fichier de données contient uniquement des ID Roku et que les ID doivent être qualifiés pour les caractéristiques appartenant à la source de données 21. Utilisez l’identifiant correspondant à chaque source de données, comme décrit dans l’article les sources de données globales.
(.sync |.overwrite)
Options de synchronisation qui incluent :
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 Audience Manager.overwrite
: permet aux clients et aux fournisseurs de données d’envoyer une liste de caractéristiques par utilisateur, qui doit remplacer toutes les caractéristiques existantes de cet utilisateur pour une source de données donnée dans Audience Manager. Il n’est pas nécessaire d’inclure tous les utilisateurs dans un fichier de remplacement. Incluez uniquement les utilisateurs que vous souhaitez modifier. Les caractéristiques qui ne sont pas affectées à la source de données cible ne seront pas effacées.
[SPLIT_NUMBER]
Nombre entier. Utilisé lorsque vous divisez des fichiers volumineux en plusieurs parties afin d’améliorer les temps de traitement. Le nombre indique la partie du fichier original 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.
TIMESTAMP
[.gz]
Gzip est le format de compression autorisé pour un nom de fichier FTP. Si vous utilisez la compression de fichiers, assurez-vous que le nom du fichier possède l’extension appropriée.
Les fichiers compressés doivent faire 3 Go ou moins. Si vos fichiers sont plus volumineux, contactez l’assistance clientèle. Bien qu’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 file-name-examples
Les exemples suivants affichent les noms de fichiers correctement formatés. Vos noms de fichier peuvent ressembler.
ftp_dpm_478_1366545717.sync.1.gz
ftp_dpm_478_1366545717.sync.2.gz
ftp_dpm_478_1366545717.overwrite
Télécharger l’exemple de fichier si vous avez besoin d’exemples supplémentaires. Ce fichier est enregistré avec l’extension de fichier .overwrite
. Ouvrez-le à l’aide d’un simple éditeur de texte.
Tailles de fichier acceptées accepted-file-sizes
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 répertoire Audience Manager/FTP.