Implementazione di Analytics per Target

Sono necessari diversi passaggi per implementare Adobe Analytics come origine per la generazione di rapporti per Adobe Target (A4T). Il processo varia a seconda che tu implementi A4T con Adobe Experience Platform Web SDK o con at.js.

Passaggi per l'implementazione di Adobe Experience Platform Web SDK platform

Le sezioni seguenti descrivono i passaggi necessari per distribuire questa integrazione al sito se intendi utilizzare Platform Web SDK:

Passaggio 1: richiesta del provisioning per Analytics e Target

Prima di implementare A4T, è necessario disporre del provisioning per Analytics e Target. Utilizzare questo modulo per richiedere il provisioning.

Passaggio 2: Configurare le autorizzazioni utente

I requisiti dell'account utente devono essere soddisfatti prima di creare un'attività basata su Analytics in Target. Consulta Requisiti delle autorizzazioni utente.

Passaggio 3: creare una configurazione di Edge

Creare una configurazione di Edge utilizzando Adobe Experience Platform utilizzando lo strumento di configurazione Edge. Configura Creare e configurare gli stream di dati.

Passaggio 4: installare e configurare Platform Web SDK

Per iniziare a distribuire Target esperienze e applicare Analytics a scopo di monitoraggio e analisi, Installa e configura Platform Web SDK nelle pagine del sito.

Passaggio 5: abilitare le opzioni per l’utilizzo di A4T

Nell'interfaccia utente di Target, fare clic su Administration > Visual Experience Composer, quindi scegliere Select per activity o Adobe Analytics.

Passaggi per l'implementazione di at.js section_73961BAD5BB4430A95E073DE5C026277

Le sezioni seguenti descrivono i passaggi necessari per distribuire questa integrazione al sito se intendi utilizzare at.js:

Passaggio 1: richiesta del provisioning per Analytics e Target

Dopo aver implementato Analytics come origine per la generazione di rapporti per Target, è necessario disporre del provisioning per Analytics e Target. Utilizzare questo modulo per richiedere il provisioning.

Passaggio 2: Configurare le autorizzazioni utente

I requisiti dell'account utente devono essere soddisfatti prima di creare un'attività basata su Analytics in Target. Consulta Requisiti delle autorizzazioni utente.

Passaggio 3: Implementare il servizio ID visitatore di Experience Cloud

Il servizio ID visitatore consente di identificare gli utenti nelle soluzioni Adobe Experience Cloud. Implementa o esegui la migrazione alla versione richiesta dell’ID visitatore Experience Cloud. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

Consulta Implementare il servizio ID Experience Cloud per Target nella documentazione del servizio ID visitatore Experience Cloud.

Passaggio 4: Aggiornare AppMeasurement per JavaScript o s_code

Implementa o esegui la migrazione alla versione richiesta di appMeasurement.js. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

Per le nuove implementazioni, consulta Panoramica sull'implementazione di JavaScript nella Guida all'implementazione di Analytics.

Per una migrazione, vedere Migrazione ad AppMeasurement per JavaScript nella Guida all'implementazione di Analytics.

Passaggio 5: Scaricare e aggiornare at.js

Implementa o esegui la migrazione alla versione richiesta di at.js utilizzando il tuo account di produzione. Non sono richieste modifiche al codice.

Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

Passaggio 6: Hosting di at.js

Se at.js è stato distribuito in precedenza, puoi sostituire il file esistente con la versione aggiornata. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

In caso contrario, il file può essere incluso in hosting insieme al servizio ID visitatore e AppMeasurement per file JavaScript. Questi file devono essere in hosting su un server web accessibile a tutte le pagine del sito. È necessario definire il percorso di questi file nella fase successiva.

Passaggio 7: Includere un riferimento a at.js in tutte le pagine del sito step7

Includi at.js sotto VisitorAPI.js aggiungendo la seguente riga di codice al tag in ogni pagina:

Per at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

VisitorAPI.js deve essere caricato prima di at.js. Se stai aggiornando un file at.js esistente, accertati di verificare l’ordine di caricamento.

L'impostazione predefinita per l'integrazione di Target e Analytics, dal punto di vista dell'implementazione, consiste nell'utilizzare l'identificatore SDID passato dalla pagina per unire automaticamente nel backend le richieste di Target e Analytics.

È possibile controllare come e quando inviare i dati di analisi relativi a Target a Analytics a scopo di reporting. Se non desideri fornire il consenso alle impostazioni predefinite per l'unione automatica di Target e Analytics dei dati di analisi tramite l'identificatore SDID, imposta analyticsLogging = client_side tramite window.targetGlobalSettings. Nota: questo approccio non è supportato dalle versioni precedenti alla versione 2.1.

Ad esempio:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Questa configurazione ha un effetto globale, il che significa che ogni chiamata effettuata da at.js ha analyticsLogging: "client_side" inviato all'interno delle richieste Target e viene restituito un payload di Analytics per ogni richiesta. Quando questa opzione è impostata, il formato del payload restituito è simile al seguente:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

Il payload può quindi essere inoltrato ad Analytics tramite l'API di inserimento dati. Per le attività Allocazione automatica e Targeting automatico, devi anche inoltrare il sessionId. Per ulteriori informazioni, consulta Generazione rapporti di Analytics for Target (A4T) nella guida SDK per Adobe Target.

Se non desideri usare un'impostazione globale e preferisci un approccio di tipo on-demand, usa la funzione at.js getOffers() passando analyticsLogging: "client_side". Il payload di Analytics viene restituito solo per questa chiamata e il backend Target non inoltra il payload a Analytics. Seguendo questo approccio, ogni richiesta di at.js Target restituisce il payload per impostazione predefinita, ma solo quando desiderato e specificato.

Ad esempio:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Questa chiamata richiama una risposta dalla quale è possibile estrarre il payload di Analytics.

La risposta si presenta come segue:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

Il payload può quindi essere inoltrato a Analytics tramite l'API di inserimento dati.

Passaggio 8: Convalidare l’implementazione step8

Carica le pagine dopo aver aggiornato le librerie JavaScript per confermare che i valori dei parametri mboxMCSDID nelle chiamate Target corrispondano al valore del parametro sdid nella chiamata di visualizzazione pagina Analytics.

È particolarmente importante confermare che questi valori corrispondano nelle applicazioni a pagina singola (SPA) in cui l’ordine delle chiamate non è sempre prevedibile.

Passaggio 9: (Facoltativo) Rimuovere il codice di integrazione precedente

L’Adobe consiglia di rimuovere l’integrazione precedente per semplificare l’implementazione ed eliminare la necessità di risolvere eventuali discrepanze tra i sistemi. È possibile rimuovere il codice distribuito da una precedente integrazione tra SC e T&T, incluso mboxLoadSCPlugin.

Passaggio 10: Abilitare le opzioni per l’utilizzo di Analytics come origine per la creazione di rapporti per Target

In Target, fare clic su Administration > Reporting e scegliere Select per activity o Adobe Analytics per abilitare le opzioni.