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 implementi A4T con Adobe Experience Platform Web SDK o con at.js.

Badge Adobe Experience Platform Web SDK Passaggi per l’implementazione di un’implementazione Adobe Experience Platform Web SDK

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

Passaggio 1: Richiedi il provisioning per Analytics e Target

Prima di implementare A4T, è 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. Vedi Requisiti delle autorizzazioni utente.

Passaggio 3: Creare una configurazione Edge

Creare una configurazione Edge utilizzando Adobe Experience Platform mediante lo strumento di configurazione del bordo. Configura le Analytics and Target impostazioni di configurazione del bordo.

Passaggio 4: Installare e configurare l’SDK per web di Platform

Per iniziare a consegnare Target esperienze e applicazione Analytics a fini di tracciamento e di analisi, Installa e configurare l’SDK per web di Platform sulle pagine del sito.

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

In Target Interfaccia utente, fai clic su Amministrazione > Compositore esperienza visivo, quindi scegli Seleziona per attività o Adobe Analytics.

  • **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

Badge at.js Passaggi di implementazione per un’implementazione at.js

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

Passaggio 1: Richiedere il provisioning per Analytics e Target

Dopo l’implementazione Analytics come origine per la generazione di rapporti per Target, è necessario effettuare 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 Analyticsattività basata su in Target. Vedi 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. Implementa o effettua la migrazione alla versione richiesta dell’ID visitatore di Experience Cloud. Per ulteriori informazioni, consulta “Requisiti di implementazione” in Prima dell’implementazione.

Vedi Implementazione del servizio Experience Cloud ID per Target in Servizio ID visitatore di Experience Cloud documentazione.

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, vedi Panoramica sull'implementazione JavaScript in Guida all’implementazione di Analytics.

Per una migrazione, vedi Migrazione ad AppMeasurement per JavaScript in 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: Host 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: Fai riferimento a at.js in 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>

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

L'impostazione predefinita per Target e Analytics Dal punto di vista dell'implementazione, l'integrazione consiste nell'utilizzare il codice SDID passato dalla pagina per unire Target e Analytics richiedi automaticamente insieme sul backend .

Puoi controllare come e quando inviare i dati di analisi relativi a Target a Analytics a fini di segnalazione. Se non desideri accettare le impostazioni predefinite di Target e Analytics unisce automaticamente i dati di analisi tramite 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 del Target per ogni richiesta vengono restituite richieste e un payload di Analytics. 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 il API di inserimento dati. Per le attività di Allocazione automatica e Targeting automatico, devi anche inoltrare l’ID sessione. Per ulteriori informazioni, consulta Reporting di Analytics for Target (A4T) nel SDK per Adobe Target guida.

Se non desideri usare un’impostazione globale e preferisci un approccio più on-demand, utilizza la funzione at.js getOffers() passando analyticsLogging: “client_side”. Il payload di Analytics viene restituito solo per questa chiamata e il Target il backend non inoltra il payload a Analytics. Con questo approccio, ogni at.js Target La richiesta restituisce il payload per impostazione predefinita, ma solo se 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 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

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

NOTA

Per il corretto funzionamento di A4T è necessaria la corrispondenza di questi valori.

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

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

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

In Target, fai clic su Amministrazione > Compositore esperienza visivo e scegli Seleziona per attività o Adobe Analytics per abilitare 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