Requisitos de nombre y contenido para archivos de sincronización de ID
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.
NOTEmonospaced 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.syncadobe_id_123_898_456_1454442149.sync.1.gzadobe_id_123_898_456_1454442149.sync.2.gzc2c_id_123_898_1454442149.sync.gz
NOTESintaxis 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.
IMPORTANTLa 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.