Configuración por lotes

Utilice las opciones de configuración por lotes en Destination SDK para permitir a los usuarios personalizar los nombres de archivo exportados y configurar la programación de exportación según sus preferencias.

Al crear destinos basados en archivos mediante Destination SDK, puede configurar los nombres de archivo predeterminados y las programaciones de exportación, o puede dar a los usuarios la opción de configurar estos ajustes desde la interfaz de usuario de Platform. Por ejemplo, puede configurar comportamientos como:

  • Incluir información específica en el nombre del archivo, como ID de audiencia, ID de destino o información personalizada.
  • Permite a los usuarios personalizar el nombre de archivo desde la interfaz de usuario de Platform.
  • Configure las exportaciones de archivos para que se produzcan a intervalos de tiempo establecidos.
  • Defina las opciones de nomenclatura de archivos y de personalización de programación de exportación que los usuarios pueden ver en la IU de Platform.

Los ajustes de configuración por lotes forman parte de la configuración de destino para destinos basados en archivos.

Para saber dónde encaja este componente en una integración creada con Destination SDK, consulte el diagrama en la opciones de configuración o consulte la guía sobre cómo usar Destination SDK para configurar un destino basado en archivos.

Puede configurar la nomenclatura de archivos y exportar la configuración de programación mediante el /authoring/destinations punto final. Consulte las siguientes páginas de referencia de la API para ver ejemplos detallados de llamadas de la API donde puede configurar los componentes que se muestran en esta página.

Este artículo describe todas las opciones de configuración por lotes admitidas que puede utilizar para su destino y muestra lo que los clientes verán en la interfaz de usuario de Platform.

IMPORTANTE

Todos los nombres y valores de parámetro admitidos por el Destination SDK son distingue mayúsculas de minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de los parámetros exactamente como se muestra en la documentación.

Tipos de integración admitidos

Consulte la tabla siguiente para obtener detalles sobre qué tipos de integraciones admiten la funcionalidad descrita en esta página.

Tipo de integración Admite funcionalidad
Integraciones en tiempo real (streaming) No
Integraciones basadas en archivos (por lotes) Sí

Parámetros admitidos

Los valores que configure aquí aparecen en la variable Programar exportación de audiencias paso del flujo de trabajo de activación de destinos basados en archivos.

"batchConfig":{
   "allowMandatoryFieldSelection":true,
   "allowDedupeKeyFieldSelection":true,
   "defaultExportMode":"DAILY_FULL_EXPORT",
   "allowedExportMode":[
      "DAILY_FULL_EXPORT",
      "FIRST_FULL_THEN_INCREMENTAL"
   ],
   "allowedScheduleFrequency":[
      "DAILY",
      "EVERY_3_HOURS",
      "EVERY_6_HOURS",
      "EVERY_8_HOURS",
      "EVERY_12_HOURS",
      "ONCE"
   ],
   "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
   }
Parámetro Tipo Descripción
allowMandatoryFieldSelection Booleano Configure como. true para permitir a los clientes especificar qué atributos de perfil son obligatorios. El valor predeterminado es false. Consulte Atributos obligatorios para obtener más información.
allowDedupeKeyFieldSelection Booleano Configure como. true para permitir a los clientes especificar claves de deduplicación. El valor predeterminado es false. Consulte Claves de deduplicación para obtener más información.
defaultExportMode Enumeración Define el modo de exportación de archivos predeterminado. Valores compatibles:
  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
El valor predeterminado es DAILY_FULL_EXPORT. Consulte la documentación de activación por lotes para obtener más información sobre la programación de exportaciones de archivos.
allowedExportModes Lista Define los modos de exportación de archivos disponibles para los clientes de. Valores compatibles:
  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency Lista Define la frecuencia de exportación de archivos disponible para los clientes. Valores compatibles:
  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
defaultFrequency Enumeración Define la frecuencia predeterminada de exportación de archivos. Valores compatibles:
  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
El valor predeterminado es DAILY.
defaultStartTime Cadena Define la hora de inicio predeterminada para la exportación de archivos. Utiliza el formato de archivo de 24 horas. El valor predeterminado es 00:00.
filenameConfig.allowedFilenameAppendOptions Cadena Requerido. Lista de macros de nombre de archivo disponibles para que los usuarios elijan. Esto determina qué elementos se anexan a los nombres de archivo exportados (ID de audiencia, nombre de organización, fecha y hora de exportación, etc.). Al configurar defaultFilename, asegúrese de evitar la duplicación de macros.

Valores compatibles:
  • DESTINATION
  • SEGMENT_ID
  • SEGMENT_NAME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT
Independientemente del orden en el que defina las macros, la interfaz de usuario de Experience Platform siempre las mostrará en el orden presentado aquí.

If defaultFilename está vacío, la variable allowedFilenameAppendOptions La lista debe contener al menos una macro.
filenameConfig.defaultFilenameAppendOptions Cadena Requerido. Macros de nombre de archivo predeterminado preseleccionadas que los usuarios pueden desmarcar.

Las macros de esta lista son un subconjunto de las definidas en allowedFilenameAppendOptions.
filenameConfig.defaultFilename Cadena Opcional. Define las macros de nombre de archivo predeterminadas para los archivos exportados. Los usuarios no pueden sobrescribirlos.

Cualquier macro definida por allowedFilenameAppendOptions se adjuntará después de defaultFilename macros.

If defaultFilename está vacío, debe definir al menos una macro en allowedFilenameAppendOptions.
segmentGroupingEnabled Booleano Define si las audiencias activadas deben exportarse en un solo archivo o en varios archivos, según la audiencia política de combinación. Valores compatibles:
  • true: exporta un archivo por política de combinación.
  • false: exporta un archivo por audiencia, independientemente de la política de combinación. Este es el comportamiento predeterminado. Puede lograr el mismo resultado omitiendo este parámetro por completo.

Configuración del nombre de archivo

Utilice macros de configuración de nombres de archivo para definir qué nombres de archivo exportados deben incluir. Las macros de la tabla siguiente describen los elementos que se encuentran en la interfaz de usuario de configuración de nombre de archivo pantalla.

SUGERENCIA

Como práctica recomendada, siempre debe incluir la variable SEGMENT_ID macro en los nombres de archivo exportados. Los ID de segmento son únicos, por lo que incluirlos en el nombre de archivo es la mejor manera de asegurarse de que los nombres de archivo también sean únicos.

Macro Etiqueta de IU Descripción Ejemplo
DESTINATION Destino Nombre del destino en la interfaz de usuario. Amazon S3
SEGMENT_ID ID del segmento ID de audiencia único y generado por la plataforma ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME Nombre del segmento Nombre de audiencia definido por el usuario VIP suscriptor del servicio de asistencia
DESTINATION_INSTANCE_ID ID de destino ID único y generado por Platform de la instancia de destino 7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME Nombre del destino Nombre definido por el usuario de la instancia de destino. Mi destino publicitario de 2022
ORGANIZATION_NAME Nombre de la organización Nombre de la organización del cliente en Adobe Experience Platform. Nombre de mi organización
SANDBOX_NAME Nombre de la zona protegida Nombre de la zona protegida utilizada por el cliente. picar
DATETIME / TIMESTAMP Fecha y hora DATETIME y TIMESTAMP ambos definen cuándo se generó el archivo, pero en formatos diferentes.

  • DATETIME utiliza el siguiente formato: AAAAMMDD_HHMMSS.
  • TIMESTAMP utiliza el formato Unix de 10 dígitos.
DATETIME y TIMESTAMP son mutuamente excluyentes y no pueden utilizarse simultáneamente.
  • DATETIME: 20220509_210543
  • TIMESTAMP: 1652131584
CUSTOM_TEXT Texto personalizado Texto personalizado definido por el usuario que se incluirá en el nombre del archivo. No se puede usar en defaultFilename. My_Custom_Text
TIMESTAMP Fecha y hora Marca de tiempo de 10 dígitos de la hora en la que se generó el archivo, en formato Unix. 1652131584
MERGE_POLICY_ID ID de política de combinación El ID del política de combinación se utiliza para generar la audiencia exportada. Utilice esta macro cuando agrupe audiencias exportadas en archivos, según la política de combinación. Utilice esta macro junto con segmentGroupingEnabled:true. e8591fdb-2873-4b12-b63e-15275b1c1439
MERGE_POLICY_NAME Nombre de política de combinación El nombre del política de combinación se utiliza para generar la audiencia exportada. Utilice esta macro cuando agrupe audiencias exportadas en archivos, según la política de combinación. Utilice esta macro junto con segmentGroupingEnabled:true. Mi política de combinación personalizada

Ejemplo de configuración de nombre de archivo

El ejemplo de configuración siguiente muestra la correspondencia entre la configuración utilizada en la llamada de API y las opciones que se muestran en la interfaz de usuario.

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

Imagen de la interfaz de usuario que muestra la pantalla de configuración del nombre de archivo con macros preseleccionadas

Pasos siguientes

Después de leer este artículo, debería tener una mejor comprensión de cómo puede configurar la nomenclatura de archivos y las programaciones de exportación para sus destinos basados en archivos.

Para obtener más información acerca de los demás componentes de destino, consulte los siguientes artículos:

En esta página