Amazon S3 requisitos de tamaño de archivo y nombre para archivos de datos entrantes

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 sus archivos según estas especificaciones cuando envíe datos a un directorio Audience Manager / Amazon S3.

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

S3 los nombres de archivo contienen los siguientes elementos opcionales y requeridos:

  • S3prefijo: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

  • Elementos de nombre de archivo: 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.

NOTA

Audience Manager solo procesa ASCII y UTF-8 codifica archivos.

Elementos de nombre

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

Elemento Nombre Descripción

AWS_directory

La ruta y el nombre del espacio de Amazon S3. Póngase en contacto con el administrador de su cuenta para obtener el nombre, la ruta y las credenciales de su directorio S3.

date=yyyy-mm-dd

Marca de fecha y hora (según la hora UTC) del momento en el que se envían los archivos al compartimento S3.

DPID

Un lD 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 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 índice de ID del Audience Manager ). 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 al Audience Manager que incorpore datos a los ID que pertenecen a la fuente de datos 21.
  • Android ID (GAID): utilice el ID 20914 en un nombre de archivo de datos si contiene Android ID. Debe utilizar el campo _DPID_TARGET_DATA_OWNER cuando utilice Android ID. Por ejemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync indica al 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 fuente de datos _DPID_TARGET_DATA_OWNER .
  • 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 contiene solo ID de iOS y que los ID deben cumplir los requisitos para los rasgos pertenecientes a la fuente de datos _DPID_TARGET_DATA_OWNER.
  • 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 el artículo 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 inserte ID de iOS o ID propios 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 ID de Android o un ID de iOS u otro ID que pertenezca a fuentes de datos globales. Esto permite que el Audience Manager vuelva a vincular los datos del archivo a su organización.

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 indica a 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 fuente de datos 21.
  • ID de iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync indica a Audience Manager que el archivo de datos contiene solo ID de iOS y que 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 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 pertenecientes a la fuente de datos 21. Utilice el ID correspondiente a cada fuente de datos, tal como se describe en el artículo de fuentes de datos globales.

partner_name

El nombre de empresa u organización que utiliza en el Audience Manager .

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.

(.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 que los proveedores de datos envíen una lista de características por usuario que debe sobrescribir todos los rasgos de terceros de este usuario para este proveedor de datos en el Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluir solo los usuarios que desee cambiar.

[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

Consulte los dos primeros ejemplos de nombres de archivo a continuación.

[.gz]

Cuando envíe archivos a Amazon S3, utilice solo compresión gzip. Cuando se comprime, estos archivos obtienen la extensión .gz. No utilice la compresión .zip.

Los archivos comprimidos deben tener 3 GB o menos. Si sus 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 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. Sus nombres de archivo podrían tener un aspecto similar.

  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite

Puede [descargar] (assets/ftp_dpm_1234_1445374061.overwrite) el archivo de muestra si desea ver más ejemplos. Este archivo se ha guardado con la extensión de archivo .overwrite. Ábrala con un editor de texto sencillo.

Tamaños de archivo aceptados

Tenga en cuenta las siguientes cifras 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 directorio Audience Manager / Amazon S3.

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

200-300 MB

3 GB

Sin comprimir

1 GB

5 GB

NOTA

El proceso de validación de datos de entrada marcará los archivos vacíos como no válidos y no los procesará.

Límites de longitud de línea

Los archivos de datos de entrada tienen un límite de longitud de línea de 102400 bytes. Las líneas que superen este límite se excluyen de la transferencia.

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now