Uso del servicio ID con A4T y una implementación de Target en el lado del servidor using-the-id-service-with-a-t-and-a-server-side-implementation-of-target

Estas instrucciones están destinadas a los clientes de A4T con implementaciones mixtas del lado del servidor y del cliente de Target, Analytics y el servicio de ID. Los clientes que necesiten ejecutar el servicio de ID en un entorno NodeJS o Rhino también deben consultar esta información. Esta instancia del servicio de ID utiliza una versión abreviada de la biblioteca de códigos VisitorAPI.js, que se descarga e instala desde el administrador de paquetes de nodos (NPM). Lea esta sección para obtener instrucciones de instalación y otros requisitos de configuración.

Introducción section-ab0521ff5bbd44c592c3eaab31c1de8b

A4T (y otros clientes) pueden utilizar esta versión del servicio de ID cuando necesiten:

Descarga de código e interfaces proporcionadas section-32d75561438b4c3dba8861be6557be8a

Consulte el repositorio NPM del servicio de ID para descargar el paquete de código del lado del servidor y ver las interfaces que se incluyen en la versión actual.

Flujo de trabajo section-56b01017922046ed96536404239a272b

El diagrama y las secciones que siguen describen qué ocurre y qué debe configurar en cada paso del proceso de implementación del lado del servidor.

Paso 1: Solicitar página section-c12e82633bc94e8b8a65747115d0dda8

La actividad del lado de servidor comienza cuando un visitante realiza una solicitud HTTP para cargar una página web. En este paso, el servidor recibe la solicitud y comprueba la cookie de Cookie AMCV. La cookie AMCV contiene el ID de Experience Cloud (MID).

Paso 2: Generación de la carga útil del servicio de ID section-c86531863db24bd9a5b761c1a2e0d964

A continuación, debe realizar una payload request del lado del servidor en el servicio de ID. Una solicitud de carga útil:

Su solicitud de carga útil deberá ser como el ejemplo de código que sigue: En el ejemplo del código, la función visitor.setCustomerIDs es opcional. Consulte ID de cliente y estados de autenticación para obtener más información.

//Import the ID service server package
var Visitor = require("@adobe-mcid/visitor-js-server");

//Pass in your Organization ID to instantiate Visitor
var visitor = new Visitor("Insert Experience Cloud ID here");

//
<i>(Optional)</i> Set a custom customer ID
visitor.setCustomerIDs({
     userid:{
          id:"1234",
          authState: Visitor.AuthState.UNKNOWN //AuthState is a static property of the Visitor class
     }
});

//Parse the visitor's HTTP request for the AMCV cookie
var cookies = cookie.parse(req.headers.cookie || "");
var cookieName = visitor.getCookieName(); // Visitor API that returns the cookie name.
var amcvCookie = cookies[cookieName];

//Generate the payload request pass your mbox name and the AMCV cookie if present
var visitorPayload = visitor.generatePayload({
     mboxName: "bottom-banner-mbox",
     amcvCookie: amcvCookie
});

El servicio de ID devuelve la carga útil en un objeto JSON parecido al ejemplo siguiente. Los datos de carga útil los necesita Target.

{
    "marketingCloudVisitorId": "02111696918527575543455026275721941645",
    "mboxParameters": {
        "mboxAAMB": "abcd1234",
        "mboxMCGLH": "9",
        "mboxMCSDID": "56BE026543F7E211-1CC51BCAAE88F0D2",
        "vst.userid.id": "1234567890",
        "vst.userid.authState": 0
    }
}

Si su visitante no tiene una cookie de AMCV, la carga útil omite estos pares clave-valor:

Paso 3: Adición de la carga útil a la llamada de Target section-62451aa70d2f44ceb9fd0dc2d4f780f7

Una vez que el servidor recibe los datos de carga útil del servicio de ID, deberá crear una instancia de código adicional para fusionarla con los datos transferidos a Target. El objeto JSON final transferido a Target tendría un aspecto similar a este:

{
"mbox" : "target-global-mbox",
"marketingCloudVisitorId":"02111696918527575543455026275721941645",
"requestLocation" : {
     "pageURL" : "http://www.domain.com/test/demo.html",
     "host" : "localhost:3000"
     },
"mboxParameters" : {
     "mboxAAMB" : "abcd1234",
     "mboxMCGLH" : "9",
     "mboxMCSDID": "56BE026543F7E211-1CC51BCAAE88F0D2",
     "vst.userid.id": "1234567890",
     "vst.userid.authState": 0,
     }
}

Paso 4: Obtención del estado del servidor para el servicio de ID section-8ebfd177d42941c1893bfdde6e514280

Los datos de estado del servidor contienen información sobre el trabajo realizado en el servidor. El código de servicio de ID del lado del cliente requiere esta información. Los clientes que han implementado el servicio de ID a través de Dynamic Tag Manager (DTM) pueden configurar DTM para transferir los datos del estado del servidor a través de esa herramienta. Si ha configurado el servicio de ID por medio de un proceso no estándar, deberá devolver el estado del servidor con su propio código. El servicio de ID del lado de cliente y el código de Analytics transfieren los datos de estado a Adobe al cargarse la página.

Obtención del estado del servidor a través de DTM

Si ha implementado el servicio de ID con DTM, debe agregar código a su página y especificar un par nombre-valor en la configuración de DTM.

Código de página

Agregue este código a la etiqueta <head> de su página HTML:

//Get server state
var serverState = visitor.getState();

Response.send("
...
<head>
     <script>
          //Add 'serverState' as a stringified JSON global variable.
          "var serverState = "+ JSON.stringify(serverState) +";
     </script>
     <script src = "DTM script (satellite JS)">
     </script>
</head>
...

Ajustes de configuración de DTM

Agregue estos pares nombre-valor a la sección General > Configuración de su instancia del servicio de ID:

La configuración debe ser similar a la siguiente:

Obtención del estado del servidor sin DTM

Si su implementación del servicio de ID es estándar, debe configurar este código para que se ejecute en el servidor mientras monta la página solicitada:

//Get server state
var serverState = visitor.getState();

Response.send("
...
<head>
     <script src="VisitorAPI.js"></script>
     <script>
          var visitor = Visitor.getInstance(orgID, {
          serverState: serverState
          ...
     </script>
</head>
...

Paso 5: Servicio de una página y devolución de datos de Experience Cloud section-4b5631a0d75a41febd6f43f8c214c263

En este punto, el servidor web envía el contenido de la página al navegador del visitante. A partir de este punto, el navegador (no el servidor) realiza el resto de las llamadas del servicio de ID y de Analytics. Por ejemplo, en el explorador: