Documentación Guía del servicio de identidad

Sincronización de ID por dirección URL o fuente de datos id-synchronization-by-url-or-data-source

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Desarrollador
Usuario
Administrador
Líder

Las funciones del servicio de ID idSyncByURL e idSyncByDataSource le permiten implementar manualmente una sincronización de ID en el iFrame de publicación de destino. Están disponibles en VisitorAPI.js versión 1.10 o posterior.

Sintaxis, propiedades y macros section-90ac61617482463aaf4c57009b830332

Sintaxis

Código

Sincroniza los ID de usuario

visitor.idSyncByURL();

Entre diferentes socios de datos y Audience Manager mediante el uso de una URL de sincronización de ID personalizada.

visitor.idSyncByDataSource();

Cuando se conoce el DPID y el DPUUID, y se desea enviar a Audience Manager en el formato estándar de URL de sincronización de ID.

Propiedades

La tabla siguiente detalla y define las propiedades disponibles para ambas funciones.

Nombre

Tipo

Descripción

dpid

Cadena

ID del proveedor de datos asignado por el Audience Manager.

dpuuid

Cadena

ID único del proveedor de datos del usuario.

minutesToLive

Número

(Opcional) Establece el tiempo de caducidad de la cookie. Debe ser un número entero. El valor predeterminado es 20160 minutos (14 días).

url

Cadena

URL de destino.

Macros

Ambas funciones aceptan las siguientes macros:

%TIMESTAMP%: genera una marca de hora (en milésimas de segundo). Se emplea para ignorar la caché.
%DID%: inserta el ID de Audience Manager para el usuario.
%HTTP_PROTO%: establece el protocolo de comunicación (http o https).

Ejemplo de código y salida section-0115615c37584a19a2ab11e917c4e7e9

Las dos funciones devuelven Successfully queued si se realiza correctamente. Si no, devuelven una cadena con un mensaje de error.

visitor.idSyncByURL

Código de ejemplo

   //Instatiate Visitor
    var visitor = Visitor.getInstance
    ("MARKETING-CLOUD-ORG-ID-HERE",{});
   // Fires url with macros replaced
    visitor.idSyncByURL({
    dpid: '24', // must be a string
    url: '//su.addthis.com/red/usync?pid=16&puid=%DID%&url=%HTTP_PROTO%://
    dpm.demdex.net/ibs:dpid=420&dpuuid={{uid}}',
    minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Salida de ejemplo

http://su.addthis.com/red/usync?pid=16&puid=28777806459181003670799219185178493848&url=http%3A%2F%2Fdpm.demdex.net%2Fibs%3Adpid%3D420%26dpuuid%3D%7B%7Buid%7D%7D

visitor.idSyncByDataSource

Código de ejemplo

  //Instantiate Visitor
   var visitor = Visitor.getInstance
   ("MARKETING-CLOUD-ORG-ID-HERE",{});
  // Fires 'http:/https:' + '//dpm.demdex.net/ibs:dpid=&dpuuid='
   visitor.idSyncByDataSource({
     dpid: '24', // must be a string
     dp     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Salida de ejemplo

http://dpm.demdex.net/ibs:dpid=24&dpuuid=98765

recommendation-more-help

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a