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 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.
S3 los nombres de archivo contienen los siguientes elementos opcionales y requeridos:
S3prefix: 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.
La tabla define los elementos de un nombre de archivo S3.
Elemento Nombre | Descripción |
---|---|
|
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. |
|
Marca de hora (según la hora UTC) del momento en que se envían los archivos al bucket S3. |
|
Un lD que indica a Audience Manager si un archivo de datos contiene sus propios ID de usuario, ID de Android, ID de iOS u otros ID pertenecientes a orígenes de datos globales. Acepta las siguientes opciones:
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. |
|
Este campo indica al Audience Manager el origen de datos al que desea incluir los datos. Este campo es obligatorio si establece el DPID en un ID de Android o iOS u otro ID que pertenezca a fuentes de datos globales. Esto permite que Audience Manager vincule los datos del archivo a su organización. Por ejemplo:
|
|
El nombre de la compañía o organización que utiliza en Audience Manager. |
|
Marca de hora UNIX de 10 dígitos en segundos. La marca de tiempo ayuda a hacer que cada nombre de archivo sea único. |
|
Opciones de sincronización que incluyen:
|
|
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:
Consulte los primeros 2 ejemplos de nombres de archivo a continuación. |
|
Al enviar archivos a Amazon S3, utilice sólo compresión gzip. Cuando se comprimen, estos archivos obtienen la extensión 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 los archivos y aumentar la eficacia de las transferencias de datos. Consulte Compresión de archivos de transferencia de datos entrantes. |
Los siguientes ejemplos muestran nombres de archivo con el formato correcto. Los nombres de archivo podrían ser similares.
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 obtener más ejemplos. Este archivo se ha guardado con la extensión .overwrite
. Ábralo con un editor de texto sencillo.
Tenga en cuenta las siguientes cifras para un procesamiento más rápido y más temprano de los archivos, así como para las limitaciones de tamaño de los archivos cuando envíe 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á.
Los archivos de datos entrantes tienen un límite de longitud de línea de 102400 bytes. Las líneas que superen este límite se excluirán de la transferencia.