FTPRequisitos de tamaño de archivo y nombre de 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. Configure los nombres y tamaños de los archivos según estas especificaciones cuando envíe datos a un Audience Manager FTP directorio.

WARNING
Estamos progresivamente la compatibilidad con FTP las configuraciones. Aunque la ingesta de archivos de datos entrantes aún se admite en las integraciones existentes FTP , se recomienda utilizar Amazon S3 para incorporar datos de sin conexión para integraciones nuevas. 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 del código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Sintaxis de nombre de Archivo file-name-syntax

FTP los 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 procesos ASCII y UTF-8 archivos codificados.

Elementos de nombre

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

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

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

  • ID de la fuente de datos (también conocido como ID del proveedor de datos): Se trata de un ID único que el Audience Manager asigna a una fuente de datos (consulte con 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 indica Audience Manager a los datos incorporados a los ID que pertenecen a fuente de datos 21.
  • ID de Android (GAID): use ID 20914 en un nombre de archivo de datos si contiene Android ID. Debe utilizar el campo _DPID_TARGET_DATA_OWNER cuando utilice los ID de Android. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica Audience Manager que el archivo de datos solo contiene los ID de Android y los ID deben cumplir las características pertenecientes al _DPID_TARGET_DATA_OWNER fuente de datos.
  • iOS ID (IDFA): Utilice 20915 de ID 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 cuenta Audience Manager Compruebe que el archivo de datos contiene únicamente ID de iOS y que los ID deben cumplir los requisitos para los rasgos pertenecientes a _DPID_TARGET_DATA_OWNER fuente de datos.
  • ID que pertenecen a otras fuentes de datos globales: puede incorporar los ID de Roku para publicidad (RIDA), ID de publicidad de Microsoft (MAID) y otros ID. Utilice el ID correspondiente a cada fuente de datos, como se describe en el artículo de fuentes de datos globales.

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

_DPID_TARGET_DATA_OWNER

Este campo indica Audience Manager en el que fuente de datos en los que se incorporan los datos. Este campo es obligatorio si establece DPID en un ID de Android o en un ID de iOS u otro ID que pertenezca a las fuentes de datos globales. Esto permite Audience Manager vincular los datos de archivo a su organización.
Esta destino fuente de datos debe ser propiedad de su compañía. Para el uso compartido de datos de terceros, para la ingesta de datos en un destino fuente de datos que pertenece a otro compañía, debe tener una asignación de acceso entre su compañía y el destino fuente de datos. Póngase en contacto con el consultor de Adobe Systems o con el servicio de atención al cliente para configurar la asignación.

Nota importante: Usted 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 haya incorporado 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á cualificando 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.
  • ID de Android (GAID): ...ftp_dpm_20914_21_1234567890.sync cuenta Audience Manager Compruebe que el archivo de datos solo contiene ID de Android y que los ID deben cumplir los requisitos para los rasgos que pertenecen a la fuente de datos 21.
  • iOS ID (IDFA): ...ftp_dpm_20915_21_1234567890.sync cuenta Audience Manager Compruebe que el archivo de datos solo contiene iOS ID 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 cuenta Audience Manager Compruebe 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. Utilice el ID correspondiente a cada fuente de datos, tal como se describe en la artículo de fuentes 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 añadan 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 una fuente de datos determinada en Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluya solo a los usuarios que desee cambiar. No se borrarán las características que no están asignadas al fuente de datos destino.
[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

Ver los 2 primeros ejemplos de nombre de archivo más abajo.

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 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

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

Tamaños de Archivo aceptados accepted-file-sizes

Considere las figuras siguientes para obtener el procesamiento más rápido y primero de sus archivos, así como las limitaciones de tamaño de archivo al enviar 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