Implementazione di Analytics for Target

Durante l'implementazione di Adobe Analytics come origine di reporting per Target (A4T) sono necessari diversi passaggi.

Passaggi di implementazione

Le sezioni seguenti descrivono i passaggi necessari per implementare questa integrazione nel sito.

Passaggio 1: Richiesta di provisioning per Analytics e Target

Dopo aver implementato Analytics come origine di reporting per Target, è necessario eseguire il provisioning per Analytics e Target. Utilizza questo modulo per richiedere il provisioning.

Passaggio 2: Configurare le autorizzazioni utente

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

Passaggio 3: Implementare il servizio ID visitatore di Experience Cloud

Il servizio ID visitatore consente di identificare gli utenti attraverso le diverse soluzioni Adobe Experience Cloud. È necessario implementare o eseguire la migrazione alla versione richiesta del servizio ID visitatore di Experience Cloud. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

Consulta Implementazione del servizio ID Experience Cloud per Target nella Servizio ID visitatore del Experience Cloud documentazione.

Passaggio 4: Aggiornare AppMeasurement per JavaScript o s_code

È necessario implementare o eseguire la migrazione alla versione richiesta di appMeasurement.js. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

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

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

Passaggio 5: Scarica e aggiorna at.js

Devi implementare o migrare 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: Host at.js

Se hai precedentemente distribuito at.js, 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: Riferimento a at.js su tutte le pagine del sito

Includi at.js sotto VisitorAPI.js aggiungendo la seguente riga di codice nel 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>

È essenziale che VisitorAPI.js venga caricato prima di at.js. Se state aggiornando un file at.js o mbox.js esistente, accertatevi di verificare l'ordine di caricamento.

Il modo in cui le impostazioni predefinite sono configurate per l'integrazione Target e Analytics da un punto di vista di implementazione consiste nell'utilizzare il codice SDID passato dalla pagina per unire automaticamente sul back-end la richiesta Target e Analytics.

Tuttavia, se si desidera un maggiore controllo su come e quando inviare i dati di analisi relativi a Target a Analytics a scopo di reporting, e non si desidera optare per le impostazioni predefinite di Target e Analytics unire automaticamente i dati di analisi tramite SDID, è possibile impostare 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. In altre parole, con ogni chiamata effettuata da at.js, analyticsLogging: "client_side" verrà inviato all’interno delle richieste e per ogni richiesta viene restituito un payload di Analytics. Target Con questa impostazione, il formato del payload restituito sarà simile a quello riportato di seguito:

"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. Tenere presente che, per le attività Auto-Allocate e Auto-Target sarà necessario inoltrare anche sessionId. Per ulteriori informazioni, vedi Analytics for Target (A4T) reporting nella Adobe Target SDKs guida.

Se non desideri usare un’impostazione globale a favore di un approccio di tipo on-demand, puoi utilizzare la funzione at.js getOffers() per ottenere lo stesso risultato passando la chiamata analyticsLogging: "client_side". Il payload di analisi verrà restituito solo per questa chiamata e il Target backend non inoltrerà il payload a Analytics. Seguendo questo approccio, ogni richiesta at.js Target non restituirà 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

Carica le pagine dopo aver aggiornato le librerie JavaScript per confermare che i valori dei parametri mboxMCSDIDTarget nelle chiamate di corrispondano al valore del parametro sdidAnalytics nella chiamata di visualizzazione della pagina

Tale conferma è particolarmente importante in applicazioni a pagina singola (SPA) in cui l’ordine delle chiamate non è sempre prevedibile.

Nota: la corrispondenza di questi valori è necessaria per il corretto funzionamento di A4T.

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

È consigliabile rimuovere l’integrazione precedente per semplificare l’implementazione ed eliminare la necessità di risolvere eventuali discrepanze tra i sistemi. Puoi rimuovere eventuale codice che potrebbe essere stato 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, fate clic su Amministrazione > Visual Experience Composer (Compositore esperienza visivo) e scegliete Seleziona per attività o Adobe Analytics per attivare le opzioni.

  • **Seleziona per attività consente di scegliere tra e per la creazione di ogni attività.**TargetAnalytics
  • **Adobe imposta Analytics come origine dei rapporti per tutte le attività che hai creato.**Analytics

In questa pagina