FTPExigences 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 à 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 à un répertoire d'Audience Manager FTP.

AVERTISSEMENT

Nous supprimons progressivement la prise en charge des configurations FTP. Bien que l'assimilation de fichiers de données entrants soit toujours prise en charge dans les intégrations FTP existantes, nous vous recommandons vivement 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.

REMARQUE

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

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 de partenaire personnalisées.

REMARQUE

Audience Manager traite uniquement ASCII et UTF-8 les fichiers codés.

Nommer les éléments

Le tableau définit les éléments dans un nom de fichier FTP.

Elément Nom de fichier Description

ftp_dpm_

Chemin d’accès et nom de votre répertoire FTP Audience Manager. 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, ID Android, ID iOS ou autres ID appartenant à les sources de données globales . Accepte les options suivantes :

  • ID de source de données (également appelé ID du fournisseur de données) : Il s’agit d’un identifiant unique attribué par l’Audience Manager à une source de données (reportez-vous à l’ index d’Audience Manager des ID ). 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 des données embarquées à des ID 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 ID 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 correspondre aux caractéristiques appartenant à la source de données _DPID_TARGET_DATA_OWNER.
  • ID iOS (IDFA) : utilisez ID 20915 dans un nom de fichier de données s’il contient des ID iOS. Vous devez utiliser le champ _DPID_TARGET_DATA_OWNER lorsque vous utilisez des ID iOS. Par exemple, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indique à Audience Manager que le fichier de données contient uniquement des ID iOS et que ces identifiants doivent correspondre aux caractéristiques de la source de données _DPID_TARGET_DATA_OWNER.
  • ID appartenant à d’autres sources de données globales : Vous pouvez embarquer 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 l’article 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 contient l’identifiant Android, n’insérez pas d’ID iOS ou vos propres ID 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 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 :

  • ...ftp_dpm_33_21_1234567890.sync indique à l’Audience Manager que vous définissez des ID de client appartenant à la source de données 33 pour les caractéristiques ou les 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 de la source de données 21.
  • Identifiants iOS (IDFA) : ...ftp_dpm_20915_21_1234567890.sync indique à Audience Manager que le fichier de données contient uniquement des identifiants iOS et que ces identifiants doivent correspondre aux caractéristiques de 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 ces identifiants doivent être inclus dans 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 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ées ou supprimées 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 en 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 attribuées à la source de données de 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 un traitement efficace des fichiers, fractionnez vos fichiers de données comme indiqué :

  • Non compressé : 1 Go
  • Comprimé : 200 à 300 Mo

Voir les 2 premiers exemples de noms 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 le service d’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 à 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.

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

[Téléchargez ] (assets/ftp_dpm_1234_1445374061.overwrite) le fichier d’exemple si vous avez besoin d’exemples supplémentaires. Ce fichier est enregistré avec l'extension de fichier .overwrite. 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 limites de taille de fichier lorsque vous envoyez des données dans un répertoire Audience Manager / FTP.

Type de fichier Taille optimale Taille maximale
Compressé

200 à 300 Mo

3 Go

Non compressé

1 Go

5 Go

Sur cette page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now