FTP Requisitos de nombre y tamaño Archivo aplicables a los datos de entrada Archivos ftp-name-and-file-size-requirements-for-inbound-data-files

Describe los campos obligatorios, la sintaxis, las convenciones de nomenclatura y los tamaños de archivo que debe seguir al enviar datos a Audience Manager. Defina los nombres y tamaños de los archivos según estas especificaciones cuando envíe datos a un directorio Audience Manager FTP .

WARNING
Estamos eliminando gradualmente el soporte para FTP las configuraciones. Aunque la ingesta de archivos de datos de entrada todavía se admite en las integraciones existentes FTP , recomendamos encarecidamente su uso Amazon S3 para incorporar datos de sin conexión para nuevas integraciones. Consulte Requisitos de nomenclatura y tamaño de archivo de Amazon S3 para archivos de datos entrantes para obtener más información.
NOTE
Los estilos de texto (monospaced text, cursiva , corchetes , etc.) de esta documento indican elementos y opciones de [ ] ( )código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Sintaxis del nombre Archivo file-name-syntax

FTP Los nombres de archivo contienen los siguientes elementos opcionales y obligatorios:

ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

Para conocer otros formatos de nombre de archivo aceptados, consulteIntegraciones personalizadas de socios.

NOTE
Audience Manager solo procesos ASCII y UTF-8 archivos codificados.

Nombrar elementos

La tabla define los elementos de un FTP nombre de archivo.

Archivo elemento Name
Descripción
ftp_dpm_
La ruta y el nombre de su directorio FTP del Audience Manager . Póngase en contacto con el administrador de cuentas para obtener el directorio FTP y las credenciales.
DPID

Un LD que Audience Manager indica si un archivo de datos contiene sus propios ID de usuario, ID de Android, ID de iOS u otros ID que pertenecen a orígenes de datos globales. Acepta las siguientes opciones:

  • ID de Origen de datos (también conocido como ID de proveedor de datos): es un ID único que Audience Manager asigna a un fuente de datos (consulte el índice Audience Manager de ID). Utilice este ID asignado en un nombre de archivo cuando envíe datos que contengan sus propios ID de usuario. Por ejemplo, ...ftp_dpm_21_123456789.sync indica a los Audience Manager que incorporen datos a identificadores pertenecientes al fuente de datos 21.
  • ID de Android (GAID): use el ID 20914 en el nombre de un archivo de datos si contiene ID de Android. Debe utilizar este campo _DPID_TARGET_DATA_OWNER cuando utilice ID de Android. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager que el archivo de datos contiene solo ID de Android y que los ID deben calificar para las características pertenecientes al _DPID_TARGET_DATA_OWNER fuente de datos.
  • ID de iOS (IDFA): use el ID 20915 en el nombre de un archivo de datos si contiene ID de iOS. Debe usar el campo _DPID_TARGET_DATA_OWNER cuando use ID de iOS. Por ejemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager que el archivo de datos contiene solo ID de iOS y que los ID deben cumplir los requisitos para las características pertenecientes al _DPID_TARGET_DATA_OWNER fuente de datos.
  • ID pertenecientes a otras fuentes de datos globales: puede incorporar ID de Roku para publicidad (RIDA), ID de Microsoft Advertising (MAID) y otros ID. Utilice el ID correspondiente a cada fuente de datos, tal y como se describe en el artículo Fuentesde datos globales.

Nota: No mezcle tipos de ID en los archivos de datos. Por ejemplo, si su nombre de archivo incluye el identificador de Android, no coloque ID de iOS o sus propios ID en el archivo de datos.

_DPID_TARGET_DATA_OWNER

Este campo Audience Manager indica a qué fuente de datos incorporar los datos. Este campo es obligatorio si establece el DPID en un ID de Android o iOS ID u otro ID que pertenezca a fuentes de datos globales. Esto Audience Manager permite vincular los datos del archivo a su organización.
Este destino fuente de datos debe ser propiedad de su compañía. Para fines de intercambio de datos de segunda parte, para ingerir datos en una destino fuente de datos perteneciente a otra compañía, debe tener una asignación de acceso entre su compañía y la fuente de datos destino. Para configurar la asignación, póngase en contacto con su consultor Adobe Systems o con Asistencia al cliente.

Nota importante: No es necesario solicitud una asignación para las relaciones de uso compartido de datos existentes (para destino fuentes de datos pertenecientes a otras empresas en las que incorporó datos antes del 14 de marzo de 2022). La asignación tampoco es necesaria cuando se incorporan datos a fuentes de datos destino que pertenecen a su PID.

Por ejemplo:

  • ...ftp_dpm_33_21_1234567890.sync Audience Manager indica que reúne los requisitos para los ID de cliente pertenecientes al fuente de datos 33 para rasgos o señales pertenecientes al fuente de datos 21.
  • ID de Android (GAID): ...ftp_dpm_20914_21_1234567890.sync Audience Manager indica que el archivo de datos contiene solo ID de Android y que los ID deben calificar para los rasgos pertenecientes a fuente de datos 21.
  • ID de iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync Audience Manager indica que el archivo de datos contiene solo ID de iOS y que los ID deben calificar para los rasgos pertenecientes a fuente de datos 21.
  • ID pertenecientes a otras fuentes de datos globales: ...ftp_dpm_121963_21_1234567890.sync Audience Manager indica que el archivo de datos contiene solo ID de Roku y que los ID deben calificar para los rasgos pertenecientes al fuente de datos 21. Utilice el ID correspondiente a cada fuente de datos, tal y como se describe en el artículo Fuentesde datos globales.
(.sync |.overwrite)

Opciones de sincronización que incluyen:

  • sync: Situación normal en la que los proveedores de datos de terceros envían características por usuario para añadirlas o eliminarlas en el sistema Audience Manager.
  • overwrite: permite a los clientes y proveedores de datos enviar un lista de características por usuario que debería sobrescribir todas las características existentes de este usuario para un fuente de datos determinado en Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluya solo aquellos usuarios que desee cambiar. Las características que no estén asignadas al fuente de datos destino no se borrarán.
[SPLIT_NUMBER]

Un entero. Se utiliza al dividir archivos de gran tamaño en varias partes con el fin de mejorar los tiempos de procesamiento. El número indica qué parte del archivo original está enviando.

Para un procesamiento de archivos eficiente, divida sus archivos de datos como se indica:

  • Sin comprimir: 1 GB
  • Comprimido: 200-300 MB

Vea los primeros 2 ejemplos de nombres de archivo a continuación.

TIMESTAMP
Una marca de tiempo UTC UNIX de 10 dígitos en segundos. La marca de fecha y hora ayuda a que cada nombre de archivo sea único.
[.gz]

Gzip es el formato de compresión permitido para un nombre de archivo FTP. Si utiliza la compresión de archivos, asegúrese de que el nombre del archivo tenga la extensión adecuada.

Los archivos comprimidos deben tener 3 GB o menos. Si los archivos son más grandes, póngase en contacto con el Servicio de atención al cliente. Aunque Audience Manager puede manejar archivos grandes, es posible que podamos ayudarlo a reducir el tamaño de sus archivos y hacer que las transferencias de datos sean más eficientes. Consulte Archivo Compresión para la transferencia de datos de entrada Archivos .

Ejemplos de nombres Archivo file-name-examples

Los ejemplos siguientes muestran nombres de archivo con el formato correcto. Los nombres de archivo pueden tener un aspecto similar.

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

Descargue el archivo de muestra si necesita ejemplos adicionales. Este archivo se guarda con la extensión de .overwrite archivo. Ábralo con un simple texto editor.

Tamaños de Archivo aceptados accepted-file-sizes

Tenga en cuenta las cifras a continuación para el procesamiento más rápido / temprano de sus archivos, así como para las limitaciones de tamaño de archivo cuando envía datos a un Audience Manager directorio / FTP .

Tipo de archivo
Tamaño óptimo
Tamaño máximo
Comprimido
200-300 MB
3 GB
Sin comprimir
1 GB
5 GB
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695