Documentación Guía del servicio de identidad

Sincronización de ID por dirección URL o fuente de datos

Última actualización: 18 de julio de 2024

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

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

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