Configurare Adobe Target con Platform Web SDK

Scopri come implementare Adobe Target utilizzando Adobe Experience Platform Web SDK. Scopri come distribuire esperienze e come trasmettere parametri aggiuntivi a Target.

Adobe Target è l’applicazione Adobe Experience Cloud che offre tutto il necessario per adattare e personalizzare l’esperienza dei clienti in modo da massimizzare i ricavi sui siti web e mobili, applicazioni e altri canali digitali.

Obiettivi di apprendimento

Alla fine di questa lezione, sei in grado di effettuare le seguenti operazioni con un’implementazione Web SDK di Target:

Prerequisiti

Per completare le lezioni in questa sezione, devi prima:

Aggiungi gestione sfarfallio

Prima di iniziare, determina se è necessaria un’ulteriore soluzione di gestione della visualizzazione momentanea di altri contenuti a seconda di come viene caricata la libreria di tag.

Implementazione asincrona

Quando una libreria di tag viene caricata in modo asincrono, la pagina potrebbe terminare il rendering prima che Target abbia sostituito il contenuto predefinito con il contenuto personalizzato. Questo comportamento può causare il cosiddetto "sfarfallio", in cui il contenuto predefinito viene visualizzato brevemente prima di essere sostituito dal contenuto personalizzato. Per evitare questo sfarfallio, l’Adobe consiglia di aggiungere uno speciale frammento pre-hiding immediatamente prima del codice di incorporamento di tag asincrono.

Questo frammento è già presente nel sito Luma, ma diamo uno sguardo più da vicino per capire il funzionamento del codice:

<script>
  !function(e,a,n,t){var i=e.head;if(i){
  if (a) return;
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, ".personalization-container { opacity: 0 !important }", 3000);
</script>

Il frammento pre-hiding crea un tag di stile nella parte superiore della pagina con la definizione CSS desiderata. Questo tag di stile viene rimosso quando viene ricevuta una risposta da Target o quando viene raggiunto il timeout.

Il comportamento di pre-hiding è controllato da due configurazioni alla fine del frammento.

Il frammento pre-hiding è disponibile anche all’interno dei tag:

Implementazione sincrona

L’Adobe consiglia di implementare i tag in modo asincrono, come dimostrato sul sito Luma. Tuttavia, se la libreria di tag viene caricata in modo sincrono, il frammento pre-hiding non è necessario. Lo stile per nascondere anticipatamente è invece specificato nelle impostazioni dell’estensione Platform Web SDK.

Lo stile di pre-hiding per le implementazioni sincrone può essere configurato come segue:

Per ulteriori informazioni su come Platform Web SDK può gestire la visualizzazione momentanea di altri contenuti, consulta la sezione guida: gestione della visualizzazione momentanea di altri contenuti per esperienze personalizzate.

Configurare lo stream di dati

Target deve essere abilitato nella configurazione dello stream di dati prima che Platform Web SDK possa distribuire qualsiasi attività di Target.

Per configurare Target nello stream di dati:

Token di proprietà

I clienti Target Premium possono gestire le autorizzazioni utente con proprietà. Le proprietà di Target ti consentono di definire i limiti intorno ai quali gli utenti possono eseguire le attività di Target. Consulta la sezione Autorizzazioni Enterprise nella documentazione di Target.

Per impostare o trovare i token di proprietà, passa a Adobe Target > Amministrazione > Proprietà. Il </> visualizza il codice di implementazione. Il at_property value è il token di proprietà che utilizzeresti nel flusso di dati.

È possibile specificare un solo token di proprietà per ogni stream di dati, ma gli override del token di proprietà consentono di specificare token di proprietà alternativi per sostituire il token di proprietà primario definito nello stream di dati. Un aggiornamento della sezione sendEvent è inoltre necessaria un’azione per ignorare lo stream di dati.

ID ambiente di destinazione

Ambienti in Target aiuta a gestire la tua implementazione attraverso tutte le fasi di sviluppo. Questa impostazione opzionale specifica l’ambiente Target da utilizzare con ogni flusso di dati.

L’Adobe consiglia di impostare l’ID dell’ambiente di Target in modo diverso per ciascuno dei flussi di dati di sviluppo, staging e produzione per semplificare le operazioni. In alternativa, puoi organizzare gli ambienti nell’interfaccia di Target utilizzando host funzionalità.

Per impostare o trovare gli ID ambiente, passa a Adobe Target > Amministrazione > Ambienti.

Spazio dei nomi ID di terze parti di Target

Questa impostazione opzionale consente di specificare il simbolo di identità da utilizzare per l’ID di terze parti di Target. Target supporta solo la sincronizzazione dei profili su un singolo simbolo di identità o spazio dei nomi. Per ulteriori informazioni, consulta Sincronizzazione dei profili in tempo reale per mbox3rdPartyId sezione della guida di Target.

I Simboli di identità si trovano nell’elenco delle identità in Raccolta dati > Cliente > Identità.

Ai fini di questa esercitazione utilizzando il sito Luma, utilizza il simbolo di identità lumaCrmId configurato durante la lezione su Identità.

Eseguire il rendering delle decisioni di personalizzazione visiva

Le decisioni sulla personalizzazione visiva si riferiscono alle esperienze create nel Compositore esperienza visivo di Adobe Target. Innanzitutto, devi comprendere la terminologia utilizzata nelle interfacce Target e tag:

Aggiornare il Invia evento azione

Le decisioni di personalizzazione visiva da Target vengono consegnate da Platform Web SDK, se Target è abilitato nello stream di dati. Tuttavia, non vengono renderizzati automaticamente. È necessario aggiornare Invia evento per abilitare il rendering automatico.

L’impostazione relativa alle decisioni sulla personalizzazione visiva del rendering fa in modo che Platform Web SDK applichi automaticamente tutte le modifiche specificate utilizzando il Compositore esperienza visivo di Target o "mbox globale".

Se preferisci eseguire il rendering o intervenire direttamente su queste decisioni utilizzando un codice personalizzato, puoi lasciare Eseguire il rendering delle decisioni di personalizzazione visiva impostazione disabilitata. Platform Web SDK è flessibile e offre questa funzionalità per un controllo completo. Per ulteriori informazioni su, consulta la guida rendering manuale di contenuti personalizzati.

Configurare un’attività Target con il Compositore esperienza visivo

Ora che la sezione sull’implementazione di base è stata completata, crea un’attività Targeting esperienza in Target per verificare che tutto funzioni correttamente. Consulta l’esercitazione di Target per creazione di attività Targeting esperienza se ha bisogno di assistenza.

Convalida con Debugger

Se imposti un’attività, il contenuto dovrebbe essere visualizzato nella pagina di rendering. Tuttavia, anche se non ci sono attività live, puoi anche guardare la chiamata di rete Send Event per verificare che Target sia configurato correttamente.

Impostare ed eseguire il rendering di un ambito decisionale personalizzato

Gli ambiti decisionali personalizzati (precedentemente noti come "mbox") possono essere utilizzati per fornire contenuto HTML o JSON in modo strutturato utilizzando il Compositore esperienza basato su moduli di Target. Il contenuto distribuito a uno di questi ambiti personalizzati non viene renderizzato automaticamente da Platform Web SDK. Può essere riprodotto utilizzando un’azione in Tag.

Aggiungere un ambito al Invia azione evento

Modifica la regola di caricamento pagina per aggiungere un ambito di decisione personalizzato:

Elabora la risposta da Target

Ora che hai configurato Platform Web SDK per richiedere contenuti per homepage-hero ambito, devi intervenire sulla risposta. L’estensione tag Platform Web SDK fornisce una Invia evento completato , che può essere utilizzato per attivare immediatamente una nuova regola quando una risposta da un Invia evento azione ricevuta.

Configurare un’attività Target con il Compositore esperienza basato su moduli

Ora che disponi di una regola per eseguire manualmente il rendering di un ambito di decisione personalizzato, puoi creare un’altra attività Targeting esperienza in Target. Questa volta utilizza il Compositore esperienza basato su moduli.

Convalida con Debugger

Se hai attivato l’attività, sulla pagina dovrebbe essere visualizzato il rendering del contenuto. Tuttavia, anche se non ci sono attività live, puoi anche vedere Invia evento chiamata di rete per confermare che Target richiede contenuto per gli ambiti personalizzati.

Inviare parametri a Target

In questa sezione, trasmetterai dati specifici di Target e vedrai più da vicino come i dati XDM vengono mappati sui parametri di Target.

Parametri di pagina (mbox) e XDM

Tutti i campi XDM vengono passati automaticamente a Target come parametri di pagina o parametri mbox.

Alcuni di questi campi XDM verranno mappati su oggetti speciali nel backend di Target. Ad esempio: web.webPageDetails.URL sarà automaticamente disponibile per creare condizioni di targeting basate su URL o come page.url durante la creazione di script di profilo.

Parametri speciali e oggetto dati

Alcuni punti dati possono essere utili per Target e non sono mappati dall’oggetto XDM. Questi parametri speciali di Target includono:

Questi parametri devono essere inviati nel data oggetto invece di nel xdm oggetto. Inoltre, i parametri di pagina (o mbox) possono essere inclusi anche nel data oggetto.

Per popolare l’oggetto dati, crea il seguente elemento dati, riutilizzando gli elementi dati creati in Creare elementi dati lezione:

Aggiornare la regola di caricamento della pagina

Il passaggio di dati aggiuntivi per Target all’esterno dell’oggetto XDM richiede l’aggiornamento di tutte le regole applicabili. In questo esempio, l’unica modifica da apportare è quella di includere il nuovo data.content alla regola di caricamento pagina generica e alla regola di visualizzazione della pagina di prodotto.

Suddivisione delle richieste di personalizzazione e analisi

Il livello dati sul sito Luma è completamente definito prima che il codice di incorporamento dei tag. Questo ci consente di utilizzare una singola chiamata sia per recuperare contenuti personalizzati (ad esempio da Adobe Target) che per inviare dati analitici (ad esempio ad Adobe Analytics).

In molti siti web, tuttavia, il livello dati non può essere caricato abbastanza presto o abbastanza rapidamente da utilizzare una singola chiamata per entrambe le applicazioni. In queste situazioni, puoi utilizzare due Invia evento azioni su una singola pagina carica e utilizza la prima per la personalizzazione e la seconda per analytics. Suddividere gli eventi in questo modo consente all’evento di personalizzazione di attivarsi il prima possibile, in attesa che il livello dati venga completamente caricato prima di inviare l’evento Analytics. È simile a molte implementazioni SDK pre-Web, in cui Adobe Target attiverebbe target-global-mbox nella parte superiore della pagina e Adobe Analytics attiverebbe il s.t() chiama in fondo alla pagina

Per creare la richiesta di personalizzazione on-top:

Per creare la richiesta Analytics-on-bottom:

Convalida con Debugger

Ora che le regole sono aggiornate, puoi verificare se i dati vengono passati correttamente utilizzando l’Adobe Debugger.

Convalida nell’interfaccia di Target

Quindi, cerca nell’interfaccia di Target per confermare che i dati sono stati ricevuti e sono disponibili per l’utilizzo in tipi di pubblico e attività. I dati XDM vengono mappati automaticamente sui parametri di Target personalizzati. Puoi verificare che i dati XDM siano stati ricevuti da Target e siano disponibili creando un pubblico.

Successivamente, verifica che l’attributo del profilo dello stato di accesso sia stato passato correttamente.

Se disponi di Target Premium, puoi anche verificare che i dati delle entità siano stati passati correttamente e che i dati dei prodotti siano stati scritti nel catalogo prodotti Recommendations.

Convalida con garanzia

Inoltre, puoi utilizzare la funzione Assurance quando appropriato per confermare che le richieste di decisioni di Target ricevono i dati corretti e che eventuali trasformazioni lato server si verificano correttamente. Puoi anche verificare che le informazioni sulla campagna e sull’esperienza siano contenute nelle chiamate di Adobe Analytics anche quando le chiamate a Target decisioning e Adobe Analytics vengono inviate separatamente.

Ciò conferma che le informazioni A4T che erano in coda per una trasmissione successiva quando abbiamo effettuato la chiamata di Target Decisioning sono state inviate correttamente quando la chiamata di tracciamento di Analytics è stata attivata più avanti sulla pagina.

Dopo aver completato questa lezione, è necessario disporre di un’implementazione funzionante di Adobe Target utilizzando Platform Web SDK.

Successivo: