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

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
     dpuuid: '98765', // must be a string 
     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Salida de ejemplo

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

En esta página