DocumentazioneJourney OptimizerGuida di Journey Optimizer

Configurare l’esperienza basata su codice in anteprima code-based-configuration

Last update: Mon Oct 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore

Prima di creare la tua esperienza, devi creare una configurazione di esperienza basata su codice in cui definisci dove verranno consegnati e utilizzati i contenuti all'interno dell'applicazione.

Una configurazione di esperienza basata su codice deve fare riferimento alla superficie, che è fondamentalmente la posizione in cui desideri eseguire il rendering delle modifiche. A seconda della piattaforma selezionata, è necessario immettere una posizione o un percorso oppure l'URI della superficie completa. Ulteriori informazioni

Creare una configurazione di esperienza basata su codice create-code-based-configuration

Per creare una configurazione del canale esperienza basata su codice, effettua le seguenti operazioni:

  1. Accedi al menu Canali > Impostazioni generali > Configurazioni canale, quindi fai clic su Crea configurazione canale.

  2. Immetti un nome e una descrizione (facoltativa) per la configurazione.

    note note
    NOTE
    I nomi devono iniziare con una lettera (A-Z). Può contenere solo caratteri alfanumerici. È inoltre possibile utilizzare i caratteri di sottolineatura _, punto. e trattino -.

  3. Per assegnare etichette di utilizzo dei dati personalizzate o di base alla configurazione, è possibile selezionare Gestisci accesso. Ulteriori informazioni sul controllo degli accessi a livello di oggetto (OLAC)

  4. Seleziona Azione di marketing per associare i criteri di consenso ai messaggi utilizzando questa configurazione. Tutti i criteri di consenso associati all’azione di marketing vengono utilizzati per rispettare le preferenze dei clienti. Ulteriori informazioni

  5. Seleziona il canale esperienza basata su codice.

  6. Seleziona la piattaforma per la quale verrà applicata l’esperienza basata su codice:

    note note
    NOTE
    Puoi selezionare diverse piattaforme. Quando si selezionano più piattaforme, il contenuto viene distribuito a tutte le pagine o app selezionate.

  7. Scegliere il formato previsto dall'applicazione per questa posizione particolare. Verrà utilizzato per creare l’esperienza basata su codice in campagne e percorsi.

  8. Fai clic su Invia per salvare le modifiche.

Ora puoi selezionare questa configurazione durante la creazione di un'esperienza basata su codice nelle campagne e nei percorsi.

NOTE
Il team di implementazione dell’app è responsabile dell’esecuzione di chiamate API o SDK esplicite per recuperare il contenuto per le superfici definite nella configurazione dell’esperienza basata su codice selezionata. Ulteriori informazioni sulle diverse implementazioni del cliente in questa sezione.

Piattaforme web web

Per definire le impostazioni di configurazione dell’esperienza basata su codice per le piattaforme web, segui i passaggi indicati di seguito.

  1. Selezionare una delle opzioni seguenti:

    • Pagina singola - Se desideri applicare le modifiche esclusivamente a una singola pagina, immetti un URL pagina.

    • Regola di corrispondenza pagine - Per eseguire il targeting di più URL che corrispondono alla stessa regola, genera una o più regole. Ulteriori informazioni

      Ad esempio, se desideri modificare gli elementi visualizzati in tutte le pagine del sito Web Luma relative alle donne, seleziona Dominio > Inizia con > luma e Pagina > Contiene > women.

  2. Per l’URL di anteprima vale quanto segue:

    • Se viene immesso un URL di una singola pagina, questo verrà utilizzato per l’anteprima e non è necessario immettere un altro URL.

    • Se è selezionata una regola corrispondente alle pagine, devi immettere un URL predefinito per l'authoring e l'anteprima che verrà utilizzato per visualizzare l'anteprima dell'esperienza nel browser. Ulteriori informazioni

  3. Il campo Posizione nella pagina specifica la destinazione esatta all'interno della pagina a cui si desidera che gli utenti accedano. Può essere una sezione particolare di una pagina all’interno della struttura di navigazione del sito, ad esempio "hero-banner" o "product-rail".

Piattaforme mobili (iOS e Android) mobile

Per definire le impostazioni di configurazione dell’esperienza basata su codice per le piattaforme mobili, segui i passaggi indicati di seguito.

  1. Immetti ID app. Questo consente un’identificazione e una configurazione accurate all’interno dell’ambiente operativo dell’app e garantisce l’integrazione e la funzionalità senza interruzioni.

  2. Specifica il percorso o la posizione nell'app. Questo campo specifica la destinazione esatta all’interno dell’app a cui desideri che gli utenti accedano. Può trattarsi di una sezione o di una pagina particolare all’interno della struttura di navigazione dell’app, ad esempio "hero-banner" o "product-rail".

  3. Compila il campo URL anteprima per abilitare le anteprime su dispositivo. Questo URL informa il servizio di anteprima dell’URL specifico da utilizzare quando si attiva l’anteprima sul dispositivo. Ulteriori informazioni

    L'URL di anteprima è un collegamento profondo configurato dallo sviluppatore dell'app all'interno dell'app. In questo modo, gli URL che corrispondono allo schema di collegamento profondo si apriranno all’interno dell’app anziché in un browser web per dispositivi mobili. Contatta il tuo sviluppatore di app per ottenere lo schema di collegamento profondo configurato per la tua app.

Le seguenti risorse possono essere utili per configurare collegamenti profondi per l’implementazione dell’app
NOTE
In caso di problemi durante l'anteprima dell'esperienza, consulta questa documentazione.

Altre piattaforme other

Per definire le impostazioni di configurazione dell’esperienza basata su codice per altre piattaforme (come console video, dispositivi collegati alla TV, smart TV, chioschi, sportelli bancomat, assistenti vocali, dispositivi IoT e così via), segui la procedura riportata di seguito.

  1. Seleziona Altro come piattaforma se la tua implementazione non è per Web, iOS o Android oppure se devi eseguire il targeting di URI specifici.

  2. Immettere l'URI superficie. Un URI di superficie è un identificatore univoco corrispondente all’entità in cui desideri fornire l’esperienza. Ulteriori informazioni

    note caution
    CAUTION
    Assicurati di immettere un URI di superficie che corrisponda a quello utilizzato nella tua implementazione. In caso contrario, non sarà possibile consegnare le modifiche.

  3. Se necessario, aggiungere un altro URI di superficie. Puoi aggiungere fino a 10 URI.

    note note
    NOTE
    Quando si aggiungono più URI, il contenuto viene distribuito a tutti i componenti elencati.

Che cos’è una superficie? surface-definition

Un'esperienza basata su codice surface è qualsiasi entità progettata per l'interazione utente o di 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 basato 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).

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 una posizione o un percorso per comporre la superficie.

  • Se la piattaforma è Altro, è necessario immettere l'URI di superficie completo, come negli esempi seguenti.

Un URI di superficie funge da identificatore preciso che si dirige verso elementi o componenti distinti dell’interfaccia utente all’interno di 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”.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76