FTP requisitos de nombre y tamaño de archivo para archivos de datos de entrada ftp-name-and-file-size-requirements-for-inbound-data-files

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

WARNING
Estamos eliminando gradualmente la compatibilidad con las configuraciones de FTP. Aunque la ingesta de archivos de datos entrantes sigue siendo compatible con las integraciones existentes de FTP, recomendamos encarecidamente utilizar Amazon S3 para incorporar datos sin conexión en el caso de 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
Estilos de texto (monospaced text, cursiva, paréntesis [ ] ( ), etc.) en este documento, indique los elementos y las opciones de código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Sintaxis del nombre del archivo file-name-syntax

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

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.

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

Elementos de nombre

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

Elemento Nombre de archivo
Descripción
ftp_dpm_
Ruta de acceso y nombre del directorio FTP del Audience Manager . Póngase en contacto con el Administrador de cuentas para obtener el directorio y las credenciales de FTP.
DPID

Un id. que informa al 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 orígenes de datos globales. Acepta las siguientes opciones:

  • ID de Data Source (también conocido como ID de proveedor de datos): Se trata de un ID único que el Audience Manager asigna a un origen de datos (consulte el índice del Audience Manager de los 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 indica a Audience Manager que incorpore datos a los ID que pertenecen al origen de datos 21.
  • Android ID (GAID): Use el ID 20914 en un nombre de archivo de datos si contiene Android ID. Debe usar el campo _DPID_TARGET_DATA_OWNER cuando use Android ID. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager que el archivo de datos contiene solo Android ID y que los ID deben cumplir los requisitos para los rasgos que pertenecen al origen de datos _DPID_TARGET_DATA_OWNER.
  • iOS ID (IDFA): Use el ID 20915 en un nombre de archivo de datos si contiene iOS ID. Debe usar el campo _DPID_TARGET_DATA_OWNER cuando use iOS ID. Por ejemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync indica a Audience Manager que el archivo de datos contiene solo iOS ID y que los ID deben cumplir los requisitos para los rasgos que pertenecen al origen de datos _DPID_TARGET_DATA_OWNER.
  • ID que pertenecen a otras fuentes de datos globales: Puede incorporar los ID de Roku para Advertising (RIDA), Microsoft Advertising ID (MAID) y otros ID. Use el identificador correspondiente a cada origen de datos, tal como se describe en el artículo orígenes de datos globales.

Nota: No mezcle tipos de ID en los archivos de datos. Por ejemplo, si el nombre de archivo incluye el identificador de Android, no coloque 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 incorporar los datos. Este campo es obligatorio si 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 vincule los datos del archivo a su organización.
: este origen de datos de destino debe ser propiedad de su compañía. Para compartir datos de segundo nivel, para introducir datos en una fuente de datos de destino perteneciente a otra empresa, debe tener una asignación de acceso entre su empresa y la fuente de datos de destino. Póngase en contacto con su asesor de Adobe o con Asistencia al cliente para configurar la asignación.

Nota importante: Usted no necesita solicitar una asignación para las relaciones de uso compartido de datos existentes (para orígenes de datos de destino que pertenecen a otras empresas en las que incorporó datos antes del 14 de marzo de 2022). La asignación tampoco es obligatoria al incorporar datos en 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 a los ID de cliente que pertenecen a la fuente de datos 33 para rasgos o señales que pertenecen a la fuente de datos 21.
  • Android ID (GAID): ...ftp_dpm_20914_21_1234567890.sync indica a Audience Manager que el archivo de datos contiene solo Android ID y que los ID deben cumplir los requisitos para los rasgos que pertenecen 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 los rasgos que pertenecen a la fuente de datos 21.
  • ID que pertenecen a otras fuentes de datos globales: ...ftp_dpm_121963_21_1234567890.sync indica a Audience Manager que el archivo de datos contiene solo ID de Roku y que los ID deben cumplir los requisitos para los rasgos que pertenecen a la fuente de datos 21. Use el identificador correspondiente a cada origen de datos, tal como se describe en el artículo orígenes de datos globales.
(.sync |.overwrite)

Opciones de sincronización que incluyen:

  • sync: escenario normal en el que los proveedores de datos de terceros envían características por usuario para que se agreguen o eliminen en el sistema Audience Manager.
  • overwrite: permite a los clientes y proveedores de datos enviar una lista de características por usuario que deben sobrescribir todas las características existentes de este usuario para un origen de datos determinado en Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluya solo a los usuarios que desee cambiar. Las características que no se hayan asignado a la fuente de datos de destino no se borrarán.
[SPLIT_NUMBER]

Un entero. Se utiliza al dividir 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 a continuación:

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

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

TIMESTAMP
Una 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 de FTP. Si utiliza la compresión de archivos, asegúrese de que el nombre del archivo tiene 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 gestionar archivos grandes, es posible que podamos ayudarle a reducir el tamaño de sus archivos y hacer que las transferencias de datos sean más eficientes. Consulte Compresión de archivos de para archivos de transferencia de datos entrantes .

Ejemplos de nombres de archivo file-name-examples

Los siguientes ejemplos muestran nombres de archivo con el formato correcto. Sus 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

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

Tamaños de archivo admitidos accepted-file-sizes

Tenga en cuenta las figuras siguientes para el procesamiento más rápido/más temprano de sus archivos, así como para las limitaciones de tamaño de archivo 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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695