FTPExigences en matière de nom et de taille de fichier pour les fichiers de données entrants ftp-name-and-file-size-requirements-for-inbound-data-files

Décrit les champs, la syntaxe, les conventions de dénomination et les tailles de fichiers requis à 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 à une Audience Manager. FTP répertoire .

WARNING
Nous supprimons progressivement la prise en charge de FTP configurations. Bien que l’ingestion de fichiers de données entrants soit toujours prise en charge dans les FTP intégrations, il est vivement recommandé d’utiliser Amazon S3 pour intégrer des données hors ligne pour les nouvelles intégrations. Pour plus d’informations, consultez Exigences en matière de nom et de taille de fichier Amazon S3 pour les fichiers de données entrants.
NOTE
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 file-name-syntax

FTP Les 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 connaître les autres formats de nom de fichier acceptés, voir Intégrations personnalisées des partenaires.

NOTE
Audience Manager processus uniquement ASCII et UTF-8 fichiers codés.

Nom Elements

Le tableau définit les éléments d’une FTP nom du fichier.

Elément Nom du fichier
Description
ftp_dpm_
Le chemin d’accès et le nom de votre Audience Manager Répertoire FTP. Contactez votre gestionnaire de compte pour connaître le répertoire FTP et les informations d’identification.
DPID

Un identifiant qui indique Audience Manager si un fichier de données contient vos propres ID utilisateur, Android, iOS ID ou autres ID appartenant à sources de données globales. Accepte les options suivantes :

  • ID de source de données (également appelé ID de fournisseur de données) : Il s’agit d’un identifiant unique attribué par l’Audience Manager à une source de données (voir l’Audience Manager index des identifiants). Utilisez cet identifiant attribué dans un nom de fichier lors de l’envoi de données contenant vos propres identifiants utilisateur. Par exemple : ...ftp_dpm_21_123456789.sync indique Audience Manager pour intégrer des données à des identifiants appartenant à la source de données 21.
  • Identifiants Android (GAID) : Utilisez ID 20914 dans un nom de fichier de données s’il contient des identifiants Android. Vous devez utiliser le champ _DPID_TARGET_DATA_OWNER lorsque vous utilisez des identifiants Android. Par exemple : ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indique Audience Manager que le fichier de données contient uniquement des identifiants Android et que ces identifiants doivent être qualifiés pour les caractéristiques appartenant à la variable _DPID_TARGET_DATA_OWNER source de données.
  • iOS ID (IDFA) : Utilisez l’ID 20915 dans un nom de fichier de données s’il contient des iOS ID. Vous devez utiliser le champ _DPID_TARGET_DATA_OWNER lorsque vous utilisez des iOS ID. Par exemple : ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indique Audience Manager que le fichier de données contient uniquement des iOS ID et que ces ID doivent être qualifiés pour les caractéristiques appartenant à la variable _DPID_TARGET_DATA_OWNER source de données.
  • ID appartenant à d’autres sources de données globales: Vous pouvez intégrer des identifiants Roku pour la publicité (RIDA), des identifiants Microsoft Advertising (MAID) et d’autres identifiants. Utilisez l’identifiant correspondant à chaque source de données, comme décrit dans la section article relatif aux sources de données globales.

Remarque : Ne mélangez pas les types d’ID dans vos fichiers de données. Si, par exemple, votre nom de fichier contient l’identifiant Android, ne placez pas d’iOS ID ni vos propres identifiants dans le fichier de données.

_DPID_TARGET_DATA_OWNER

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 Android ID ou un iOS ID ou un autre ID appartenant à des sources de données globales. Cette variable permet de Audience Manager liez les données de fichier à votre organisation.
Cette source de données cible doit appartenir à votre entreprise. À des fins de partage de données de deuxième niveau, pour ingérer des données dans une source de données cible appartenant à une autre entreprise, vous devez disposer d’un mappage d’accès entre votre entreprise et la source de données cible. Contactez votre conseiller en Adobe ou le service clientèle pour configurer le mappage.

Remarque importante : You ne pas Vous 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 dans lesquelles 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 appartenant à votre PID.

Par exemple :

  • ...ftp_dpm_33_21_1234567890.sync indique à l’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.
  • Identifiants Android (GAID) : ...ftp_dpm_20914_21_1234567890.sync indique Audience Manager que le fichier de données contient uniquement des identifiants Android et que ces identifiants doivent correspondre aux caractéristiques appartenant à la source de données 21.
  • iOS ID (IDFA) : ...ftp_dpm_20915_21_1234567890.sync indique Audience Manager que le fichier de données contient uniquement des iOS ID et que ces 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 identifiants Roku et que ceux-ci doivent correspondre aux caractéristiques appartenant à la source de données 21. Utilisez l’identifiant correspondant à chaque source de données, comme décrit dans la section article relatif aux sources de données globales.
(.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és ou supprimés dans le système d’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 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. Les caractéristiques qui ne sont pas affectées à la source de données cible ne seront pas effacées.
[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 optimiser le traitement des fichiers, divisez vos fichiers de données comme indiqué :

  • Décompressé : 1 Go
  • Compressé : 200 à 300 Mo

Voir les 2 premières exemples de nom de fichier ci-dessous.

TIMESTAMP
Horodatage UTC UNIX à 10 chiffres en secondes. L’horodatage permet de rendre chaque nom de fichier unique.
[.gz]

Gzip est le format de compression autorisé pour un nom de fichier FTP. Si vous utilisez la compression de fichier, assurez-vous que le nom de fichier possède l’extension appropriée.

Les fichiers compressés doivent être de 3 Go ou moins. Si vos fichiers sont plus volumineux, contactez l’assistance 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 à optimiser les transferts de données. Voir Compression de fichiers pour les fichiers de transfert de données entrants .

Exemples de noms de fichier file-name-examples

Les exemples suivants présentent des noms de fichier correctement formatés. Vos noms de fichier peuvent ressembler à ceux-ci.

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

Télécharger le fichier d’exemple si vous avez besoin d’exemples supplémentaires. Ce fichier est enregistré avec le .overwrite extension de fichier. Ouvrez-le à l’aide d’un simple éditeur de texte.

Tailles de fichiers acceptées accepted-file-sizes

Tenez compte des chiffres ci-dessous pour le traitement le plus rapide/le plus ancien de vos fichiers ainsi que pour les limites de taille de fichier lorsque vous envoyez des données à un Audience Manager / FTP répertoire .

Type de fichier
Taille optimale
Taille maximale
Compressé
200 à 300 Mo
3 Go
Décompressé
1 Go
5 Go
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695