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

Describe los campos obligatorios, la sintaxis y las convenciones de nomenclatura utilizadas para la sincronización de ID basada en archivos. Asigne un nombre y organice el contenido del archivo según estas especificaciones.

NOTA

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.

Sintaxis y ejemplos del nombre de archivo

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

[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 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 principal es el ID principal de los DPID en el nombre del archivo. Además, el primer ID de usuario del archivo de datos corresponde al ID maestro. Los DPID posteriores son otros identificadores que pertenecen al maestro. La sincronización asigna los DPID del nombre del archivo a los UUID del archivo.

Este DPID solo debe contener ID de dispositivo, como AAM UUID, GAID, IDFA, etc. 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 con el DPID maestro. La sincronización asigna los DPID del nombre del archivo a los UUID del archivo.

El número de DPID del nombre del 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 DPIDs. El archivo de datos debe incluir 4 columnas correspondientes de UUID, con el formato que se describe en la sección de contenido del archivo a continuación.

timestamp

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 cuando se dividen 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 nombres de archivo que aparecen a continuación.

[.gz]

Especifica que el archivo está comprimido 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 tener un aspecto similar.

  • 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
NOTA

Para la nomenclatura de archivos de sincronización de ID (prefijo c2c) para destinos basados en personas, consulte Flujo de trabajo A: personalización basada en toda la actividad en línea combinada con datos sin conexión o Flujo de trabajo B: personalización basada 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 ID de usuario (UUID). En cada fila, separe los ID con una pestaña . En el siguiente ejemplo se muestra un archivo de ID con el formato correcto. Su contenido puede tener un aspecto similar.

abc123 def456 ghi789 xyz987

Consideraciones sobre el contenido del archivo

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

IMPORTANTE

No utilice DPUUIDs en la primera columna. Al hacerlo, la sincronización puede ser incorrecta.

La sincronización coincide con los DPUUID en UUID

El propósito de un archivo de sincronización de ID es sincronizar los DPUUIDs desde sus propias fuentes de datos con Audience Manager UUID. La sincronización asigna los DPUUIDs desde el DPID maestro y sus DPIDs relacionados a los Audience Manager UUIDs. El lugar donde coloque los ID en el nombre y el cuerpo del archivo 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


Dados el nombre y el contenido de la muestra, los ID se asignan de esta manera:

Archivo 1 ( Descargar archivo de muestra)

DPID 0 = UID de Adobe Audience Manager DPID 12345
68079982765673198504052656074456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
67412682083411995725538770443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
6618477822667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Paso 1: el proceso de sincronización de ID sincronizará DPUUIDs desde DPID 12345 con Audience Manager UUIDs en la columna izquierda. Tenga en cuenta que DPID "0" en el nombre del 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 DPUUIDs de DPID 12345 se han sincronizado en el paso 1 con el Audience Manager UUIDs. Lo que hará esta sincronización de ID es sincronizar los DPUUIDs desde DPID 67890 con el Audience Manager UUIDs desde el 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.
  • Incluir información de identificación personal (PII).
  • Utilice la codificación URL. Pasa solo ID no codificados.

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

En esta página