Adobe Experience Platform Web SDK supporta le funzionalità di condivisione degli ID visitatore, che consentono ai clienti di fornire esperienze personalizzate in modo più accurato, tra app mobili e contenuti web per dispositivi mobili e tra domini diversi.
Un’azienda di abbigliamento vuole personalizzare l’esperienza dei propri clienti in base ai loro interessi e mantenere accurata la personalizzazione in un’app mobile che carica anche WebViews. Utilizzando la funzione di condivisione ID da dispositivo mobile a web, possono garantire che vengano presentate ai clienti le offerte più precise, utilizzando lo stesso identificatore visitatore nell’app e contenuti web per dispositivi mobili trasmettendo ECID all’URL web del dispositivo mobile.
Un rivenditore con più negozi online desidera personalizzare l’esperienza dell’acquirente nei suoi domini, in base agli interessi del cliente. Utilizzando la funzione di condivisione ID tra domini dell’SDK web, il rivenditore può distribuire offerte precise in base agli interessi dei clienti, su tutti i loro domini.
Un rivenditore di tecnologia vuole migliorare il reporting delle attività dei visitatori con informazioni su quando i visitatori passano dall’app mobile al sito web mobile o ad altri domini. Utilizzando la funzione di condivisione ID tra domini diversi dell’SDK per web, il team marketing può tracciare con precisione i visitatori nelle loro proprietà web e generare rapporti sulle attività.
Per utilizzare la condivisione ID da dispositivo mobile a web e tra domini diversi, devi utilizzare Web SDK versione 2.11.0 o successiva.
Per le implementazioni mobili Edge Network, questa funzione è supportata nella Identità per Edge Network estensione che inizia con la versione 1.1.0 (iOS e Android).
Questa funzione è compatibile anche con VisitorAPI.js versione 1.7.0 o successiva.
Utilizza il getUrlVariables
API da Identità per Edge Network per recuperare gli identificatori come parametri di query e allegarli all’URL quando apri webViews.
Non è richiesta alcuna configurazione aggiuntiva per l’accettazione da parte dell’SDK web ECID
valori nella stringa query.
Il parametro della stringa di query include:
MCID
: ID dell’Experience Cloud (ECID
)MCORGID
: L’Experience Cloud orgID
che deve corrispondere al orgID
configurato in Web SDK.TS
: parametro di marca temporale che non può essere precedente ai cinque minuti.La condivisione ID da dispositivo mobile a Web utilizza adobe_mc
parametro. Quando adobe_mc
è presente e valido, il ECID
dalla stringa di query viene aggiunta automaticamente alla mappa delle identità nella prima richiesta effettuata alla rete Edge. Tutte le interazioni successive di Edge Network utilizzeranno tale ECID
.
Per ulteriori informazioni su come passare gli ID visitatore da un’app mobile a una WebView, consulta la documentazione su gestione di WebViews.
Per la condivisione ID tra domini, l'SDK Web versione 2.11.0 aggiunge il supporto per appendIdentityToUrl
comando. Se utilizzato, questo comando genera il adobe_mc
parametro stringa query.
Il comando accetta un oggetto con una proprietà, url
, e restituisce un oggetto con la proprietà url
.
Questo comando non attende alcun aggiornamento del consenso. Se non è stato fornito il consenso, l’URL viene restituito invariato.
Se un ECID
non viene fornito, il /acquire
verrà chiamato l'endpoint per generare un ECID
.
Di seguito è riportato un esempio di come un cliente può implementare la condivisione ID tra domini diversi sul proprio sito web.
Questo codice aggiunge un listener di eventi per tutti i clic sulla pagina e, se il clic si trovava su un collegamento a un dominio corrispondente (in questo caso adobe.com
o behance.com
), aggiunge l’identità all’URL e reindirizza l’utente lì.
document.addEventListener("click", event => {
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) {
return;
}
const url = new URL(anchor.href);
if (!url.hostname.endsWith("adobe.com") && !url.hostname.endsWith("behance.com")) {
return;
}
event.preventDefault();
alloy("appendIdentityToUrl", { url: anchor.href }).then(result => {
document.location = result.url;
});
});
Simile all'utilizzo di Web SDK, non è necessaria alcuna configurazione aggiuntiva nel Tags per utilizzare le identità passate attraverso l'URL.
Per utilizzare la condivisione ID da dispositivo mobile a web e tra domini diversi tramite l’estensione Tag, è necessario utilizzare la versione 2.12.0 o successiva dell’estensione Tag.
Per condividere le identità dalla pagina corrente ad altri domini, è disponibile una nuova azione in Web SDK Tags estensione. Questa azione è progettata per essere utilizzata con Core - Clic tipo di evento e una condizione di confronto dei valori.
Segui i passaggi descritti qui per creare una regola con la seguente configurazione:
Configurazione evento:
Estensione: Core
Tipo evento: fai clic su
Seleziona Quando l’utente fa clic su > elementi specifici
Digita nella Selettore: a[href]
. Questo evento si attiva ogni volta che si fa clic su un tag di ancoraggio sulla pagina con un href
proprietà.
Configurazione condizione
Tipo di logica: Normale
Estensione: Core
Tipo di condizione: Value Comparison
Operando sinistro: %this.hostname%
. Questo è un elemento dati speciale che funziona con Core - Clic e viene risolto nel nome host del collegamento su cui è stato fatto clic.
Operatore: Corrisponde a Regex
Operando destro: digita un’espressione regolare che corrisponda ai domini con cui desideri condividere le identità. Ad esempio, per associare i collegamenti con nomi host che terminano con adobe.com
o behance.com
, utilizza questa espressione regolare: behance.com$|adobe.com$
. La pagina collegata deve avere Web SDK o Visitor ID installato per accettare l’identità.
Configurazione azione
Estensione: Adobe Experience Platform Web SDK
Tipo di azione: Reindirizza con identità
Istanza: seleziona l’istanza. Nella maggior parte dei casi, sarà configurata una sola istanza. Se disponi di più istanze, seleziona quella con l’identità da condividere.
Il Reindirizza con identità impedirà al browser di passare al collegamento. Quindi, chiamerà appendIdentityToUrl
metodo su Web SDK dell'istanza.
Infine, reindirizza l’utente al URL con adobe_mc
parametro stringa query aggiunto.