Documentación Audience Manager Guía del usuario de Audience Manager

Requisitos de nombre y contenido para archivos de sincronización de ID

20 de julio de 2024

Temas:

Describe los campos, sintaxis y convenciones de nomenclatura requeridos que se usan para la sincronización de ID basada en archivos. Asigne un nombre al archivo y organícelo según estas especificaciones.

NOTE

Estilos de texto (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 y ejemplos del nombre del archivo

Los nombres de archivo de ID contienen los siguientes elementos obligatorios y opcionales:

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Parámetro

Descripción

adobe_id

Prefijo estático que identifica el archivo como archivo de sincronización de ID. Utilice este prefijo cuando combine los ID de dispositivo con otros ID de dispositivo o ID de cliente (DPUUID).

c2c_id

Prefijo estático que identifica el archivo como archivo de sincronización de ID para destinos basados en personas. Utilice este prefijo al hacer coincidir los ID de cliente (DPUUID) con las direcciones de correo electrónico con hash para los destinos basados en personas.

MASTERDPID

El ID del proveedor de datos maestro es el ID principal de los DPID del nombre del archivo. Además, el primer ID de usuario del archivo de datos corresponde al ID de maestro. Los DPID subsiguientes son otros identificadores que pertenecen al maestro. La sincronización asigna los DPID del nombre de archivo a los UUID del archivo.

AAM Este DPID solo debe contener ID de dispositivo, como UUID, GAID, IDFA, etc. de la. No puede contener DPUUID. Al hacerlo, la sincronización puede ser incorrecta.

DPID

ID del proveedor de datos. Estos ID representan entidades o fuentes de datos asociadas al DPID maestro. La sincronización asigna los DPID del nombre de archivo a los UUID del archivo.

El número de DPID del nombre de archivo debe coincidir con el número de UUID del archivo de datos. Por ejemplo, supongamos que su nombre de archivo contiene un DPID maestro y 3 DPID. El archivo de datos debe incluir 4 columnas correspondientes de UUID, con el formato descrito en la sección de contenido del archivo a continuación.

timestamp

Una marca de tiempo UNIX de 10 dígitos en segundos. La marca de tiempo ayuda a que cada nombre de archivo sea único.

.sync

Indica una sincronización normal y completa.

[.SPLIT_NUMBER]

Un entero. Se utiliza al dividir archivos grandes en varios archivos más pequeños. Esto ayuda a mejorar los tiempos de procesamiento. El número indica qué parte del archivo original está enviando. Consulte los ejemplos de nombre de archivo a continuación.

[.gz]

Especifica que el archivo se comprime con compresión gzip opcional.

Ejemplos de nombres de archivo

Los siguientes ejemplos muestran nombres de archivos con el formato correcto. Sus nombres de archivo podrían ser similares.

adobe_id_111_222_333_444_1454442149.sync
adobe_id_123_898_456_1454442149.sync.1.gz
adobe_id_123_898_456_1454442149.sync.2.gz
c2c_id_123_898_1454442149.sync.gz

NOTE

Para obtener la nomenclatura de archivos de sincronización de ID (prefijo c2c) para destinos basados en personas, consulte Flujo de trabajo A: Personalization basado en toda la actividad en línea combinada con datos sin conexión o Flujo de trabajo B: Personalization basado en datos solo sin conexión.

Sintaxis del contenido del archivo y ejemplos

El contenido de un archivo de ID incluye los siguientes elementos:

UUID <tab>UUID<tab>UUID<tab>UUID

El archivo contiene los identificadores de usuario (UUID). En cada fila, separe los ID con una pestaña. El siguiente ejemplo muestra un archivo de ID con el formato correcto. Su contenido podría ser similar.

abc123 def456 ghi789 xyz987

Consideraciones sobre contenido de archivo

Al crear los archivos de entrada, asegúrese de que la primera columna solo se rellena con identificadores de dispositivo, como AAM UUID, GAID, IDFA, etc. Consulte Índice de IDs en Audience Manager para obtener una explicación detallada de los IDs admitidos por Audience Manager.

IMPORTANT

No use DPUUID en la primera columna. Al hacerlo, la sincronización puede ser incorrecta.

La sincronización hace coincidir DPUUID con UUID

El propósito de un archivo de sincronización de ID es sincronizar los DPUUID de sus propias fuentes de datos con Audience Manager UUID. La sincronización asigna los DPUUIDs del elemento principal DPID y sus DPIDs relacionados al elemento Audience Manager UUID. La ubicación de los ID en el nombre de archivo y en el cuerpo determina cómo se asignan estos identificadores entre sí. Por ejemplo, tome los dos archivos de ejemplo que se muestran aquí:

Archivo 1: adobe_id_0_12345_1476312152.sync
Archivo 2: adobe_id_12345_67890_1476312876.sync

Dado el nombre y el contenido del ejemplo, los ID se asignan de esta manera:

Archivo 1 ( Descargar archivo de muestra)

DPID 0 = UUID de Adobe Audience Manager

12345 DPID

68079982765673198504052656074456196039

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38

67412682083411995725538770443620307584

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

89159024796760343733111707646026765593

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

66552757407517449462805881945288602094

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

66184778222667870903738139438735041506

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Paso 1: el proceso de sincronización de ID sincronizará los DPUUIDs de DPID 12345 con Audience Manager UUIDs en la columna izquierda. Tenga en cuenta que DPID "0" en el nombre de archivo representa Audience Manager UUIDs.

Archivo 2 ( Descargar archivo de muestra)

DPID 12345

DPID 67890

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38

4598060374

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

4581274262

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

4392434426

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

2351382994

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

4601584763

Paso 2: los 12345 DPUUIDs de DPID se han sincronizado en el paso 1 con el Audience Manager UUIDs. Lo que esta sincronización de ID hará es sincronizar los DPUUIDs de DPID 67890 con el Audience Manager UUIDs del paso 1.

Otros requisitos de formato

Los ID de usuario no pueden:

Tiene pestañas en el propio ID. Las pestañas solo se utilizan para separar ID individuales en el archivo de datos.
Contener información personal identificable (PII).
Utilizar la codificación URL. Pasar solo ID sin codificar.

Las filas que terminen con tabulaciones o espacios no se procesarán ni realizarán. Como regla general, asegúrese de mantener el final de las filas despejado.

recommendation-more-help