Show Menu
TEMAS×

Requisitos de tamaño de archivo y nombre de Amazon S3 para archivos de datos de entrada

Describe los campos requeridos, la sintaxis, las convenciones de nombres 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 / Amazon S3 .
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

S3 los nombres de archivo contienen los siguientes elementos opcionales y requeridos:
  • S3 prefix: 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.
Audience Manager solo procesa ASCII y UTF-8 codifica archivos.

Asignar nombres a los elementos

La tabla define los elementos de un nombre de S3 archivo.
Elemento Nombre Descripción
AWS_directory
Ruta y nombre del bucket de Amazon S3. Póngase en contacto con el administrador de cuentas para obtener el nombre, la ruta y las credenciales del directorio S3.
date= yyyy-mm-dd
Marca de hora (según la hora UTC) del momento en que se envían los archivos al bucket S3.
DPID
El ID del proveedor de datos (DPID) es un identificador que indica a Audience Manager si un archivo de datos contiene sus propios ID de usuario o de Android o iOS. Acepta las siguientes opciones:
ID del socio de datos
Es un ID exclusivo que Audience Manager asigna a su empresa u organización. 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 a Audience Manager que un socio con ID 21 envió el archivo y contiene los ID de usuario asignados por ese socio.
ID de Android (GAID)
Utilice ID 20914 como DPID en un nombre de archivo de datos si el archivo contiene ID de Android. Cuando utilice el ID 20914 como DPID, deberá identificar su empresa en Audience Manager . Esto significa que el nombre del archivo debe utilizar el parámetro _DPID_TARGET_DATA_OWNER para retener el ID de su empresa. Por ejemplo, supongamos que está pasando archivos con ID de Android y que su ID de proveedor de datos es 21. En este caso, el nombre del archivo sería ...ftp_dpm_20914_21_123456789.sync . Esto indica a Audience Manager que el archivo contiene ID de Android y procede de un socio identificado por el ID 21.
ID de iOS (IDFA)
Utilice ID 20915 como DPID en un nombre de archivo de datos si el archivo contiene ID de iOS. Cuando utilice el ID 2015 como DPID, deberá identificar su empresa en Audience Manager . Esto significa que el nombre del archivo debe utilizar el parámetro _DPID_TARGET_DATA_OWNER para retener el ID de su empresa. Por ejemplo, supongamos que está pasando archivos con ID de Android y que su ID de proveedor de datos es 21. En este caso, el nombre del archivo sería ...ftp_dpm_20915_21_123456789.sync . Esto indica a Audience Manager que el archivo contiene ID de iOS y procede de un socio identificado por el ID 21.
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.
Consulte también la entrada _DPID_TARGET_DATA_OWNER más abajo.
_DPID_TARGET_DATA_OWNER
Marcador de posición para un ID. Por ejemplo, puede configurarlo en su ID de Audience Manager si establece el DPID en un ID de origen de datos o un ID de Android o iOS. Esto permite a Audience Manager volver a vincular los datos del archivo a su organización.
Por ejemplo:
  • ...ftp_dpm_33_21_1234567890.sync muestra que un socio con ID 21 ha enviado datos desde un origen de datos que utiliza ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync muestra un socio con ID 21 enviado en datos que contienen ID de Android.
  • ...ftp_dpm_20915_21_1234567890.sync muestra un socio con ID 21 enviado en datos que contienen ID de iOS.
partner_name
Nombre de empresa u organización que se utiliza en Audience Manager .
MARCA DE TIEMPO
Marca de hora UNIX de 10 dígitos en segundos. La marca de tiempo ayuda a hacer que cada nombre de archivo sea único.
(.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 Audience Manager.
  • sobrescribir : Permite a los proveedores de datos enviar una lista de características por usuario que deben sobrescribir todas las características de terceros de este usuario para este proveedor de datos en Audience Manager. No es necesario incluir todos los usuarios en un archivo de sobrescritura. Incluya 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 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.
[.gz]
Al enviar archivos a Amazon S3, utilice sólo compresión gzip. Cuando se comprimen, estos archivos obtienen la extensión .gz . No utilice compresión .zip.
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 de gran tamaño, es posible que podamos ayudarle a reducir el tamaño de los archivos y a aumentar la eficacia de las transferencias de datos. Consulte Compresión de archivos para archivos de transferencia de datos de entrada.

Ejemplos de nombres de archivo

Los siguientes ejemplos muestran nombres de archivo con el formato correcto. Los nombres de archivo podrían ser similares.
  • s3n://<AWS_Bucket>/<nombre_del_socio>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<nombre_del_socio>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<nombre_del_socio>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<nombre_del_socio>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<nombre_del_socio>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Puede descargar el archivo de muestra si desea obtener más ejemplos. Este archivo se ha guardado 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 / Amazon S3 .
Tipo de archivo Tamaño óptimo Tamaño máximo
Comprimido
200-300 MB
3 GB
Sin comprimir
1 GB
5 GB
El proceso de validación de datos de entrada marcará los archivos vacíos como no válidos y no los procesará.