Aggiorna la libreria di raccolta dati, ad Audience Manager dalla libreria JavaScript di AppMeasurement alla libreria JavaScript di 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 Audienci Manager. In futuro, lo stesso flusso di dati inoltra i dati a Real-Time CDP.

1. Accedi a experience.adobe.com e accedere utilizzando le credenziali.

2. Utilizza la home page o il selettore di prodotti in alto a destra per passare a Data Collection.

3. Nel menu di navigazione a sinistra, seleziona Datastreams.

4. Seleziona New Datastream.

5. Immetti il nome desiderato, quindi seleziona Save.

6. Una volta creato lo stream di dati, seleziona Add Service.

7. Nel menu a discesa del servizio, seleziona Audience Manager.

   

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

Imposta l’implementazione in modo che punti allo stream di dati creato nel passaggio 1 utilizzando l’SDK per web configure comando. Il configure deve essere impostato su ogni pagina, in modo da poterlo includere insieme al codice di installazione della libreria.

Utilizza il edgeConfigId e orgId proprietà nell’SDK per web configure comando:

• Imposta il edgeConfigId all’ID dello stream di dati recuperato dal passaggio precedente.
• Imposta il orgId all’ID organizzazione IMS della tua organizzazione.

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

Facoltativamente, puoi impostare altre proprietà nella configure a seconda dei requisiti di implementazione della tua organizzazione.

Modifica l’implementazione di Audienci Manager in modo che non si basi su AppMeasurement.js o s oggetto. Imposta invece le variabili in un oggetto JavaScript formattato correttamente, che viene convertito in un oggetto JSON quando viene inviato a Adobe. Avere un livello dati sul tuo sito ti aiuta enormemente a impostare i valori, in quanto puoi continuare a fare riferimento a tali valori.

Per inviare dati ad Audienci Manager, il payload dell’SDK web deve utilizzare data.__adobe.audiencemanager con tutte le variabili di analytics 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 il products , non suddividerla in singoli oggetti come si farebbe con XDM. Invece, includila come stringa esattamente se imposti il s.products variabile:

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

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

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {audiencemanager: {}}}};
dataObj.data.__adobe.audiencemanager.pageName = window.document.title;
dataObj.data.__adobe.audiencemanager.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:{audiencemanager:{...a}}}};

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

• Tracciamento della visualizzazione pagina: sostituisci la chiamata di tracciamento della visualizzazione della pagina con l’SDK web sendEvent comando:

  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: Il clickCollectionEnabled la proprietà di configurazione è attivata per impostazione predefinita. Imposta automaticamente le variabili di tracciamento dei collegamenti corrette per inviare i dati a Audienci Manager. Se vuoi disattivare il tracciamento automatico dei collegamenti, imposta questa proprietà su false all'interno del configure comando.

• Tracciamento manuale dei collegamenti: l’SDK per 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.audiencemanager.linkName = "Example custom link"; dataObj.data.__adobe.audiencemanager.linkType = "o"; dataObj.data.__adobe.audiencemanager.linkURL = "https://example.com"; alloy("sendEvent", dataObj);

Dopo aver rimosso tutti i riferimenti ad AppMeasurement e al 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ù richiesto sul sito e tutti i riferimenti a questo script possono essere rimossi.