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 obligatorios, la sintaxis, las convenciones de nomenclatura y los tamaños de archivo que debe seguir al enviar datos a Audience Manager. Establezca los nombres y tamaños de sus archivos de acuerdo con estas especificaciones cuando envíe datos a un Audience Manager directorio / Amazon S3 .
monospaced text
, cursiva , corchetes , etc.) de esta documento indican elementos y opciones de [ ]
( )
código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.Sintaxis del nombre Archivo file-name-syntax
S3 Los nombres de archivo contienen los siguientes elementos opcionales y obligatorios:
-
S3prefijo:
s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
-
Archivo elementos de nombre:
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Para conocer otros formatos de nombre de archivo aceptados, consulteIntegraciones personalizadas de socios.
Elementos de nombre
La tabla define los elementos de un S3 nombre de archivo.
AWS_directory
date=yyyy-mm-dd
DPID
Un LD que Audience Manager indica si un archivo de datos contiene sus propios ID de usuario, ID de Android, ID de iOS u otros ID que pertenecen a orígenes de datos globales. Acepta las siguientes opciones:
- ID de Origen de datos (también conocido como ID de proveedor de datos): es un ID único que Audience Manager asigna a un fuente de datos (consulte el índice Audience Manager de ID). 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 los Audience Manager que incorporen datos a identificadores pertenecientes al fuente de datos 21. - ID de Android (GAID): use el ID 20914 en el nombre de un archivo de datos si contiene ID de Android. Debe utilizar este campo
_DPID_TARGET_DATA_OWNER
cuando utilice ID de Android. Por ejemplo,...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync
indica a Audience Manager que el archivo de datos contiene solo ID de Android y que los ID deben calificar para las características pertenecientes al_DPID_TARGET_DATA_OWNER
fuente de datos. - ID de iOS (IDFA): use el ID 20915 en el nombre de un archivo de datos si contiene ID de iOS. Debe usar el campo
_DPID_TARGET_DATA_OWNER
cuando use ID de iOS. Por ejemplo,...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync
indica a Audience Manager que el archivo de datos contiene solo ID de iOS y que los ID deben cumplir los requisitos para las características pertenecientes al_DPID_TARGET_DATA_OWNER
fuente de datos. - ID pertenecientes a otras fuentes de datos globales: puede incorporar ID de Roku para publicidad (RIDA), ID de Microsoft Advertising (MAID) y otros ID. Utilice el ID correspondiente a cada fuente de datos, tal y como se describe en el artículo Fuentesde datos globales.
Nota: No mezcle tipos de ID en los archivos de datos. Por ejemplo, si su nombre de archivo incluye el identificador de Android, no coloque ID de iOS o sus propios ID en el archivo de datos.
_DPID_TARGET_DATA_OWNER
Este campo Audience Manager indica a qué fuente de datos incorporar los datos. Este campo es obligatorio si establece el DPID en un ID de Android o iOS ID u otro ID que pertenezca a fuentes de datos globales. Esto Audience Manager permite vincular los datos del archivo a su organización.
Este destino fuente de datos debe ser propiedad de su compañía. Para fines de intercambio de datos de segunda parte, para ingerir datos en una destino fuente de datos perteneciente a otra compañía, debe tener una asignación de acceso entre su compañía y la fuente de datos destino. Para configurar la asignación, póngase en contacto con su consultor Adobe Systems o con Asistencia al cliente.
Nota importante: No es necesario solicitud una asignación para las relaciones de uso compartido de datos existentes (para destino fuentes de datos pertenecientes a otras empresas en las que incorporó datos antes del 14 de marzo de 2022). La asignación tampoco es necesaria cuando se incorporan datos a fuentes de datos destino que pertenecen a su PID.
Por ejemplo:
...ftp_dpm_33_21_1234567890.sync
Audience Manager indica que reúne los requisitos para los ID de cliente pertenecientes al fuente de datos 33 para rasgos o señales pertenecientes al fuente de datos 21.- ID de Android (GAID):
...ftp_dpm_20914_21_1234567890.sync
Audience Manager indica que el archivo de datos contiene solo ID de Android y que los ID deben calificar para los rasgos pertenecientes a fuente de datos 21. - ID de iOS (IDFA):
...ftp_dpm_20915_21_1234567890.sync
Audience Manager indica que el archivo de datos contiene solo ID de iOS y que los ID deben calificar para los rasgos pertenecientes a fuente de datos 21. - ID pertenecientes a otras fuentes de datos globales:
...ftp_dpm_121963_21_1234567890.sync
Audience Manager indica que el archivo de datos contiene solo ID de Roku y que los ID deben calificar para los rasgos pertenecientes al fuente de datos 21. Utilice el ID correspondiente a cada fuente de datos, tal y como se describe en el artículo Fuentesde datos globales.
partner_name
TIMESTAMP
(.sync|.overwrite)
Opciones de sincronización que incluyen:
sync
: Situación normal en la que los proveedores de datos de terceros envían características por usuario para añadirlas o eliminarlas en el sistema Audience Manager.overwrite
: permite a los proveedores de datos enviar un lista de características por usuario que debería sobrescribir todas las características de terceros existentes de este usuario para este proveedor de datos en la Audience Manager. No es necesario incluir a todos los usuarios en un archivo de sobrescritura. Incluya solo aquellos usuarios que desee cambiar.
[SPLIT_NUMBER]
Un entero. Se utiliza al dividir archivos de gran tamaño en varias partes con el fin de mejorar los tiempos de procesamiento. El número indica qué parte del archivo original está enviando.
Para un procesamiento de archivos eficiente, divida sus archivos de datos como se indica:
- Sin comprimir: 1 GB
- Comprimido: 200-300 MB
Vea los primeros 2 ejemplos de nombres de archivo a continuación.
[.gz]
Cuando envíe archivos a Amazon S3, utilice solo la compresión gzip. Cuando se comprimen, estos archivos obtienen la .gz
extensión. No utilice 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 Audience Manager puede manejar archivos grandes, es posible que podamos ayudarlo a reducir el tamaño de sus archivos y hacer que las transferencias de datos sean más eficientes. Consulte Archivo Compresión para la transferencia de datos de entrada Archivos.
Archivo ejemplos de nombres file-name-examples
Los ejemplos siguientes muestran nombres de archivo con el formato correcto. Los nombres de archivo pueden 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 el archivo de muestra si desea más ejemplos. Este archivo se ha guardado con la extensión de .overwrite
archivo. Ábralo con un simple texto editor.
Tamaños de archivo aceptados accepted-file-sizes
Tenga en cuenta las cifras a continuación para el procesamiento más rápido / temprano de sus archivos, así como para las limitaciones de tamaño de archivo cuando envía datos a un Audience Manager directorio / Amazon S3 .
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 están excluidas de la transferencia.