DocumentazioneExperience PlatformTutorial web

Aggiungere Adobe Experience Platform Identity Service

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

Questa lezione illustra i passaggi necessari per implementare l’estensione Adobe Experience Platform Identity Service e inviare gli ID cliente.

Il servizio Adobe Experience Platform Identity imposta un ID visitatore comune in tutte le soluzioni Adobe per abilitare 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 quando si utilizza questo contenuto:

Finalità di apprendimento

Alla fine di questa lezione, potrai:

  • Aggiungere l’estensione Identity Service
  • 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 nella sezione Configurare i tag.

Aggiungere l’estensione Identity Service

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 che desideri.

Per aggiungere l’estensione Identity Service

  1. Nel menu di 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 della pagina, digita “ID” per filtrare il Catalogo

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

    Installare l’estensione Identity Service

  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 Identity Service.

Convalidare l’estensione

L’estensione del servizio Identity è una delle poche estensioni tag che effettuano una richiesta senza dover utilizzare un’azione delle regole. L’estensione invia automaticamente una richiesta a Identity Service 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 Identity Service

  1. Apri il sito Luma.

  2. Accertati che Debugger mappi la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione precedente.

  3. Nella scheda Riepilogo del debugger, la sezione dei 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 visualizzato nella schermata di configurazione dell’estensione nell’interfaccia di Data Collection:

    Verifica che l’estensione Adobe Experience Platform Identity Service sia implementata

  5. Nella scheda Identity Service 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 a Identity Service 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 poiché il sito Luma è stato caricato utilizzando sia la sua proprietà di tag di codifica fissa, sia quella mappata sulla tua.

      Verifica il cookie AMCV_

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

Inviare ID cliente

Successivamente, invierai un ID cliente a Identity Service. 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 nel menu di 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 elemento dati, selezionare 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 verranno apportate tutte le modifiche e non si sarà 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 a Identity Service. 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 elemento dati, selezionare Variabile JavaScript

  4. Come nome 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

Adobe Experience Platform Identity Service 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. Nel menu di 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 fare clic su Aggiungi

    Aggiungere un evento

    1. Per Tipo evento seleziona Libreria caricata (parte superiore pagina)
    2. Espandi la sezione Opzioni avanzate e per Ordine immetti 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 fare clic su Aggiungi

    Aggiungere una condizione alla regola

    1. Per Tipo condizione selezionare Confronto valori

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

      aprire l’elemento dati modale

    3. Nel modale Elemento dati, fai clic su Stato autenticazione, quindi 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 fare clic su Aggiungi

    Aggiungere una nuova azione

    1. Per Extension seleziona Experience Cloud ID Service

    2. Per Tipo azione seleziona Imposta ID cliente

    3. Per Codice integrazione immettere crm_id

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

    5. Per Stato autenticazione selezionare 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. Accertati che Debugger mappi la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione precedente

    Lambiente di sviluppo dei tag visualizzato in Debugger

  3. Fai clic sul collegamento ACCESSO nell'angolo superiore destro del sito Luma

    Fai clic su Accedi nell’area di navigazione in alto

  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 Identity Service stia passando l’ID cliente

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

  2. Nel debugger, vai alla scheda di Adobe Experience Platform Identity Service

  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 attivarli, vai alla scheda Strumenti nel debugger e attiva l'opzione Registrazione console tag.

Attiva/disattiva 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