DocumentazioneExperience PlatformTutorial web

Aggiungere il servizio Adobe Experience Platform Identity

Last update: Wed Nov 16 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Beginner
  • Intermediate
  • Developer

Questa lezione guiderà i passaggi necessari per implementare l’estensione del servizio Adobe Experience Platform Identity e inviare gli ID cliente.

Il servizio Adobe Experience Platform Identity imposta un ID visitatore comune tra tutte le soluzioni Adobe per sviluppare le funzionalità di Experience Cloud, ad esempio la condivisione del pubblico tra le soluzioni. Puoi anche inviare i tuoi ID cliente personalizzati al servizio per abilitare il targeting su più dispositivi e le integrazioni con il tuo sistema di gestione delle relazioni con i clienti (CRM).

NOTE
Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto durante l’utilizzo di questo contenuto:

Finalità di apprendimento

Alla fine di questa lezione, potrai:

  • Aggiungere l’estensione del servizio Identity
  • Creare un elemento dati per raccogliere gli ID cliente
  • Creare una regola che utilizza l’azione Imposta ID cliente per inviare gli ID cliente ad Adobe
  • Utilizzare la funzione di ordinamento delle regole per mettere in sequenza le regole che si attivano nello stesso evento

Prerequisiti

Dovresti aver già completato le lezioni nel Configurare i tag sezione .

Aggiungere l’estensione del servizio Identity

Dato che questa è la prima estensione che stai aggiungendo, ecco una breve panoramica sulle estensioni. Le estensioni sono una delle funzionalità principali dei tag. Un’estensione è un’integrazione generata da Adobe, un partner Adobe o qualsiasi cliente Adobe, che aggiunge opzioni nuove e infinite per i tag e che puoi distribuire sul tuo sito web. Se pensi ai tag come a un sistema operativo, le estensioni sono le app installate in modo che i tag possano eseguire le operazioni necessarie.

Per aggiungere l’estensione del servizio Identity

  1. Nella navigazione a sinistra, fai clic su Estensioni

  2. Fai clic su Catalogo per passare alla pagina Catalogo estensioni

  3. Osserva la varietà di estensioni disponibili nel Catalogo

  4. Nel filtro della parte superiore, digita “ID” per filtrare il Catalogo

  5. Nella scheda del sevizio Adobe Experience Platform Identity, fai clic su Installa

    Installare l’estensione del servizio Identity

  6. Tieni presente che l’ID organizzazione Experience Cloud è stato rilevato automaticamente

  7. Lascia tutte le impostazioni predefinite e fai clic su Salva nella libreria e genera

    Salvare l’estensione

NOTE
Ogni versione dell’estensione del servizio Identity include una versione specifica di VisitorAPI.js indicata nella descrizione dell’estensione. Aggiorna la versione VisitorAPI.js aggiornando l’estensione del servizio Identity.

Convalidare l’estensione

L’estensione del servizio Identity è una delle poche estensioni di tag che effettuano una richiesta senza dover utilizzare un’azione regola. L’estensione invia automaticamente una richiesta al servizio Identity al primo caricamento della pagina nella prima visita a un sito web. Quando l’ID è stato richiesto, viene memorizzato in un cookie di prima parte, il cui nome inizia con_“AMCV_”.

Per convalidare l’estensione del servizio Identity

  1. Apri il sito Luma.

  2. Assicurati che Debugger mappi la proprietà tag in le Ambiente di sviluppo, come descritto in lezione precedente.

  3. Nella scheda Riepilogo del debugger, la sezione tag deve indicare che l’estensione del servizio Adobe Experience Platform Identity è implementata.

  4. Inoltre, nella scheda Riepilogo, la sezione del servizio Identity deve essere compilata con lo stesso ID organizzazione presente nella schermata di configurazione dell’estensione nell’interfaccia di raccolta dati:

    Verifica che l’estensione del servizio Adobe Experience Platform Identity sia implementata

  5. Nella scheda del servizio Identity del debugger potrebbe essere visualizzata la richiesta iniziale di recupero dell’ID visitatore. Questo, tuttavia, potrebbe essere già stato richiesto, per cui non preoccuparti se non la vedi:
    Verifica se è presente una richiesta al servizio Identity con il tuo ID organizzazione

  6. Dopo la richiesta iniziale di recupero dell'ID visitatore, l'ID viene memorizzato in un cookie il cui nome inizia con AMCV_. Puoi confermare che il cookie è stato impostato seguendo questa procedura:

    1. Apri gli Strumenti per sviluppatori del browser

    2. Passa alla scheda Application.

    3. Espandi la voce Cookies a sinistra

    4. Fai clic sul dominio https://luma.enablementadobe.com

    5. Cerca il cookie AMCV_ sul lato destro. Potresti visualizzarne diversi dopo aver caricato il sito Luma utilizzando sia la proprietà tag hardcoded sia mappata sul tuo sito.

      Verifica il cookie AMCV_

Tutto qui. Hai aggiunto la tua prima estensione! Per ulteriori informazioni sulle opzioni di configurazione del servizio Identity, consulta la documentazione.

Inviare ID cliente

Successivamente, invierai un ID cliente al servizio Identity. Questo ti consente di integrare il CRM con Experience Cloud, nonché di tenere traccia dei visitatori tra i dispositivi.

Nella lezione precedente, Aggiungere elementi dati, regole e librerie hai creato un elemento dati e lo hai utilizzato in una regola. Ora, utilizzerai le stesse tecniche per inviare un ID cliente quando il visitatore è autenticato.

Creare elementi di dati per gli ID cliente

Inizia creando due elementi di dati:

  1. Authentication State: per stabilire se il visitatore ha eseguito o meno l’accesso
  2. Email (Hashed): per acquisire la versione con hash dell’indirizzo e-mail (utilizzato come ID cliente) dal livello dati

Creare l’elemento dati per Authentication State

  1. Fai clic su Elementi dati nella navigazione a sinistra

  2. Fai clic sul pulsante Aggiungi elemento dati

    Fai clic su “Aggiungi elemento dati”

  3. Denomina l’elemento dati Authentication State

  4. Per Tipo di elemento dati, seleziona Codice personalizzato

  5. Fai clic sul pulsante Apri editor

    Apri l’editor per aggiungere il codice personalizzato per l’elemento dati

  6. Nella finestra Modifica codice, utilizza il seguente codice per restituire i valori di “connesso” o “disconnesso” in base a un attributo nel livello dati del sito Luma:

    code language-javascript 
    if (digitalData.user[0].profile[0].attributes.loggedIn)
    return "logged in"
else
    return "logged out"

  7. Fai clic su Salva per salvare il codice personalizzato

    Salvare il codice personalizzato

  8. Lascia i valori predefiniti per tutte le altre impostazioni

  9. Fai clic su Salva nella libreria per salvare l’elemento dati e tornare alla pagina degli elementi dati. Non sarà necessario eseguire una "Build" finché non abbiamo apportato tutte le modifiche e siamo pronti per la convalida.

    Salvare l’elemento dati

Conoscendo lo stato di autenticazione dell’utente, sai quando deve esistere nella pagina un ID cliente da inviare al servizio Identity. Il passaggio successivo consiste nel creare un elemento dati per l’ID cliente stesso. Nel sito di dimostrazione Luma utilizzerai la versione con hash dell’indirizzo e-mail del visitatore.

Aggiungere l’elemento dati per l’e-mail con hash

  1. Fai clic sul pulsante Aggiungi elemento dati

    Aggiungere un elemento dati

  2. Denomina l’elemento dati Email (Hashed)

  3. Per Tipo di elemento dati, seleziona Variabile JavaScript

  4. Come nome della variabile JavaScript, usa il puntatore seguente su una variabile nel livello dati del sito Luma: digitalData.user.0.profile.0.attributes.username

  5. Lascia i valori predefiniti per tutte le altre impostazioni

  6. Fai clic su Salva nella libreria per salvare l’elemento dati

    Salvare l’elemento dati

Aggiungere una regola per inviare gli ID cliente

Il servizio Adobe Experience Platform Identity trasmette gli ID cliente nelle regole utilizzando un’azione denominata “Imposta ID cliente”. Ora creerai una regola per attivare questa azione quando il visitatore viene autenticato.

Creare una regola per inviare gli ID cliente

  1. Nella navigazione a sinistra, fai clic su Regole

  2. Fai clic su Aggiungi regola per aprire il Generatore di regole

    Aggiungere una regola

  3. Denomina la regola All Pages - Library Loaded - Authenticated - 10

    note tip
    TIP
    Questa convenzione per i nomi indica che stai attivando questa regola nella parte superiore di tutte le pagine quando l’utente è autenticato e avrà un ordine di “10”. L’utilizzo di una convenzione per i nomi come questa, invece di usare una denominazione per le soluzioni attivate nelle azioni, consentirà di ridurre al minimo il numero complessivo di regole necessarie per l’implementazione.

  4. In Eventi, fai clic su Aggiungi

    Aggiungere un evento

    1. In Tipo evento, seleziona Libreria caricata (Pagina in alto)
    2. Espandi la Opzioni avanzate e per Ordine enter 10. L’ordine controlla la sequenza di regole attivate dallo stesso evento. Le regole con un ordine inferiore si attiveranno prima delle regole con un ordine più elevato. In questo caso, imposta l’ID cliente prima di attivare la richiesta Target, operazione che eseguirai nella prossima lezione con una regola con ordine di 50 .
    3. Fai clic sul pulsante Mantieni modifiche per tornare al Generatore di regole

    Salvare l’evento

  5. In Condizioni fai clic su Aggiungi

    Aggiungere una condizione alla regola

    1. Per Tipo di condizione, seleziona Confronto valori

    2. Fai clic sull’icona icona elementi dati per aprire l’elemento dati modale

      aprire l’elemento dati modale

    3. Nell’elemento dati modale, fai clic su Stato autenticazione, quindi fai clic su Seleziona

      impostare lo stato di autenticazione

  6. Assicurati che l’operatore sia Equals

  7. Digita “logged in” nel campo di testo. Questo causa l’attivazione della regola ogni volta che l’elemento di dati “Stato autenticazione” ha un valore di “logged in”

  8. Fai clic su Mantieni modifiche.

    Salva condizione

  9. In Azioni fai clic su Aggiungi

    Aggiungere una nuova azione

    1. Per Estensione select Servizio Experience Cloud ID

    2. Per Tipo azione, seleziona Imposta ID cliente

    3. Per il Codice di integrazione immettere crm_id

    4. Per Valore, apri il selettore modale Elemento dati e seleziona l’Email (Hashed)

    5. Per lo Stato di autenticazione, seleziona Autenticato

    6. Fai clic sul pulsante Mantieni modifiche per salvare l’azione e tornare al Generatore di regole

      Configurare l’azione e salvare le modifiche

  10. Fai clic sul pulsante Salva nella libreria e genera per salvare la regola

    Salva la regola

Ora hai creato una regola che invierà l’ID cliente come variabile crm_id quando il visitatore viene Autenticato. Poiché hai specificato 10 come Ordine, questa regola verrà attivata prima della regola All Pages - Library Loaded creata nella lezione Aggiungere elementi dati, regole e librerie, che utilizza 50 come valore predefinito dell’Ordine.

Convalidare gli ID cliente

Per convalidare il lavoro, dovrai accedere al sito Luma per confermare il comportamento della nuova regola.

Per accedere al sito Luma

  1. Apri il sito Luma.

  2. Assicurati che Debugger mappi la proprietà tag in le Ambiente di sviluppo, come descritto in lezione precedente

    L’ambiente di sviluppo tag visualizzato in Debugger

  3. Fai clic sul collegamento ACCESSO nell’angolo in alto a destra del sito Luma

    Fai clic su Accesso nella parte superiore della navigazione

  4. Immetti test@adobe.com come nome utente

  5. Immetti test come password

  6. Fai clic sul pulsante ACCESSO

    Immetti le credenziali e fai clic su accesso

  7. Torna alla pagina principale

Ora, conferma l’invio dell’ID cliente al Servizio utilizzando l’estensione Debugger.

Per verificare che il servizio Identity stia passando l’ID cliente

  1. Assicurati che la scheda con il sito Luma sia visibile

  2. Nel debugger, vai alla scheda del servizio Adobe Experience Platform Identity

  3. Espandi il tuo ID organizzazione

  4. Fai clic sulla cella con il valore Customer ID - crm_id

  5. Nel modale, noterai il valore dell’ID cliente con lo stato AUTHENTICATED:

    Conferma l’ID cliente nel debugger

  6. Tieni presente che puoi confermare il valore dell’e-mail con hash visualizzando il codice sorgente della pagina Luma e controllando la proprietà del nome utente. Questa deve corrispondere al valore visualizzato nel debugger:

    e-mail con hash nel codice sorgente

Suggerimenti aggiuntivi per la convalida

I tag dispongono anche di funzioni avanzate di registrazione della console. Per attivarle, vai alla pagina Strumenti in Debugger e attiva la Registrazione della console dei tag alternare.

Attiva la registrazione della console dei tag

In questo modo attiverai la registrazione della console sia nella console del browser che nella scheda Registri del debugger. Dovresti visualizzare la registrazione di tutte le regole create finora! Tieni presente che le nuove voci di registro si aggiungono nella parte superiore dell’elenco, pertanto la regola “All Pages - Library Loaded - Authenticated - 10” deve essere attivata prima della regola “All Pages - Library Loaded” e apparire sotto di essa nei registri della console di Debugger:

Scheda Registri del debugger

Avanti “Aggiungere Adobe Target” >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2