Migrare da AppMeasurement a Web SDK

Creare uno stream di dati in Raccolta dati di Adobe Experience Platform. Quando invii dati a questo stream di dati, questi vengono inoltrati ad Adobe Analytics. In futuro, lo stesso flusso di dati inoltra i dati al Customer Journey Analytics.

1. Passa a experience.adobe.com e accedi con le tue credenziali.
2. Utilizzare la home page o il selettore di prodotti in alto a destra per passare a Data Collection.
3. Nel menu di navigazione a sinistra, selezionare Datastreams.
4. Seleziona New Datastream.
5. Immettere il nome desiderato, quindi selezionare Save.
6. Una volta creato lo stream di dati, selezionare Add Service.
7. Nel menu a discesa del servizio, selezionare Adobe Analytics.
8. Immetti lo stesso ID suite di rapporti del sito a cui invii attualmente i dati di analisi. Fai clic su Save.

Il flusso di dati è ora pronto per ricevere e trasmettere dati ad Adobe Analytics. Prendi nota dell’ID dello stream di dati, in quanto questo ID è richiesto durante la configurazione dell’SDK web nel codice.

Configurare l'implementazione in modo che punti allo stream di dati creato nel passaggio precedente utilizzando il comando Web SDK configure. Il comando configure deve essere impostato su ogni pagina, in modo da poterlo includere insieme al codice di installazione della libreria.

Utilizzare le proprietà edgeConfigId e orgId all'interno del comando configure dell'SDK Web:

• Imposta edgeConfigId sull'ID dello stream di dati recuperato dal passaggio precedente.
• Imposta orgId per l'organizzazione IMS della tua organizzazione.

alloy("configure", {
    "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
    "orgId": "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Facoltativamente, è possibile impostare altre proprietà nel comando configure in base ai requisiti di implementazione della propria organizzazione.

Modificare l'implementazione di Analytics in modo che non si basi su AppMeasurement.js o sull'oggetto s. Imposta invece le variabili in un oggetto JavaScript formattato correttamente, che viene convertito in un oggetto JSON quando viene inviato a Adobe. Disporre di un livello dati sul sito è molto utile quando si impostano i valori, in quanto è possibile continuare a fare riferimento agli stessi valori.

Per inviare dati ad Adobe Analytics, il payload dell'SDK Web deve utilizzare data.__adobe.analytics con tutte le variabili di analisi impostate all'interno di questo oggetto. Le variabili all'interno di questo oggetto condividono nomi e formati identici come controparti AppMeasurement di variabili. Ad esempio, se imposti la variabile products, non suddividerla in singoli oggetti come si farebbe con XDM. Invece, includila come stringa esattamente se imposti la variabile s.products:

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

Questo payload contiene tutti i valori desiderati e tutti i riferimenti all'oggetto s nell'implementazione vengono rimossi. Puoi utilizzare una qualsiasi delle risorse fornite da JavaScript per impostare questo oggetto payload, inclusa la notazione del punto per impostare i singoli valori.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

Aggiorna tutte le istanze in cui chiami s.t() e s.tl(), sostituendole con il comando sendEvent. Ci sono tre scenari da considerare:

• Tracciamento visualizzazione pagina: sostituisci la chiamata di tracciamento visualizzazione pagina con il comando sendEvent dell'SDK Web:

  code language-js
  // If your current implementation has this line of code: s.t(); // Replace it with this line of code. The dataObj object contains the variables to send. alloy("sendEvent", dataObj);

• Tracciamento automatico dei collegamenti: la proprietà di configurazione clickCollectionEnabled è attivata per impostazione predefinita. Imposta automaticamente le variabili di tracciamento dei collegamenti corrette per inviare dati ad Adobe Analytics. Se si desidera disabilitare il rilevamento automatico dei collegamenti, impostare questa proprietà su false nel comando configure.

• Tracciamento manuale dei collegamenti: l'SDK Web non dispone di comandi separati tra le chiamate pageview e non pageview. Specifica la distinzione all'interno dell'oggetto payload.

  code language-js
  // If your current implementation has this line of code: s.tl(true,"o","Example custom link"); // Replace it with these lines of code. Add the required fields to the dataObj object. dataObj.data.__adobe.analytics.linkName = "Example custom link"; dataObj.data.__adobe.analytics.linkType = "o"; dataObj.data.__adobe.analytics.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

Dopo aver rimosso tutti i riferimenti a AppMeasurement e all'oggetto s, pubblica le modifiche nell'ambiente di sviluppo per verificare che la nuova implementazione funzioni. Dopo aver verificato il corretto funzionamento di tutto, puoi pubblicare gli aggiornamenti in produzione.

Se migrato correttamente, AppMeasurement.js non è più necessario nel sito e tutti i riferimenti a questo script possono essere rimossi.