Show Menu
TEMAS×

FTPRequisitos de tamaño de archivo y nombre de para archivos de datos de entrada

Describe los campos requeridos, la sintaxis, las convenciones de nomenclatura y los tamaños de archivo que debe seguir al enviar datos a Audience Manager. Configure los nombres y tamaños de los archivos según estas especificaciones cuando envíe datos a un directorio de Audience Manager FTP .
We are gradually phasing out support for FTP configurations. While inbound data file ingestion is still supported in existing FTP integrations, we strongly recommend using Amazon S3 to onboard offline data for new integrations. Consulte Requisitos de nomenclatura y tamaño de archivo de Amazon S3 para archivos de datos entrantes para obtener más información.
Estilos de texto ( monospaced text , cursiva , paréntesis [ ] ( ) , etc.) en este documento, indique los elementos y las opciones del código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Sintaxis del nombre del archivo

FTP los nombres de archivo contienen los siguientes elementos opcionales y requeridos:
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Para ver otros formatos de nombre de archivo aceptados, consulte Integraciones de socio personalizadas.
Audience Manager solo procesa ASCII y UTF-8 codifica archivos.

Asignar nombres a los elementos

La tabla define los elementos de un nombre de FTP archivo.
Elemento Nombre de archivo Descripción
ftp_dpm_
La ruta y el nombre del directorio FTP del Audience Manager . Póngase en contacto con el administrador de cuentas para obtener el directorio FTP y las credenciales.
DPID
Un ID que indica al Audience Manager si un archivo de datos contiene sus propios ID de usuario, ID de Android, ID de iOS u otros ID pertenecientes a orígenes de datos globales. Acepta las siguientes opciones:
  • ID de fuente de datos (también conocido como ID de proveedor de datos): Se trata de una ID única que el Audience Manager asigna a un origen de datos (consulte el índice de ID de Audience Manager ). 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 al Audience Manager que incorpore datos a los ID que pertenecen al origen de datos 21.
  • ID de Android (GAID): Utilice el ID 20914 en un nombre de archivo de datos si contiene ID de Android. Debe utilizar el campo _DPID_TARGET_DATA_OWNER cuando utilice ID de Android. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica al Audience Manager que el archivo de datos solo contiene ID de Android y que los ID deben cumplir los requisitos de las características pertenecientes al origen de _DPID_TARGET_DATA_OWNER datos.
  • ID de iOS (IDFA): Utilice el ID 20915 en un nombre de archivo de datos si contiene ID de iOS. Debe utilizar el campo _DPID_TARGET_DATA_OWNER cuando utilice ID de iOS. Por ejemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indica al Audience Manager que el archivo de datos solo contiene ID de iOS y que los ID deben cumplir los requisitos de las características pertenecientes al origen de _DPID_TARGET_DATA_OWNER datos.
  • ID pertenecientes a otras fuentes de datos globales: Puede incorporar ID de Roku para publicidad (RIDA), ID de publicidad de Microsoft (MAID) y otros ID. Utilice el ID correspondiente a cada fuente de datos, tal como se describe en el artículo Fuentes de datos globales de fuentes de datos globales.
Nota: No mezcle los tipos de ID en los archivos de datos. Por ejemplo, si el nombre de archivo incluye el identificador de Android, no incluya los ID de iOS ni los propios ID en el archivo de datos.
_DPID_TARGET_DATA_OWNER
Este campo indica al Audience Manager el origen de datos al que desea incluir los datos. Este campo es obligatorio si establece el DPID en un ID de Android o iOS u otro ID que pertenezca a fuentes de datos globales. Esto permite al Audience Manager volver a vincular los datos del archivo a su organización.
Por ejemplo:
  • ...ftp_dpm_33_21_1234567890.sync indica al Audience Manager que califica los ID de cliente pertenecientes a la fuente de datos 33 para características o señales pertenecientes a la fuente de datos 21.
  • ID de Android (GAID): ...ftp_dpm_20914_21_1234567890.sync indica al Audience Manager que el archivo de datos solo contiene ID de Android y que los ID deben cumplir los requisitos para las características pertenecientes a la fuente de datos 21.
  • ID de iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync indica al Audience Manager que el archivo de datos solo contiene ID de iOS y que los ID deben cumplir los requisitos para las características pertenecientes a la fuente de datos 21.
  • ID pertenecientes a otras fuentes de datos globales: ...ftp_dpm_121963_21_1234567890.sync indica al Audience Manager que el archivo de datos solo contiene ID de Roku y que los ID deben cumplir los requisitos para las características pertenecientes al origen de datos 21. Utilice el ID correspondiente a cada fuente de datos, tal como se describe en el artículo Fuentes de datos globales de fuentes de datos globales.
(.sync |.overwrite)
Opciones de sincronización que incluyen:
  • sync :: escenario normal cuando proveedores de datos de terceros envían características por usuario para agregarlas o eliminarlas en el sistema de Audience Manager.
  • overwrite :: Permite a los clientes y proveedores de datos enviar una lista de características por usuario que debe sobrescribir todas las características existentes de este usuario para una fuente de datos determinada en Audience Manager. No es necesario incluir todos los usuarios en un archivo de sobrescritura. Incluya solo los usuarios que desee cambiar. Las características que no están asignadas al origen de datos de destinatario no se borran.
[ SPLIT_NUMBER ]
Un entero. Se utiliza cuando se dividen archivos grandes en varias partes para mejorar los tiempos de procesamiento. El número indica qué parte del archivo original está enviando.
Para un procesamiento eficaz de archivos, divida los archivos de datos como se indica:
  • Sin comprimir: 1 GB
  • Comprimido: 200-300 MB
Consulte los dos primeros ejemplos Ejemplos de nombres de archivo de nombres de archivo.
TIMESTAMP
Marca de hora UNIX de 10 dígitos en segundos. La marca de tiempo ayuda a hacer que cada nombre de archivo sea único.
[.gz]
Gzip es el formato de compresión permitido para un nombre de archivo FTP. Si utiliza 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 el Audience Manager puede gestionar archivos de gran tamaño, es posible que podamos ayudarle a reducir el tamaño de los archivos y aumentar la eficacia de las transferencias de datos. Consulte Compresión de archivos de transferencia de datos entrantes .

Ejemplos de nombres de archivo

Los siguientes ejemplos muestran nombres de archivo con el formato correcto. Los nombres de archivo podrían ser similares.
  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite
# (assets/ftp_dpm_1234_1445374061.overwrite) el archivo de muestra si necesita ejemplos adicionales. Este archivo se guarda con la extensión .overwrite de archivo. Ábralo con un editor de texto sencillo.

Tamaños de archivo aceptados

Tenga en cuenta las siguientes cifras para un procesamiento más rápido y más temprano de sus archivos, así como para las limitaciones de tamaño de los archivos al enviar datos a un directorio Audience Manager / FTP .
Tipo de archivo Tamaño óptimo Tamaño máximo
Comprimido
200-300 MB
3 GB
Sin comprimir
1 GB
5 GB