Amazon S3 requisitos de nombre y tamaño de archivo para archivos de datos de entrada amazon-s-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 / Amazon S3 directorio.
monospaced text
, cursiva, paréntesis [ ]
( )
, etc.) en este documento, indique los elementos y las opciones de código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.Sintaxis del nombre del archivo file-name-syntax
S3 los nombres de archivo contienen los siguientes elementos obligatorios y opcionales:
-
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.
Elementos de nombre
La tabla define los elementos de una S3 nombre de archivo.
AWS_directory
date=yyyy-mm-dd
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
cuenta Audience Manager para incorporar datos a ID que pertenezcan a la fuente de datos 21. - ID de Android (GAID): Utilice 20914 de ID en un nombre de archivo de datos si contiene ID de Android. Debe utilizar el campo
_DPID_TARGET_DATA_OWNER
al usar ID de Android. Por ejemplo,...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync
cuenta Audience Manager Compruebe que el archivo de datos contiene únicamente ID de Android y que los ID deben cumplir los requisitos para los rasgos pertenecientes a_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, tal como se describe en la artículo de fuentes de datos globales.
Nota: No mezcle tipos de ID en los archivos de datos. Por ejemplo, si el nombre de archivo incluye el identificador de Android, no coloque iOS ID o sus propios ID en el archivo de datos.
_DPID_TARGET_DATA_OWNER
Este campo indica al Audience Manager a qué fuente de datos incorporar los datos. Este campo es obligatorio si establece el DPID en un ID de Android, en un ID de iOS u otro ID que pertenezca a fuentes de datos globales. Esto permite al Audience Manager vincular los datos del archivo de nuevo a su organización.
La fuente de datos de destino debe ser propiedad de la empresa. Para compartir datos de segundo nivel, para introducir datos en una fuente de datos de destino perteneciente a otra empresa, debe tener una asignación de acceso entre su empresa y la fuente de datos de destino. Póngase en contacto con su asesor de Adobe o con Asistencia 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.
partner_name
TIMESTAMP
(.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 que los proveedores de datos envíen una lista de características por usuario que deben sobrescribir todas las características de terceros existentes 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. Incluya solo a los usuarios que desee cambiar.
[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.
[.gz]
Al enviar archivos a Amazon S3, utilice solo la compresión gzip. Cuando se comprimen, estos archivos obtienen el .gz
extensión. No utilice la 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 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.
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 ejemplos adicionales. Este archivo se ha guardado con el .overwrite
extensión de archivo. Ábralo con un editor de texto simple.
Tamaños de archivo admitidos accepted-file-sizes
Tenga en cuenta las figuras siguientes para el procesamiento más rápido/más temprano de sus archivos, así como para las limitaciones de tamaño de archivo al enviar datos a un Audience Manager / Amazon S3 directorio.
Límites de longitud de línea line-limits
Los archivos de datos de entrada tienen un límite de longitud de línea de 102400 bytes. Las líneas que excedan este límite se excluirán de la transferencia.