Condivisione ID da dispositivo mobile a web e tra domini

Ultimo aggiornamento: 2023-09-11
  • Argomenti:
  • Web SDK
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer
    User
    Admin
    Leader

Panoramica

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.

Casi d’uso

Distribuire una personalizzazione coerente tra app mobili e siti web per dispositivi mobili

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.

Distribuire una personalizzazione coerente tra i domini

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.

Migliorare il reporting delle attività dei visitatori

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

Prerequisiti

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.

Condivisione ID da dispositivo mobile a web

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.

Condivisione ID tra domini

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;
  });
});

Utilizzo dell’estensione Tag

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

      Immagine dell’interfaccia utente che mostra la configurazione dell’evento con le impostazioni descritte in precedenza

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

      Immagine dell’interfaccia utente che mostra la configurazione della condizione con le impostazioni descritte in precedenza

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

      Immagine dell’interfaccia utente che mostra la configurazione dell’azione con le impostazioni descritte in precedenza

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.

In questa pagina