DocumentationExperience PlatformGuide des destinations

Configuration par lots batch-configuration

Dernière mise à jour : 16 septembre 2026

Créé pour :

  • Utilisateur/utilisatrice
  • Administrateur ou administratrice

Utilisez les options de configuration par lots de la section Destination SDK pour permettre aux utilisateurs de personnaliser les noms des fichiers exportés et de configurer le planning d’exportation en fonction de leurs préférences.

Lorsque vous créez des destinations basées sur des fichiers via Destination SDK, vous pouvez configurer les noms de fichiers et les plannings d’exportation par défaut, ou permettre aux utilisateurs de configurer ces paramètres à partir de l’interface utilisateur de Experience Platform. Par exemple, vous pouvez configurer des comportements tels que :

  • Insérez des informations spécifiques dans le nom du fichier, telles que des identifiants d’audience, des identifiants de destination ou des informations personnalisées.
  • Permet aux utilisateurs de personnaliser le nom des fichiers à partir de l’interface utilisateur Experience Platform.
  • Configurer des exportations de fichiers à des intervalles de temps définis.
  • Définissez les options de dénomination de fichiers et de planning d’exportation que les utilisateurs peuvent voir dans l’interface utilisateur de Experience Platform.

Les paramètres de configuration par lots font partie de la configuration de destination pour les destinations basées sur des fichiers.

Pour comprendre la place de ce composant dans une intégration créée avec Destination SDK, consultez le diagramme de la documentation options de configuration ou consultez le guide sur la utilisation de Destination SDK pour configurer une destination basée sur des fichiers.

Vous pouvez configurer les noms de fichiers et les paramètres du planning d’exportation via le point d’entrée /authoring/destinations. Pour obtenir des exemples d’appels API détaillés dans lesquels vous pouvez configurer les composants affichés sur cette page, consultez les pages de référence de l’API suivantes.

Cet article décrit toutes les options de configuration par lots prises en charge que vous pouvez utiliser pour la destination et montre ce que la clientèle verra dans l’interface utilisateur d’Experience Platform.

IMPORTANT
Tous les noms et toutes les valeurs de paramètre pris en charge par Destination SDK sont sensibles à la casse. Pour éviter les erreurs de respect de la casse, utilisez les noms et valeurs des paramètres exactement comme indiqué dans la documentation.

Types d’intégration pris en charge supported-integration-types

Pour en savoir plus sur les types d’intégration qui prennent en charge les fonctionnalités décrites sur cette page, consultez le tableau ci-dessous.

Type d’intégration
Fonctionnalité de prise en charge
Intégrations en temps réel (streaming)
Non
Intégrations basées sur des fichiers (par lots)
Oui

batchConfig ou datasetBatchConfig batchconfig-vs-datasetbatchconfig

Cette page décrit deux objets de configuration associés, mais distincts :

  • batchConfig : contrôle la dénomination des fichiers et les paramètres du planning d’exportation pour les destinations qui exportent des audiences audiences (audiences de personnes, de comptes ou de prospects).
  • datasetBatchConfig : objet imbriqué dans batchConfig qui contrôle les noms de dossier et les paramètres de planning d’exportation spécifiquement pour les destinations qui exportent des jeux de données. Utilisez cette option lorsque la destination prend en charge les exportations de jeux de données (c’est-à-dire lorsque la "sources": ["DATASETS"] est définie dans la configuration de destination).

Paramètres pris en charge supported-parameters

Les valeurs que vous configurez ici sont affichées à l’étape Planifier l’exportation d’audiences du workflow d’activation des destinations basées sur des fichiers.

"batchConfig":{
   "allowMandatoryFieldSelection":true,
   "allowDedupeKeyFieldSelection":true,
   "defaultExportMode":"DAILY_FULL_EXPORT",
   "allowedExportModes":[
      "DAILY_FULL_EXPORT",
      "FIRST_FULL_THEN_INCREMENTAL"
   ],
   "allowedScheduleFrequency":[
      "DAILY",
      "EVERY_3_HOURS",
      "EVERY_6_HOURS",
      "EVERY_8_HOURS",
      "EVERY_12_HOURS",
      "ONCE",
      "WEEKLY",
      "MONTHLY"
   ],
   "defaultFrequency":"DAILY",
   "defaultStartTime":"00:00",
   "filenameConfig":{
         "allowedFilenameAppendOptions":[
            "SEGMENT_NAME",
            "DESTINATION_INSTANCE_ID",
            "DESTINATION_INSTANCE_NAME",
            "ORGANIZATION_NAME",
            "SANDBOX_NAME",
            "DATETIME",
            "CUSTOM_TEXT"
         ],
         "defaultFilenameAppendOptions":[
            "DATETIME"
         ],
         "defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
      },
   "segmentGroupingEnabled": true
   }
Paramètre
Type
Description
allowMandatoryFieldSelection
Booléen
Définissez cette valeur sur true afin de permettre la spécification des attributs de profil obligatoires. La valeur par défaut est false. Pour plus d’informations, consultez la section Attributs obligatoires.
allowDedupeKeyFieldSelection
Booléen
Définissez cette valeur sur true afin de permettre la spécification des clés de déduplication. La valeur par défaut est false. Pour plus d’informations, consultez la section Clés de déduplication.
defaultExportMode
Énumération

Définit le mode d’exportation de fichier par défaut. Valeurs prises en charge :

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL

La valeur par défaut est DAILY_FULL_EXPORT. Pour plus d’informations sur la planification des exportations de fichiers, consultez la documentation sur l’activation par lots.

allowedExportModes
Liste

Définit les modes d’exportation de fichiers disponibles pour les clients. Valeurs prises en charge :

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency
Liste

Définit la fréquence d’exportation des fichiers disponible pour les clients. Valeurs prises en charge :

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
  • WEEKLY
  • MONTHLY
defaultFrequency
Enum

Définit la fréquence d’exportation du fichier par défaut.Valeurs prises en charge :

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
  • WEEKLY
  • MONTHLY

La valeur par défaut est DAILY.

defaultStartTime
Chaîne
Définit l’heure de début par défaut de l’exportation du fichier. Utilise le format d’heure sur 24 heures. La valeur par défaut est « 00:00 ».
filenameConfig.allowedFilenameAppendOptions
Chaîne

Obligatoire. Liste des macros de nom de fichier disponibles. Cela détermine les éléments qui sont ajoutés aux noms de fichier exportés (identifiant d’audience, nom de l’organisation, date et heure de l’exportation, etc.). Quand vous définissez defaultFilename, veillez à ne pas dupliquer les macros.

Valeurs prises en charge :

  • DESTINATION
  • SEGMENT_ID
  • SEGMENT_NAME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT

Quel que soit l’ordre dans lequel vous définissez les macros, l’interface utilisateur d’Experience Platform les affiche toujours dans l’ordre présenté ici.

Si defaultFilename est vide, la liste allowedFilenameAppendOptions doit contenir au moins une macro.

filenameConfig.defaultFilenameAppendOptions
Chaîne
Obligatoire. Macros de nom de fichier par défaut présélectionnées que les utilisateurs peuvent décocher.

Les macros de cette liste sont un sous-ensemble de celles définies dans allowedFilenameAppendOptions.
filenameConfig.defaultFilename
Chaîne
Facultatif. Définit les macros de nom de fichier par défaut pour les fichiers exportés. Elles ne peuvent pas être modifiées par les utilisateurs.

Toute macro définie par allowedFilenameAppendOptions sera ajoutée après les macros defaultFilename.

Si defaultFilename est vide, vous devez définir au moins une macro dans allowedFilenameAppendOptions.
segmentGroupingEnabled
Booléen

Définit si les audiences activées doivent être exportées dans un ou plusieurs fichiers, selon la politique de fusion des audiences. Valeurs prises en charge :

  • true : exporte un fichier par politique de fusion.
  • false : exporte un fichier par audience, quelle que soit la politique de fusion. Il s’agit du comportement par défaut. Vous pouvez obtenir le même résultat en omettant complètement ce paramètre.

Configuration du nom du fichier file-name-configuration

Utilisez les macros de configuration des noms de fichiers pour définir les noms de fichiers exportés à inclure. Les macros du tableau ci-dessous décrivent les éléments figurant dans l’interface utilisateur de l’écran configuration du nom du fichier.

TIP
En règle générale, vous devez toujours inclure la macro SEGMENT_ID dans les noms de fichiers exportés. Les identifiants de segment sont uniques. Ainsi, la meilleure manière de s’assurer que les noms de fichiers sont également uniques est de les inclure dans le nom du fichier.
Macro
Libellé de l’interface utilisateur
Description
Exemple
DESTINATION
Destination
Nom de la destination dans l’interface utilisateur.
Amazon S3
SEGMENT_ID
Identifiant du segment
ID d’audience unique généré par Experience Platform
ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME
Nom du segment
Nom d’audience défini par l’utilisateur ou l’utilisatrice
abonné VIP
DESTINATION_INSTANCE_ID
Identifiant de destination
Identifiant unique de l’instance de destination, généré par Experience Platform
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
Nom de la destination
Nom défini par l’utilisateur de l’instance de destination.
Ma destination publicitaire 2022
ORGANIZATION_NAME
Nom de l’organisation
Nom de l’organisation du client en Adobe Experience Platform.
Mon nom d’organisation
SANDBOX_NAME
Nom du sandbox
Nom du sandbox utilisé par le client.
prod
DATETIME / TIMESTAMP
Date et heure

DATETIME et TIMESTAMP définissent tous deux le moment où le fichier a été généré, mais dans des formats différents.

  • DATETIME utilise le format suivant : AAAAMMJJ_HHMMSS.
  • TIMESTAMP utilise le format Unix à 10 chiffres.

DATETIME et TIMESTAMP s’excluent mutuellement et ne peuvent pas être utilisés simultanément.

  • DATETIME : 20220509_210543
  • TIMESTAMP : 1652131584
CUSTOM_TEXT
​ Texte personnalisé ​
Texte personnalisé défini par l’utilisateur à inclure dans le nom du fichier. Ne peut pas être utilisé dans defaultFilename.
My_Custom_Text
TIMESTAMP
Date et heure
Date et heure à 10 chiffres indiquant l’heure à laquelle le fichier a été généré, au format Unix.
1652131584
MERGE_POLICY_ID
ID de la politique de fusion
Identifiant de la politique de fusion utilisé pour générer l’audience exportée. Utilisez cette macro lorsque vous regroupez des audiences exportées dans des fichiers, en fonction d’une politique de fusion. Utilisez cette macro avec segmentGroupingEnabled:true.
e8591fdb-2873-4b12-b63e-15275b1c1439
MERGE_POLICY_NAME
Nom de la politique de fusion
Nom de la politique de fusion utilisé pour générer l’audience exportée. Utilisez cette macro lorsque vous regroupez des audiences exportées dans des fichiers, en fonction d’une politique de fusion. Utilisez cette macro avec segmentGroupingEnabled:true.
Ma politique de fusion personnalisée

Exemple de configuration de nom de fichier file-name-configuration-example

L’exemple de configuration ci-dessous montre la correspondance entre la configuration utilisée dans l’appel API et les options affichées dans l’interface utilisateur.

"filenameConfig":{
   "allowedFilenameAppendOptions":[
      "CUSTOM_TEXT",
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilenameAppendOptions":[
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilename": "%DESTINATION%"
}

Image de l’interface utilisateur affichant l’écran de configuration du nom de fichier avec les macros présélectionnées

Configuration de l’exportation des jeux de données dataset-export-configuration

Utilisez l’objet datasetBatchConfig, imbriqué dans batchConfig, pour configurer les noms de dossier et les plannings d’exportation pour les destinations qui prennent en charge les exportations de jeux de données.

IMPORTANT
Cet objet ne s’applique que lorsque la configuration de destination inclut "sources": ["DATASETS"]. Consultez Configurer le type de données d’audience pour obtenir l’exemple de configuration de destination complet, ou suivez le guide détaillé pour configurer une destination d’exportation de jeu de données.
"batchConfig":{
   "datasetBatchConfig":{
      "allowedFoldernameAppendOptions":[
         "DESTINATION",
         "DATASET_ID",
         "DATASET_NAME",
         "EXPORT_TIME",
         "DESTINATION_INSTANCE_ID",
         "DESTINATION_INSTANCE_NAME",
         "ORGANIZATION_NAME",
         "SANDBOX_NAME",
         "DATETIME",
         "CUSTOM_TEXT"
      ],
      "defaultFoldernameAppendOptions":[
         "DATASET_ID",
         "EXPORT_TIME"
      ],
      "allowedExportModes":[
         "DAILY_FULL_EXPORT",
         "FIRST_FULL_THEN_INCREMENTAL"
      ],
      "allowedScheduleFrequency":[
         "DAILY",
         "EVERY_3_HOURS",
         "EVERY_6_HOURS",
         "EVERY_8_HOURS",
         "EVERY_12_HOURS",
         "ONCE"
      ]
   }
}
Paramètre
Type
Description
datasetBatchConfig.allowedFoldernameAppendOptions
Liste

Obligatoire. Liste des macros de nom de dossier disponibles. Ceux-ci déterminent quels éléments sont ajoutés au chemin du dossier d’exportation. Si defaultFoldernameAppendOptions est vide, au moins une macro doit être spécifiée ici. Valeurs prises en charge :

  • DESTINATION
  • DATASET_ID
  • DATASET_NAME
  • EXPORT_TIME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT
datasetBatchConfig.defaultFoldernameAppendOptions
Liste
Obligatoire. Macros de nom de dossier par défaut présélectionnées. Doit être un sous-ensemble des valeurs définies dans allowedFoldernameAppendOptions.
datasetBatchConfig.allowedExportModes
Liste

Définit les modes d’exportation disponibles pour les utilisateurs pour les exportations de jeux de données. Valeurs prises en charge :

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
datasetBatchConfig.allowedScheduleFrequency
Liste

Définit les options de fréquence d’exportation disponibles pour les utilisateurs pour les exportations de jeux de données. Valeurs prises en charge :

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY

Macros de nom de dossier folder-name-macros

Les macros du tableau ci-dessous peuvent être utilisées dans allowedFoldernameAppendOptions et defaultFoldernameAppendOptions pour définir la structure du chemin du dossier d’exportation du jeu de données.

Macro
Description
Exemple
DESTINATION
Nom de la destination dans l’interface utilisateur.
Amazon S3
DATASET_ID
Identifiant unique du jeu de données exporté, généré par Experience Platform.
6966075d-f6b4-4a04-bd35-d438e1ebd1c3
DATASET_NAME
Nom du jeu de données exporté.
Mon jeu de données
EXPORT_TIME
Exportez l’heure au format exportTime=YYYYMMDDHHMM.
exportTime=202212091200
DESTINATION_INSTANCE_ID
Identifiant unique de l’instance de destination, généré par Experience Platform.
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
Nom défini par l’utilisateur de l’instance de destination.
Ma destination Advertising 2024
ORGANIZATION_NAME
Nom de l’organisation du client en Adobe Experience Platform.
Mon nom d’organisation
SANDBOX_NAME
Nom du sandbox utilisé par le client.
prod
DATETIME
Date et heure au format YYYYMMDD_HHMMSS.
20220509_210543
CUSTOM_TEXT
Texte personnalisé défini par l’utilisateur à inclure dans le nom du dossier.
My_Custom_Text

Étapes suivantes next-steps

Vous êtes arrivé au bout de cet article. À présent, vous devriez mieux comprendre comment configurer les noms de fichiers et la planification des exportations pour vos destinations basées sur les fichiers.

Pour en savoir plus sur les autres composants de destination, consultez les articles suivants :

recommendation-more-help
experience-platform-help-destinations