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 los archivos según estas especificaciones cuando envíe datos a un Audience Manager / Amazon S3 directorio.
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.
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 socios personalizadas.
Audience Manager solo procesos ASCII y UTF-8 archivos codificados.
La tabla define los elementos de una S3 nombre del archivo.
Elemento Nombre | Descripción |
---|---|
|
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. |
|
Marca de fecha y hora (según la hora UTC) del momento en el que se envían los archivos al compartimento S3. |
|
Un ID que indica 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 fuentes 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 inserte iOS ID o sus propios ID en el archivo de datos. |
|
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 Android ID o iOS ID 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. Nota importante: You 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 incorporó datos antes del 14 de marzo de 2022). La asignación tampoco es necesaria al incorporar datos a fuentes de datos de destino que pertenecen a su PID. Por ejemplo:
|
|
El nombre de empresa u organización que utilice en Audience Manager. |
|
Marca de tiempo UNIX UTC de 10 dígitos en segundos. La marca de tiempo ayuda a 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 los archivos, divida los archivos de datos como se indica:
Ver los dos primeros ejemplos de nombres de archivo más abajo. |
|
Cuando envíe archivos a Amazon S3, utilice solo compresión gzip. Cuando se comprime, estos archivos reciben la variable 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 a hacer que las transferencias de datos sean más eficientes. Consulte Compresión de archivos de transferencia de datos entrantes. |
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 seleccione el archivo de muestra si desea ver más ejemplos. Este archivo se ha guardado con la variable .overwrite
extensión de archivo. Ábrala con un editor de texto sencillo.
Tenga en cuenta las cifras siguientes 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 Audience Manager / Amazon S3 directorio.
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 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.