Configurare Adobe Target con Platform Web SDK

Scopri come implementare Adobe Target utilizzando Adobe Experience Platform Web SDK. Scopri come offrire 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. Per ulteriori informazioni, consulta la sezione Autorizzazioni Enterprise della documentazione di Target.

Per impostare o trovare i token di proprietà, passa a Adobe Target > Amministrazione > Proprietà. L'icona </> visualizza il codice di implementazione. Il valore at_property è 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. È inoltre necessario un aggiornamento dell'azione sendEvent per ignorare lo stream di dati.

ID ambiente di destinazione

Gli ambienti in Target consentono di gestire l'implementazione in 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, è possibile organizzare gli ambienti nell'interfaccia di Target utilizzando la funzionalità hosts.

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 la sezione Sincronizzazione dei profili in tempo reale per mbox3rdPartyId della guida di Target.

I simboli di identità sono presenti nell'elenco delle identità in Raccolta dati > Cliente > Identità.

Ai fini di questa esercitazione tramite il sito Luma, utilizza il simbolo di identità lumaCrmId configurato durante la lezione sulle 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:

Aggiorna l'azione Invia evento

Le decisioni di personalizzazione visiva da Target vengono consegnate da Platform Web SDK, se Target è abilitato nello stream di dati. Tuttavia, non vengono visualizzati automaticamente. Per abilitare il rendering automatico, è necessario aggiornare l'azione Invia evento.

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 su queste decisioni utilizzando un codice personalizzato, puoi lasciare disabilitata l'impostazione Rendering delle decisioni di personalizzazione visiva. Platform Web SDK è flessibile e offre questa funzionalità per un controllo completo. Per ulteriori informazioni su rendering manuale del contenuto personalizzato, consulta la guida.

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. Se hai bisogno di assistenza, puoi fare riferimento al tutorial di Target per creare attività di Targeting esperienze.

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.

Aggiungi un ambito all'Azione evento di invio

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

Elabora la risposta da Target

Dopo aver configurato Platform Web SDK per richiedere il contenuto per l'ambito homepage-hero, è necessario eseguire un'operazione con la risposta. L'estensione tag Platform Web SDK fornisce un evento Invia evento completato, che può essere utilizzato per attivare immediatamente una nuova regola quando viene ricevuta una risposta da un'azione Invia evento.

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 guardare la chiamata di rete Invia evento per confermare che Target sta richiedendo contenuto per i tuoi 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 oggetto page.url durante la creazione di script di profilo.

Puoi anche aggiungere parametri di pagina utilizzando l’oggetto dati.

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 nell'oggetto data anziché nell'oggetto xdm. Inoltre, i parametri di pagina (o mbox) possono essere inclusi nell'oggetto data.

Per popolare l'oggetto dati, creare il seguente elemento dati, riutilizzando gli elementi dati creati nella lezione Creare elementi dati:

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 consiste nell'includere il nuovo elemento dati data.content nella regola di caricamento pagina generica e nella regola di visualizzazione pagina prodotto.

Suddivisione delle richieste di Personalization e Analytics

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 azioni Invia evento in un caricamento di una singola pagina e utilizzare la prima per la personalizzazione e la seconda per l'analisi. 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, dove Adobe Target attiverebbe target-global-mbox nella parte superiore della pagina e Adobe Analytics attiverebbe la chiamata s.t() nella parte inferiore della 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.

Convalidare con Assurance

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: