On-device decisioning per at.js

A partire dalla versione 2.5.0, at.js offre on-device decisioning. On-device decisioning consente di memorizzare nella cache le attività Test A/B e Targeting esperienza (XT) nel browser per eseguire le decisioni in memoria senza una richiesta di blocco della rete all'Edge Network Adobe Target.

Target offre inoltre la flessibilità di fornire l'esperienza più rilevante e aggiornata dalle attività di personalizzazione basate sulla sperimentazione e sull'apprendimento automatico (basate su apprendimento automatico) tramite una chiamata al server live. In altre parole, quando le prestazioni sono più importanti, è possibile scegliere di utilizzare on-device decisioning. Tuttavia, quando è necessaria l’esperienza più rilevante, aggiornata e basata su apprendimento automatico, è possibile effettuare una chiamata al server.

Quali vantaggi offre on-device decisioning?

I vantaggi di on-device decisioning includono:

Funzioni supportate

L'SDK JS di Adobe Target offre ai clienti la flessibilità di scegliere tra prestazioni e aggiornamento dei dati per le decisioni. In altre parole, se la distribuzione dei contenuti personalizzati più rilevanti e coinvolgenti tramite l’apprendimento automatico è la cosa più importante per te, è necessario effettuare una chiamata al server live. Tuttavia, quando le prestazioni sono più importanti, è necessario prendere una decisione su dispositivo e in memoria. Affinché on-device decisioning funzioni, consulta l'elenco delle funzionalità supportate:

Per ulteriori informazioni, vedere Funzionalità supportate per on-device decisioning.

Come funziona on-device decisioning?

Quando distribuisci e inizializzi at.js con on-device decisioning abilitato, un artefatto regola che include on-device decisioning per attività A/B e XT, tipi di pubblico e risorse, viene scaricato dalla rete CDN Akamai più vicina al visitatore e memorizzato nella cache locale nel browser del visitatore. Quando si effettua una richiesta da at.js per recuperare un’esperienza, la decisione relativa all’esperienza da restituire viene presa in memoria, in base ai metadati codificati nell’artefatto della regola memorizzata nella cache.

Metodo di decisione

Con on-device decisioning, Target introduce una nuova impostazione denominata Metodo di decisione. L’impostazione del metodo Decisioning determina il modo in cui at.js distribuisce le esperienze. Il metodo Decisioning ha tre valori:

Solo lato server

Solo lato server è il metodo decisionale predefinito impostato automaticamente quando at.js 2.5.0+ viene implementato e distribuito sulle proprietà web.

Se si utilizza solo lato server come configurazione predefinita, tutte le decisioni vengono prese sulla rete Edge Target, il che comporta una chiamata di blocco al server. Questo approccio può introdurre una latenza incrementale, ma offre anche vantaggi significativi, come la possibilità di applicare le funzionalità di machine learning di Target, che includono attività Recommendations, Automated Personalization (AP) e Targeting automatico.

Inoltre, migliorare le tue esperienze personalizzate utilizzando il profilo utente di Target, che viene mantenuto tra sessioni e canali diversi, può fornire risultati potenti per la tua azienda.

Infine, solo lato server consente di utilizzare Adobe Experience Cloud e di perfezionare i tipi di pubblico a cui rivolgersi tramite i segmenti Audience Manager e Adobe Analytics.

Il diagramma seguente illustra l'interazione tra il visitatore, il browser, at.js 2.5.0+ e la rete Edge Adobe Target. Questo diagramma di flusso acquisisce nuovi visitatori e visitatori di ritorno.

(Fare clic sull'immagine per espanderla a larghezza intera.)

{modal="regular"}

L'elenco seguente corrisponde ai numeri del diagramma:

Solo su dispositivo

Solo su dispositivo è il metodo decisionale che deve essere impostato in at.js 2.5.0+ quando on-device decisioning deve essere utilizzato solo in tutte le pagine web.

On-device decisioning può fornire le tue esperienze e attività di personalizzazione a una velocità sorprendente perché le decisioni sono prese da un artefatto di regole memorizzate nella cache che contiene tutte le tue attività che si qualificano per on-device decisioning.

Per ulteriori informazioni sulle attività idonee per on-device decisioning, vedere Funzioni supportate in on-device decisioning.

Questo metodo decisionale deve essere utilizzato solo se le prestazioni sono altamente critiche in tutte le pagine che richiedono decisioni da Target. Inoltre, ricorda che quando viene selezionato questo metodo decisionale, le attività Target che non sono idonee per on-device decisioning non verranno consegnate o eseguite. La libreria at.js 2.5.0+ è configurata per cercare solo l’artefatto delle regole memorizzate nella cache per prendere decisioni.

Il diagramma seguente illustra l’interazione tra il visitatore, il browser, at.js 2.5.0+ e la rete CDN di Akamai. Il CDN di Akamai memorizza in cache l’artefatto delle regole per la prima visita del visitatore. Per la prima visita di pagina di un nuovo visitatore, l’artefatto delle regole JSON deve essere scaricato dalla rete CDN Akamai per essere memorizzato nella cache locale nel browser del visitatore. Una volta scaricato l’artefatto delle regole JSON, la decisione viene presa immediatamente senza una chiamata di rete di blocco. Il seguente diagramma di flusso acquisisce nuovi visitatori.

(Fare clic sull'immagine per espanderla a larghezza intera.)

{modal="regular"}

L'elenco seguente corrisponde ai numeri del diagramma:

Il diagramma seguente illustra l’interazione tra il visitatore, il browser, at.js 2.5.0+, e l’artefatto della regola JSON memorizzato nella cache per l’hit pagina o la visita di ritorno del visitatore. Poiché l’artefatto delle regole JSON è già memorizzato nella cache e disponibile sul browser, la decisione viene presa immediatamente senza una chiamata di rete di blocco. Questo diagramma di flusso acquisisce la navigazione successiva della pagina o i visitatori di ritorno.

(Fare clic sull'immagine per espanderla a larghezza intera.)

{modal="regular"}

L'elenco seguente corrisponde ai numeri del diagramma:

Ibrido

Ibrido è il metodo decisionale che deve essere impostato in at.js 2.5.0+ quando è necessario eseguire sia on-device decisioning che le attività che richiedono una chiamata alla rete Edge Adobe Target.

Quando gestisci sia le attività on-device decisioning che quelle lato server, può essere un po' complicato e noioso pensare a come distribuire ed eseguire il provisioning di Target nelle pagine. Con il metodo decisionale ibrido, Target sa quando deve effettuare una chiamata al server alla rete Edge Adobe Target per le attività che richiedono l'esecuzione lato server e anche quando eseguire solo le decisioni su dispositivo.

L'artefatto delle regole JSON include metadati per informare at.js se una mbox ha un'attività lato server in esecuzione o un'attività on-device decisioning. Questo metodo decisionale assicura che le attività che intendi consegnare rapidamente vengano eseguite tramite on-device decisioning e che quelle che richiedono una personalizzazione basata su ML più potente vengano eseguite tramite la rete Edge Adobe Target.

Il diagramma seguente illustra l'interazione tra il visitatore, il browser, at.js 2.5.0+, la rete CDN di Akamai e l'Edge Network Adobe Target per un nuovo visitatore che visita la pagina per la prima volta. La rimozione da questo diagramma consiste nel fatto che l'artefatto delle regole JSON viene scaricato in modo asincrono mentre le decisioni vengono prese tramite la rete Edge Adobe Target.

Questo approccio assicura che la dimensione dell’artefatto, che può includere molte attività, non influisca negativamente sulla latenza della decisione. Il download dell’artefatto delle regole JSON in modo sincrono e la decisione successiva può avere anche effetti negativi sulla latenza e può essere incoerente. Pertanto, il metodo di decisione ibrido è un consiglio sulle best practice per effettuare sempre una chiamata lato server per la decisione relativa a un nuovo visitatore e poiché l’artefatto delle regole JSON viene memorizzato nella cache in parallelo. Per tutte le visite di pagina e le visite di ritorno successive, le decisioni vengono prese dalla cache e nella memoria tramite l’artefatto delle regole JSON.

(Fare clic sull'immagine per espanderla a larghezza intera.)

{modal="regular"}

L'elenco seguente corrisponde ai numeri del diagramma:

Il diagramma seguente illustra l’interazione tra il visitatore, il browser, at.js 2.5.0+, e l’artefatto delle regole JSON memorizzate nella cache per una navigazione di pagina successiva o per una visita di ritorno. In questo diagramma, concentra l’attenzione solo sul caso d’uso in cui viene presa una decisione sul dispositivo per la successiva navigazione della pagina o visita di ritorno. Tieni presente che, a seconda delle attività live per determinate pagine, è possibile effettuare una chiamata lato server per eseguire decisioni lato server.

(Fare clic sull'immagine per espanderla a larghezza intera.)

{modal="regular"}

L'elenco seguente corrisponde ai numeri del diagramma:

Come si abilita on-device decisioning?

On-device decisioning è disponibile per tutti i Target clienti che utilizzano At.js 2.5.0+.

Per abilitare on-device decisioning:

Dopo aver attivato l'interruttore Decisioning sul dispositivo, Target inizia a generare e propagare artefatti regola per il client.

Come si configura at.js 2.5.0+ per utilizzare on-device decisioning?

Impostazioni globali

È possibile configurare un metodo di decisione predefinito per tutte le Target decisioni. I vari metodi decisionali sono Solo lato server, Solo su dispositivo e Ibrido. Il metodo decisionale selezionato nell'interfaccia utente Target è configurato in window.targetGlobalSettings nel campo decisioningMethod. Ulteriori informazioni su decisioningMethod in targetGlobalSettings().

<head>
    <script type="text/javascript">

        window.targetGlobalSettings = {
            clientCode: "yourClientCodeHere",
            imsOrgId: "imsOrgId@AdobeOrg",
            decisioningMethod: "on-device"

        };
    </script>

    <script type="text/javascript" src="at.js"></script>
</head>

Impostazione personalizzata

Se si imposta decisioningMethod in window.targetGlobalSettings, ma si desidera ignorare decisioningMethod per ogni decisione Adobe Target in base al caso d'uso, è possibile eseguire questa procedura specificando decisioningMethod nella chiamata getOffers() di at.js2.5.0+.

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});

TTL cache artefatto

Target rappresenta le attività che si qualificano per on-device decisioning come artefatto costituito da metadati, regole e condizioni. Questo artefatto viene memorizzato nella cache sulla rete CDN Akamai. Durante la prima visita dell'utente, il browser dell'utente scarica e memorizza in cache l'artefatto che rappresenta le attività di on-device decisioning.

Nelle visite successive al sito, il browser controlla automaticamente se deve scaricare una versione più recente dell’artefatto. Questo controllo aggiunge latenza. Il valore TTL della cache degli artefatti definisce il numero di minuti necessari affinché il browser non controlli la presenza di un artefatto aggiornato dall’ultimo download riuscito. Più è lungo l'intervallo di tempo, migliori saranno le prestazioni. Più breve è l’intervallo di tempo, migliore sarà l’aggiornamento dei dati, ma a costo di una latenza aggiuntiva.

Come posso sapere se un'attività è idonea on-device decisioning?

Dopo aver creato un'attività idonea per on-device decisioning, un'etichetta che indica Idonea a Decisioning sul dispositivo è visibile nella pagina Panoramica dell'attività.

Questa etichetta non significa che l'attività verrà sempre recapitata tramite on-device decisioning. Questa attività verrà eseguita sul dispositivo solo quando at.js 2.5.0+ è configurato per l'utilizzo di on-device decisioning. Se at.js 2.5.0+ non è configurato per l’utilizzo su dispositivo, questa attività verrà comunque consegnata tramite una chiamata al server effettuata da at.js.

È possibile filtrare tutte le attività idonee per on-device decisioning nella pagina Attività tramite il filtro Idoneo Decisioning sul dispositivo.

Riepilogo dei passaggi per garantire che le mie attività on-device decisioning vengano consegnate tramite At.js 2.5.0+?