DocumentazioneJourney OptimizerGuida di Journey Optimizer

Superfici di esperienza basate su codice code-based-surface

Last update: Fri Nov 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore

Che cos’è una superficie? surface-definition

Un'esperienza basata su codice surface è qualsiasi entità progettata per l'interazione dell'utente o del sistema, identificata in modo univoco da un URI. La superficie è specificata nell'implementazione dell'applicazione e deve corrispondere alla superficie a cui si fa riferimento nella configurazione del canale esperienza basata su codice.

Una superficie può essere vista come un contenitore a qualsiasi livello gerarchico con un’entità (punto di contatto) esistente.

  • Può essere una pagina web, un’app mobile, un’app desktop o una posizione di contenuto specifica all’interno di un’entità più grande (ad esempio un div) o un pattern di visualizzazione non standard (ad esempio, un chiosco o un banner per app desktop).

  • Può anche estendersi a contenitori di contenuto specifici per scopi non di visualizzazione o visualizzazione astratta (ad esempio, BLOB JSON consegnati ai servizi).

  • Può anche essere una superficie con caratteri jolly che corrisponde a una varietà di definizioni di superficie client (ad esempio, la posizione di un’immagine principale su ogni pagina del sito web potrebbe tradursi in un URI di superficie come: web://mydomain.com/*#hero_image).

Identificatore di superficie surface-uri

Un URI di superficie funge da identificatore preciso per indirizzare elementi o componenti distinti dell'interfaccia utente in un'applicazione. Fondamentalmente, un URI di superficie è composto da più sezioni:

  1. Tipo: web, app mobile, sportello bancomat, chiosco, tvcd, servizio ecc.
  2. Proprietà: URL pagina o pacchetto di app
  3. Contenitore: posizione nell’attività pagina/app

La tabella seguente elenca alcuni esempi di definizione di URI di superficie per vari dispositivi.

Web e dispositivi mobili

Tipo
URI
Descrizione
Web
web://domain.com/path/page.html#element
Rappresenta un singolo elemento all’interno di una pagina specifica di un dominio specifico, dove un elemento può essere un’etichetta come negli esempi seguenti: hero_banner, top_nav, menu, piè di pagina, ecc.
App iOS
mobileapp://com.vendor.bundle/activity#element
Rappresenta un elemento specifico all’interno dell’attività di un’app nativa, ad esempio un pulsante o un altro elemento della vista.
App Android
mobileapp://com.vendor.bundle/#element
Rappresenta un elemento specifico di un’app nativa.

Altri tipi di dispositivi

Tipo
URI
Descrizione
Desktop
desktop://com.vendor.bundle/#element
Rappresenta un elemento specifico all’interno di un’applicazione, ad esempio un pulsante, un menu, un banner principale e così via.
App TV
tvcd://com.vendor.bundle/#element
Rappresenta un elemento specifico all’interno di un bundle di app per dispositivi collegati a smart TV o TV.
Servizio
service://servicename/#element
Rappresenta un processo lato server o altra entità manuale.
Chiosco
kiosk://location/screen#element
Esempio di possibili ulteriori tipi di superficie che possono essere aggiunti facilmente.
ATM
atm://location/screen#element
Esempio di possibili ulteriori tipi di superficie che possono essere aggiunti facilmente.

Superfici jolly

Tipo
URI
Descrizione
Web jolly
wildcard:web://domain.com/*#element
Superficie jolly: rappresenta un singolo elemento in ciascuna pagina in un dominio specifico.
Web jolly
wildcard:web://*domain.com/*#element
Superficie jolly: rappresenta un singolo elemento in ciascuna pagina di tutti i domini che finiscono con “domain.com”.

Composizione URI uri-composition

In Journey Optimizer, il canale di esperienza basato su codice supporta due tipi di implementazioni del cliente:

NOTE
Ulteriori informazioni sui prerequisiti di implementazione in questa sezione.

Utilizzando esperienze basate su codice, puoi modificare il contenuto nelle posizioni granulari che sono identificate in modo univoco da Journey Optimizer utilizzando URI di superficie.

Questi URI di superficie sono composti e gestiti a seconda del metodo di implementazione:

  • Web/Mobile SDK: lo sviluppatore Web/Mobile deve definire queste posizioni granulari come stringhe semplici, perché Web/Mobile SDK è in grado di comporre automaticamente l'URI di superficie in base all'URL/ID app corrente e alla stringa di posizione.

  • API di Edge Network: lo sviluppatore di app/pagine deve definire URI di superficie completi che includano il percorso completo e la posizione in cui verrà utilizzato il contenuto, perché in questo tipo di implementazione sono necessari URI completi.

Per questo motivo, quando crei una configurazione del canale esperienza basata su codice, puoi specificare la superficie in due modi in base alla piattaforma selezionata:

  • Per le piattaforme Web, iOS e Android, è necessario immettere l'URL/ID app e un percorso o percorso per comporre la superficie. Ulteriori informazioni sulla configurazione di esperienze basate su codice per piattaforme web e mobile

  • Se la piattaforma è Altro, devi immettere l'URI di superficie completo, come negli esempi precedenti. Ulteriori informazioni sulla configurazione di esperienze basate su codice per altre piattaforme

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76