Uso del servizio ID con A4T e implementazione lato server di Target using-the-id-service-with-a-t-and-a-server-side-implementation-of-target

Queste istruzioni sono per i clienti A4T con implementazioni miste lato server e client di Target, Analytics e del servizio ID. Dovranno essere consultate anche dai clienti che devono eseguire il servizio ID in un ambiente NodeJS o Rhino. Questa istanza del servizio ID utilizza una versione ridotta della libreria di codici VisitorAPI.js, che puoi scaricare e installare da Node Package Manager (NPM). Leggi questa sezione per le istruzioni di installazione e altri requisiti di configurazione.

Introduzione section-ab0521ff5bbd44c592c3eaab31c1de8b

I clienti A4T (e altri clienti) possono utilizzare questa versione del servizio ID per svolgere le seguenti funzioni:

Download del codice e interfacce fornite section-32d75561438b4c3dba8861be6557be8a

Per scaricare il pacchetto di codice lato server e rivedere le interfacce incluse nella build corrente, vai all’archivio NPM del servizio ID.

Flusso di lavoro section-56b01017922046ed96536404239a272b

Il diagramma e le sezioni seguenti descrivono cosa accade e cosa devi configurare in ciascuna fase del processo di implementazione lato server.

Passaggio 1: richiesta della pagina section-c12e82633bc94e8b8a65747115d0dda8

L'attività lato server inizia quando un visitatore effettua una richiesta HTTP per caricare una pagina Web. Il server riceve la richiesta e controlla il Cookie AMCV. Il cookie AMCV contiene l'identificatore Experience Cloud ID (MID) del visitatore.

Passaggio 2: generazione del payload del servizio ID section-c86531863db24bd9a5b761c1a2e0d964

Successivamente, devi effettuare una richiesta lato server payload request al servizio ID. Una richiesta di payload:

Di seguito puoi vedere un esempio di codice per la richiesta di payload. Nel codice di esempio, la funzione visitor.setCustomerIDs è opzionale. Consulta ID cliente e stati di autenticazione per ulteriori informazioni.

//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
});

Il servizio ID restituisce il payload in un oggetto JSON, simile all'esempio di seguito. I dati di payload sono necessari per Target.

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

Se il visitatore non ha un cookie AMCV, il payload omette queste coppie chiave-valore:

Passaggio 3: aggiunta del payload alla chiamata Target section-62451aa70d2f44ceb9fd0dc2d4f780f7

Una volta che il server ha ricevuto i dati di payload dal servizio ID, devi creare un'istanza di codice aggiuntivo per unirli ai dati passati a Target. L'oggetto JSON finale passato a Target sarà simile all'esempio di seguito:

{
"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,
     }
}

Passaggio 4: ottenimento dello stato del server per il servizio ID section-8ebfd177d42941c1893bfdde6e514280

I dati sullo stato del server contengono informazioni sul lavoro eseguito sul server. Il codice del servizio ID lato client richiede queste informazioni. I clienti che hanno implementato il servizio ID tramite Dynamic Tag Manager possono configurare Dynamic Tag Management per passare i dati sullo stato del server tramite tale strumento. Se hai impostato il servizio ID tramite una procedura non standard, dovrai fornire tu stesso il codice necessario per restituire lo stato del server. Il codice per il servizio ID lato client e Analytics trasmette ad Adobe i dati sullo stato del server al momento del caricamento della pagina.

Ottenere lo stato del server tramite Dynamic Tag Management

Se hai implementato il servizio ID con Dynamic Tag Management, devi aggiungere il codice alla pagina e specificare una coppia nome-valore nelle impostazioni Dynamic Tag Management.

Codice per la pagina

Aggiungi questo codice al tag <head> della pagina 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>
...

Impostazioni di Dynamic Tag Management

Aggiungi queste coppie nome-valore alla sezione Generali > Impostazioni della tua istanza del servizio ID:

Le impostazioni modificate saranno simili all'esempio di seguito:

Ottenere lo stato del server senza DTM

Se hai implementato il servizio ID in modo non standard, devi configurare questo codice da eseguire sul server mentre viene assemblata la pagina richiesta:

//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>
...

Passaggio 5: serving di una pagina e restituzione di dati Experience Cloud section-4b5631a0d75a41febd6f43f8c214c263

A questo punto, il server Web invia il contenuto della pagina al browser del visitatore. Da questo punto in poi, è il browser (e non il server) ad effettuare tutte le restanti chiamate al servizio ID e Analytics. Ad esempio, nel browser: