Configurare Adobe Target con Platform Web SDK

CAUTION
Prevediamo di pubblicare modifiche principali a questo tutorial venerdì 15 marzo 2024. Dopo questo punto molti esercizi cambieranno e potrebbe essere necessario riavviare l'esercitazione dall'inizio per completare tutte le lezioni.

Scopri come implementare Adobe Target utilizzando 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, potrai:

  • Scopri come aggiungere il frammento pre-hiding di Platform Web SDK per evitare sfarfallii quando utilizzi Target con codici di incorporamento di tag asincroni
  • Configurare uno stream di dati per abilitare la funzionalità di Target
  • Rendering delle decisioni di personalizzazione visiva al caricamento della pagina (precedentemente denominata "mbox globale")
  • Trasmettere i dati XDM a Target e comprendere la mappatura dei parametri di Target
  • Trasmettere dati personalizzati a Target, ad esempio parametri di profilo ed entità
  • Convalidare un’implementazione di Target con Platform Web SDK
TIP
Visualizza la Migrare Target da at.js 2.x a Platform Web SDK tutorial per una guida dettagliata alla migrazione dell’implementazione at.js esistente.

Prerequisiti

Per completare le lezioni in questa sezione, devi prima:

Aggiungi attenuazione 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.

NOTE
Questa esercitazione utilizza Sito Luma con un’implementazione asincrona dei tag e una mitigazione della visualizzazione momentanea di altri contenuti. Questa sezione serve come riferimento per comprendere come funziona la mitigazione della visualizzazione momentanea di altri contenuti con Platform Web SDK.

Implementazione asincrona

Quando una libreria di tag viene caricata in modo asincrono, la pagina potrebbe terminare il rendering prima che Target abbia eseguito uno scambio di contenuto. Questo comportamento può causare il cosiddetto "sfarfallio", in cui il contenuto predefinito viene visualizzato brevemente prima di essere sostituito dal contenuto personalizzato specificato da Target. 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.

  • body { opacity: 0 !important } specifica la definizione CSS da utilizzare per il pre-hiding fino al caricamento di Target. Per impostazione predefinita, l’intera pagina è nascosta. Puoi aggiornare questa definizione ai selettori che desideri nascondere anticipatamente insieme alla modalità con cui vuoi nasconderli. Puoi includere più definizioni, poiché questo valore è semplicemente ciò che viene inserito nel tag di stile per nascondere contenuti anticipatamente. Se il contenuto all’interno della navigazione è racchiuso in un elemento contenitore facilmente identificabile, puoi utilizzare questa impostazione per limitare il pre-hiding per quell’elemento contenitore.
  • 3000 specifica il timeout in millisecondi per il pre-hiding. Se una risposta da Target non viene ricevuta prima del timeout, il tag di stile per nascondere contenuti anticipatamente viene rimosso. Il raggiungimento di questo timeout dovrebbe essere raro.
NOTE
Il frammento pre-hiding per Platform Web SDK è leggermente diverso da quello utilizzato con la libreria at.js di Target. Assicurati di utilizzare lo snippet corretto per Platform Web SDK poiché utilizza un ID di stile diverso da alloy-prehiding. Se si utilizza il frammento pre-hiding per at.js, potrebbe non funzionare correttamente.

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

  1. Vai a Estensioni sezione dei tag

  2. Seleziona Configura per l’estensione Adobe Experience Platform Web SDK

  3. Seleziona la Copia frammento pre-hiding negli Appunti pulsante

    Frammento pre-hiding di Target per implementazioni asincrone

    note note
    NOTE
    Il frammento predefinito per nascondere contenuti copiato dall’estensione Platform Web SDK può includere una definizione CSS che non esiste nel sito, ad esempio .personalization-container { opacity: 0 !important }. Verifica e modifica il frammento pre-hiding in modo appropriato per il sito.

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:

  1. Vai a Estensioni sezione dei tag

  2. Seleziona la Configura pulsante per l’estensione Platform Web SDK

  3. Seleziona la Modifica stile pre-hiding pulsante

    Frammento pre-hiding di Target per implementazioni asincrone

  4. Modifica il CSS in modo da includere i selettori e i metodi di nasconderlo che desideri utilizzare, ad esempio: body { opacity: 0 !important } se desideri nascondere anticipatamente l’intero corpo della pagina.

  5. Salvare le modifiche e generare in una libreria

NOTE
L’impostazione di stile per nascondere anticipatamente deve essere utilizzata solo per le implementazioni sincrone. Se utilizzi un’implementazione asincrona dei tag, questo stile deve essere vuoto o deve essere commentato.

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:

  1. Vai a Raccolta dati Interfaccia

  2. Nel menu di navigazione a sinistra, seleziona Flussi di dati

  3. Seleziona il creato in precedenza Luma Web SDK flusso di dati

    Seleziona lo stream di dati dell’SDK web Luma

  4. Seleziona Aggiungi servizio
    Aggiungere un servizio allo stream di dati

  5. Seleziona Adobe Target come Servizio

  6. Se necessario, immetti i dettagli facoltativi sull’implementazione di Target seguendo le indicazioni riportate di seguito.

  7. Seleziona Salva

    Configurazione dello stream di dati di destinazione

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.

Token proprietà di destinazione

NOTE
È possibile specificare un solo token di proprietà per ogni 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.

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

Ambienti di destinazione

NOTE
Se non viene specificato alcun ID ambiente Target, viene utilizzato l’ambiente Target di produzione.

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à.

Elenco 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

Innanzitutto, devi comprendere la terminologia utilizzata nelle interfacce Target e tag.

  • Attività: un set di esperienze indirizzato a uno o più tipi di pubblico. Ad esempio, un semplice test A/B potrebbe essere un’attività con due esperienze.
  • Esperienza: un set di azioni indirizzate a una o più posizioni o ambiti decisionali.
  • Ambito della decisione: posizione in cui viene distribuita un’esperienza Target. Gli ambiti decisionali sono equivalenti a "mbox" se hai familiarità con l’utilizzo di versioni precedenti di Target.
  • Decisione di personalizzazione: azione che il server determina da applicare. Queste decisioni possono essere basate sui criteri di pubblico e sulla definizione delle priorità delle attività di Target.
  • Proposta: risultato delle decisioni prese dal server e consegnate nella risposta di Platform Web SDK. Ad esempio, la sostituzione di un'immagine del banner rappresenta una proposta.

Aggiornare la regola di caricamento della pagina

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 modificare la regola di caricamento pagina globale per abilitare il rendering automatico.

  1. In Raccolta dati , apri la proprietà tag utilizzata per questa esercitazione

  2. Apri all pages - library load - AA & AT regola

  3. Seleziona la Adobe Experience Platform Web SDK - Send event azione

  4. Abilita Eseguire il rendering delle decisioni di personalizzazione visiva con la casella di controllo

    Abilita il rendering delle decisioni di personalizzazione visiva

  5. Salva le modifiche e quindi genera la libreria

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".

NOTE
In genere, il Eseguire il rendering delle decisioni di personalizzazione visiva L’impostazione deve essere abilitata solo per una singola azione Invia evento per caricamento di pagina completo. Se questa impostazione è abilitata per più azioni Invia evento, le richieste di rendering successive vengono ignorate.

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.

NOTE
Se utilizzi Google Chrome come browser, il Estensione VEC Helper è necessario per caricare il sito correttamente per la modifica nel Compositore esperienza visivo.
  1. Passa a Target

  2. Creare un’attività Targeting esperienza (XT) utilizzando la pagina home di Luma per l’URL dell’attività

    Creare una nuova attività XT

  3. Modificare la pagina, ad esempio modificare il testo nel banner della home page

    Modifica VEC di Target

  4. Scegli Adobe Analytics come origine per la generazione di rapporti con la suite di rapporti appropriata e la metrica Ordini come obiettivo

    note note
    NOTE
    Se non utilizzi Adobe Analytics, seleziona Target come origine per la generazione di rapporti e scegli una metrica diversa, ad esempio Coinvolgimento > Visualizzazioni pagina invece. Per salvare e visualizzare in anteprima l’attività è necessaria una metrica di obiettivo.
  5. Salvare l’attività

  6. Se hai familiarità con le modifiche, puoi attivare l’attività. In caso contrario, se desideri visualizzare l'anteprima dell'esperienza senza attivarla, puoi copiare URL anteprima controllo di qualità.

  7. Carica la home page di Luma e dovresti vedere le modifiche applicate

  8. Dopo alcune ore, dovresti essere in grado di visualizzare i dati di attività e le conversioni di Target in Adobe Analytics. Fai riferimento alla Guida di Target per informazioni dettagliate su Generazione di rapporti di Analytics for Target (A4T).

Convalida con Debugger

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

CAUTION
Se utilizzi Google Chrome e disponi di Estensione VEC Helper installate, assicuratevi che Inserisci librerie di Target è disabilitata. Se abiliti questa impostazione, si otterranno richieste Target aggiuntive.
  1. Apri l’estensione del browser Adobe Experience Platform Debugger

  2. Vai a Sito di dimostrazione Luma e utilizza il debugger per modifica la proprietà tag sul sito con la tua proprietà di sviluppo

  3. Ricarica la pagina

  4. Seleziona la Rete strumento nel debugger

  5. Filtra per Adobe Experience Platform Web SDK

  6. Seleziona il valore nella riga degli eventi per la prima chiamata

    Chiamata di rete nel debugger di Adobe Experience Platform

  7. Tieni presente che ci sono chiavi in query > personalization e decisionScopes ha un valore di __view__. Questo ambito è equivalente alla "mbox globale" di Target. Questa chiamata di Platform Web SDK ha richiesto decisioni a Target.

    visualizza richiesta decisionScope

  8. Chiudi la sovrapposizione e seleziona i dettagli dell’evento per la seconda chiamata di rete. Questa chiamata è presente solo se Target ha restituito un’attività.

  9. Tieni presente che ci sono dettagli sull’attività e sull’esperienza restituite da Target. Questa chiamata di Platform Web SDK invia una notifica indicante che è stato eseguito il rendering di un’attività Target all’utente e incrementa un’impression.

    Impression dellattività di Target

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.

Aggiungere un ambito alla regola di caricamento pagina

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

  1. Apri all pages - library load - AA & AT regola

  2. Seleziona la Adobe Experience Platform Web SDK - Send Event azione

  3. Aggiungi uno o più ambiti da utilizzare. Per questo esempio, utilizza homepage-hero.

    Ambito personalizzato

  4. Salvare le modifiche e generare nella libreria

TIP
Per questa esercitazione verrà utilizzato un singolo ambito definito manualmente a scopo dimostrativo. Se decidi di utilizzare diversi ambiti decisionali destinati a pagine specifiche, è consigliabile utilizzare un elemento dati che restituisca una matrice di ambiti in modo condizionale a seconda del percorso della pagina. Questo approccio consente di mantenere l’implementazione semplice e scalabile.

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.

  1. Creare una regola denominata homepage - send event complete - render homepage-hero.

  2. Aggiungi un evento alla regola. Utilizza il Adobe Experience Platform Web SDK e Invio evento completato tipo di evento.

  3. Aggiungi una condizione per limitare la regola alla home page Luma (il percorso senza stringa di query è uguale a /content/luma/us/en.html).

  4. Aggiungi un'azione alla regola. Utilizza il Core estensione e Codice personalizzato tipo di azione.

    Rendering regola principale pagina home

    note tip
    TIP
    Assegna nomi descrittivi a eventi, condizioni e azioni della regola invece di utilizzare i nomi predefiniti. I nomi affidabili dei componenti regola rendono i risultati della ricerca molto più utili.
  5. Immetti un codice personalizzato per leggere e intervenire sulle proposte restituite dalla risposta di Platform Web SDK. Il codice personalizzato in questo esempio utilizza l’approccio descritto nella guida per rendering manuale di contenuti personalizzati. Il codice è stato adattato per homepage-hero ambito di esempio utilizzando un’azione della regola di tag.

    code language-javascript
    var propositions = event.propositions;
    
    var heroProposition;
    if (propositions) {
       // Find the hero proposition, if it exists.
       for (var i = 0; i < propositions.length; i++) {
          var proposition = propositions[i];
          if (proposition.scope === "homepage-hero") {
             heroProposition = proposition;
             break;
          }
       }
    }
    
    var heroHtml;
    if (heroProposition) {
       // Find the item from proposition that should be rendered.
       // Rather than assuming there a single item that has HTML
       // content, find the first item whose schema indicates
       // it contains HTML content.
       for (var j = 0; j < heroProposition.items.length; j++) {
          var heroPropositionItem = heroProposition.items[j];
          if (heroPropositionItem.schema === "https://ns.adobe.com/personalization/html-content-item") {
             heroHtml = heroPropositionItem.data.content;
             break;
          }
       }
    }
    
    if (heroHtml) {
       // Hero HTML exists. Time to render it.
       var heroElement = document.querySelector(".heroimage");
       heroElement.innerHTML = heroHtml;
       // For this example, we assume there is only a signle place to update in the HTML.
    }
    
    // Send a "display" event
    alloy("sendEvent", {
       xdm: {
          eventType: "propositionDisplay",
          _experience: {
             decisioning: {
                propositions: [
                   {
                      id: heroProposition.id,
                      scope: heroProposition.scope,
                      scopeDetails: heroProposition.scopeDetails
                   }
                ]
             }
          }
       }
    });
    
  6. Salvare le modifiche e generare nella libreria

  7. Carica la home page di Luma alcune volte, il che dovrebbe essere sufficiente per creare la nuova homepage-hero registro dell’ambito decisionale nell’interfaccia di Target.

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.

  1. Apri Adobe Target

  2. Disattiva l'attività utilizzata per la lezione precedente

  3. Creare un’attività Targeting esperienza (XT) utilizzando l’opzione Compositore esperienza basato su moduli

    Creare una nuova attività XT

  4. Seleziona la homepage-hero posizione dal menu a discesa posizione e Crea offerta HTML dal menu a discesa dei contenuti. Se la posizione non è disponibile, è possibile digitarla in. Target compila periodicamente i nuovi nomi di posizione dopo aver ricevuto le richieste per tale posizione o ambito.

    Creare una nuova attività XT

  5. Incolla il codice seguente nella casella del contenuto. Questo codice è un banner hero di base con un’immagine di sfondo diversa:

    code language-html
    <div class="we-HeroImage jumbotron" style="background-image: url('/content/luma/us/en/women/_jcr_content/root/hero_image.coreimg.jpeg');">
       <div class="container cq-dd-image">
          <div class="we-HeroImage-wrapper">
             <p class="h3">New Luma Yoga Collection</p>
             <strong class="we-HeroImage-title h1">Be active with style&nbsp;</strong>
             <p>
                <a class="btn btn-primary btn-action" href="/content/luma/us/en/products.html" role="button">Shop Now</a>
             </p>
          </div>
       </div>
    </div>
    
  6. Il giorno Obiettivi e impostazioni , scegli Adobe Target come origine per la generazione di rapporti e Coinvolgimento > Visualizzazioni pagina come obiettivo

  7. Salvare l’attività

  8. Se hai familiarità con le modifiche, puoi attivare l’attività. In caso contrario, se desideri visualizzare l'anteprima dell'esperienza senza attivarla, puoi copiare URL anteprima controllo di qualità.

  9. Carica la home page di Luma e dovresti vedere le modifiche applicate

NOTE
L’obiettivo di conversione "Clic su una mbox" non funziona automaticamente. Poiché Platform Web SDK non esegue automaticamente il rendering degli ambiti personalizzati, non tiene traccia dei clic nelle posizioni scelte per applicare il contenuto. Puoi creare un tracciamento dei clic personalizzato per ogni ambito utilizzando il "clic" eventType con le disposizioni applicabili _experience dettagli utilizzando sendEvent azione.

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.

  1. Apri l’estensione del browser Adobe Experience Platform Debugger

  2. Vai a Sito di dimostrazione Luma e utilizza il debugger per modifica la proprietà tag sul sito con la tua proprietà di sviluppo

  3. Ricarica la pagina

  4. Seleziona la Rete strumento nel debugger

  5. Filtra per Adobe Experience Platform Web SDK

  6. Seleziona il valore nella riga degli eventi per la prima chiamata

    Chiamata di rete nel debugger di Adobe Experience Platform

  7. Tieni presente che ci sono chiavi in query > personalization e decisionScopes ha un valore di __view__ come prima, ma ora c'è anche un homepage-hero ambito incluso. Questa chiamata di Platform Web SDK ha richiesto a Target decisioni per le modifiche effettuate utilizzando il Compositore esperienza visivo e gli homepage-hero posizione.

    visualizza richiesta decisionScope

  8. Chiudi la sovrapposizione e seleziona i dettagli dell’evento per la seconda chiamata di rete. Questa chiamata è presente solo se Target ha restituito un’attività.

  9. Tieni presente che ci sono dettagli sull’attività e sull’esperienza restituite da Target. Questa chiamata di Platform Web SDK invia una notifica indicante che è stato eseguito il rendering di un’attività Target all’utente e incrementa un’impression.

    Impression dellattività di Target

Trasmettere dati aggiuntivi 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.

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

Creare elementi di dati per i parametri di Target

Innanzitutto, puoi impostare alcuni elementi di dati aggiuntivi per un attributo di profilo, un attributo di entità, un valore di categoria, quindi creare l’ data oggetto utilizzato per trasmettere dati non XDM:

  • target.entity.id mappato a digitalData.product.0.productInfo.sku

  • target.entity.name mappato a digitalData.product.0.productInfo.title

  • target.user.categoryId utilizzando il seguente codice personalizzato per analizzare l’URL del sito per la categoria di livello principale:

    code language-javascript
    var cat = location.pathname.split(/[/.]+/);
    if (cat[5] == 'products') {
       return (cat[6]);
    } else if (cat[5] != 'html') {
       return (cat[5]);
    }
    
  • data.content utilizzando il seguente codice personalizzato:

    code language-javascript
    var data = {
       __adobe: {
          target: {
             "entity.id": _satellite.getVar("target.entity.id"),
             "entity.name": _satellite.getVar("target.entity.name"),
             "profile.loggedIn": _satellite.getVar("user.profile.attributes.loggedIn"),
             "user.categoryId": _satellite.getVar("target.user.categoryId")
          }
       }
    }
    return data;
    

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.

  1. Apri all pages - library load - AA & AT regola

  2. Seleziona la Adobe Experience Platform Web SDK - Send event azione

  3. Aggiungi il data.content Elemento dati al campo Dati

    Aggiungi dati di destinazione alla regola

  4. Salvare le modifiche e generare nella libreria

  5. Ripetere i passaggi da 1 a 4 per visualizzazione prodotto - caricamento libreria - AA regola

NOTE
L’esempio precedente utilizza un data oggetto che non è completamente popolato su tutti i tipi di pagina. I tag gestiscono questa situazione in modo appropriato e omettono le chiavi con un valore non definito. Ad esempio: entity.id e entity.name non verrebbe trasmesso ad alcuna pagina oltre ai dettagli del prodotto.

Convalida con il debugger

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

  1. Accedi a Sito di dimostrazione Luma e accedi con l’e-mail test@adobe.com e password test

  2. Passare a una pagina dei dettagli del prodotto

  3. Apri l’estensione del browser Adobe Experience Platform Debugger e passa la proprietà tag alla tua proprietà di sviluppo

  4. Ricarica la pagina

  5. Seleziona la Rete nel debugger e filtra per Adobe Experience Platform Web SDK

  6. Seleziona il valore nella riga degli eventi per la prima chiamata

  7. Tieni presente che ci sono chiavi in data > __adobe > target e contengono informazioni sul prodotto, la categoria e lo stato di accesso.

    visualizza richiesta decisionScope

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.

  1. Apri Adobe Target
  2. Accedi a Tipi di pubblico sezione
  3. Crea un pubblico e scegli il Personalizzato tipo di attributo
  4. Cerca in Parametro campo per web. Il menu a discesa deve essere compilato con tutti i campi XDM relativi ai dettagli della pagina web.

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

  1. Scegli la Profilo visitatore tipo di attributo
  2. Cerca loggedIn. Se l'attributo è disponibile nel menu a discesa, allora l'attributo è stato passato correttamente a Target. I nuovi attributi potrebbero richiedere alcuni minuti per diventare disponibili nell’interfaccia utente di Target.

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.

  1. Accedi a Recommendations sezione
  2. Seleziona Ricerca nel catalogo nel menu di navigazione a sinistra
  3. Cerca lo SKU del prodotto o il nome del prodotto visitato in precedenza sul sito Luma. Il prodotto deve essere visualizzato nel catalogo dei prodotti. La ricerca di nuovi prodotti nel catalogo dei prodotti Recommendations potrebbe richiedere alcuni minuti.

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

Successivo:

NOTE
Grazie per aver dedicato il tuo tempo all’apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere feedback generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4