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 Audience Manager FTP directorio.

ADVERTENCIA

Estamos eliminando gradualmente el soporte para FTP configuraciones. Mientras que la ingesta de archivos de datos entrantes sigue siendo compatible con FTP integraciones, recomendamos encarecidamente utilizar Amazon S3 para incorporar datos 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.

NOTA

Estilos de texto (monospaced text, cursiva, paréntesis [ ] ( ), etc.) en este documento, indique los elementos de código y las opciones. 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 socios personalizadas.

NOTA

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

Elementos de nombre

La tabla define los elementos de una FTP nombre del archivo.

Elemento Nombre de archivo Descripción

ftp_dpm_

La ruta a y el nombre de su Audience Manager Directorio FTP. Póngase en contacto con su administrador de cuentas para obtener el directorio FTP y las credenciales.

DPID

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

  • ID de fuente de datos (también conocido como ID de proveedor de datos): Se trata de un ID exclusivo que el Audience Manager asigna a una fuente de datos (consulte el Audience Manager índice de ID ). Utilice este ID asignado en un nombre de archivo al enviar datos que contengan sus propios ID de usuario. Por ejemplo, ...ftp_dpm_21_123456789.sync tell Audience Manager para incorporar datos a ID que pertenezcan a la fuente 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 al usar ID de Android. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync tell Audience Manager que el archivo de datos contiene solo ID de Android y que los ID deben cumplir los requisitos para los rasgos pertenecientes a la variable _DPID_TARGET_DATA_OWNER fuente de datos.
  • iOS ID (IDFA): Utilice el ID 20915 en un nombre de archivo de datos si contiene iOS ID. Debe utilizar el campo _DPID_TARGET_DATA_OWNER al usar iOS ID. Por ejemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync tell Audience Manager que el archivo de datos solo contiene iOS ID y que los ID deben cumplir los requisitos para los rasgos pertenecientes a la variable _DPID_TARGET_DATA_OWNER fuente de datos.
  • ID que pertenecen 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 la sección artículo sobre 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 inserte iOS ID o sus propios ID en el archivo de datos.

_DPID_TARGET_DATA_OWNER

Este campo indica al Audience Manager a qué fuente de datos debe incorporar los datos. Este campo es obligatorio si se establece el DPID en un Android ID o iOS ID u otro ID que pertenezca a fuentes de datos globales. Esto permite que Audience Manager vuelva a vincular los datos del archivo a su organización.
Esta fuente de datos de destino debe ser propiedad de su empresa. Para compartir datos de segundo nivel, para poder ingerir datos en un origen de datos de destino que pertenezca a otra empresa, debe tener una asignación de acceso entre la empresa y el origen de datos de destino. Póngase en contacto con su asesor de Adobe o con el Servicio de atención al cliente para configurar la asignación.

Nota importante: You no debe solicitar una asignación para las relaciones de uso compartido de datos existentes (para fuentes de datos de destino pertenecientes a otras empresas en las que incorporó datos antes del 14 de marzo de 2022). La asignación tampoco es necesaria al incorporar datos a fuentes de datos de destino que pertenecen a su PID.

Por ejemplo:

  • ...ftp_dpm_33_21_1234567890.sync indica al Audience Manager que está calificando 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 tell Audience Manager que el archivo de datos solo contiene ID de Android y los ID deben cumplir los requisitos para los rasgos pertenecientes a la fuente de datos 21.
  • iOS ID (IDFA): ...ftp_dpm_20915_21_1234567890.sync tell Audience Manager que el archivo de datos solo contiene iOS ID y los ID deben cumplir los requisitos para los rasgos pertenecientes a la fuente de datos 21.
  • ID que pertenecen a otras fuentes de datos globales: ...ftp_dpm_121963_21_1234567890.sync tell Audience Manager que el archivo de datos contiene solo ID de Roku y los ID deben cumplir los requisitos para los rasgos pertenecientes a la fuente de datos 21. Utilice el ID correspondiente a cada fuente de datos, tal como se describe en la sección artículo sobre fuentes de datos globales.

(.sync |.overwrite)

Opciones de sincronización que incluyen:

  • sync: Caso normal cuando proveedores de datos de terceros envían rasgos por usuario para agregarlos o eliminarlos 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 todos los rasgos existentes de este usuario para una fuente de datos determinada en Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluir solo los usuarios que desee cambiar. Los rasgos que no están asignados al origen de datos de destino no se borrarán.

[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 los archivos, divida los archivos de datos como se indica:

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

Ver los dos primeros ejemplos de nombres de archivo más abajo.

TIMESTAMP

Marca de tiempo UNIX UTC de 10 dígitos en segundos. La marca de tiempo 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 el Audience Manager puede gestionar archivos de gran tamaño, es posible que podamos ayudarle a reducir el tamaño de sus archivos y a hacer que las transferencias de datos sean más eficientes. 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. Sus nombres de archivo podrían tener un aspecto similar.

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

Descargar el archivo de muestra si necesita ejemplos adicionales. Este archivo se guarda con la variable .overwrite extensión de archivo. Ábrala con un editor de texto sencillo.

Tamaños de archivo aceptados

Tenga en cuenta las cifras siguientes para un procesamiento más rápido/temprano de los archivos, así como para las limitaciones de tamaño de los archivos al enviar datos a un Audience Manager / FTP directorio.

Tipo de archivo Tamaño óptimo Tamaño máximo
Comprimido

200-300 MB

3 GB

Sin comprimir

1 GB

5 GB

En esta página