14.3 Prepara ad Offer decisioning la proprietà client di raccolta dati Adobe Experience Platform e la configurazione dell’SDK per web

NOTA

L’utilizzo di Offer Decisioning in Adobe Experience Platform Web SDK è attualmente disponibile in fase di accesso anticipato a determinati utenti. Questa funzionalità non è disponibile per tutte le organizzazioni IMS.

14.3.1 Aggiorna il tuo Datastream

In Esercizio 0.2, hai creato il tuo Datastream. Hai quindi utilizzato il nome ldap - Datastream del sistema demo e sostituito ldap con il tuo ldap.

In questo esercizio, devi configurare che Datastream per lavorare con Offer Decisioning.

Per farlo, vai a https://experience.adobe.com/#/data-collection/. Vedrete questo. Fai clic su Datastreams. Cerca il tuo Datastream. Fai clic su Datastream per aprirlo.

WebSDK

Vedrete questo. Fai clic su Ambiente di sviluppo.

WebSDK

In Ambiente di sviluppo, visualizzerai la tua configurazione Adobe Experience Platform.

WebSDK

Per abilitare Offer Decisioning, seleziona la casella per Offer Decisioning.

WebSDK

Fai clic su Salva

WebSDK

Allora tornerai qui. Fai clic su Ambiente di staging.

WebSDK

Per abilitare Offer Decisioning, seleziona la casella per Offer Decisioning.

WebSDK

Fai clic su Salva

WebSDK

Allora tornerai qui. Fai clic su Ambiente di produzione.

WebSDK

Per abilitare Offer Decisioning, seleziona la casella per Offer Decisioning.

WebSDK

Fai clic su Salva

WebSDK

Le Datastream è ora pronto per lavorare con Offer Decisioning.

14.3.2 Configura la proprietà client di raccolta dati di Adobe Experience Platform per richiedere offerte personalizzate

Vai a https://experience.adobe.com/#/data-collection/, a Client. Cerca le proprietà del client di raccolta dati di Adobe Experience Platform, denominate ldap - Demo System (DD/MM/YYYY). Apri la proprietà Adobe Experience Platform Data Collection Client per il Web.

WebSDK

Nella tua proprietà, vai a Regole e apri la regola Tutte le pagine generali.

WebSDK

Fai clic per aprire Azione AEP Web SDK - Evento di invio.

WebSDK

Vedrete questo. Noterai l'opzione di menu per Ambiti decisionali.

WebSDK

Per ogni richiesta inviata a Edge e Adobe Experience Platform, è possibile fornire uno o più Ambiti decisionali. A Campo di applicazione della decisione è una combinazione di due elementi:

  • ID decisione
  • ID posizionamento

Diamo un'occhiata dove potete trovare questi due elementi.

14.3.2.1 Recupera il tuo ID posizionamento

La ID posizionamento identifica la posizione e il tipo di risorsa richiesti. Ad esempio, l’immagine protagonista nella home page del sito web Luma corrisponde alla ID posizionamento per Web - Immagine.

WebSDK

Per trovare il ID posizionamento per Web - Immagine vai a https://platform.adobe.com.

Quindi, vai a Componenti e poi a Posizionamenti. Fai clic sul pulsante Web - Immagine posizionamento per visualizzarne i dettagli.

WebSDK

Come puoi vedere nell’immagine precedente, in questo esempio il ID posizionamento è xcore:offer-placement:129048460001fd30. Annota la ID posizionamento per il tuo posizionamento Web - Immagine come ne avrete bisogno nel prossimo esercizio.

14.3.2.2 Recupera il tuo ID decisione

La ID decisione identifica la combinazione di Offerte personalizzate e Offerte di fallback che desideri utilizzare. Nell’esercizio precedente, hai creato la tua Decisione e lo ha chiamato ldap - Decisione Luma.

Per trovare il ID decisione per ldap - Decisione Luma, vai a https://platform.adobe.com.

Quindi, vai a Offerte e poi vai a Decisioni. Fai clic per selezionare il tuo Decisione, denominato ldap - Decisione Luma.

WebSDK

Come puoi vedere nell’immagine precedente, in questo esempio il ID decisione è xcore:offer-activity:1290525f4441fd6e. Annota la ID decisione per la vostra decisione ldap - Decisione Luma come ne avrete bisogno nel prossimo esercizio.

Ora che hai recuperato i due elementi necessari per creare un Ambiti decisionali, puoi continuare con il passaggio successivo, che comporta la codifica dell’ambito decisionale.

Codifica 14.3.2.3 BASE64

La Campo di applicazione della decisione è necessario immettere una stringa codificata BASE64. Questa stringa codificata BASE64 è una combinazione della ID posizionamento e ID decisione, come potete vedere di seguito.

{
  "activityId":"xcore:offer-activity:1290525f4441fd6e",
  "placementId":"xcore:offer-placement:129048460001fd30"
}

La Campo di applicazione della decisione può essere generato in due modi:

  • Utilizzare un servizio pubblico come https://www.base64encode.org/. Immetti il codice JSON come menzionato sopra, fai clic su Codifica e otterrai la tua stringa codificata BASE64 qui sotto.

    WebSDK

  • Recupera la stringa codificata BASE64 da Adobe Experience Platform. Per farlo, vai a https://platform.adobe.com. Quindi, vai a Decisioni e fai clic su per aprire Decisione, denominato ldap - Decisione Luma.

    WebSDK

    Dopo aver aperto la ldap - Decisione Luma Lo vedrete. Individua il posizionamento Web - Immagine e fai clic su Copia pulsante . Quindi, fai clic su Ambito della decisione codificato. La Campo di applicazione della decisione viene ora copiato negli Appunti.

    WebSDK

Quindi, torna a Launch, alla tua azione AEP Web SDK - Evento di invio.

WebSDK

Assicurati di selezionare l’opzione Immetti i valori quindi incolla l'ambito decisionale codificato BASE64 nel campo di input.

WebSDK

Salva le modifiche nell’azione. AEP Web SDK - Evento di invio facendo clic su Mantieni modifiche.

WebSDK

Quindi, fai clic su Salva o Salva nella libreria

WebSDK

In Raccolta dati di Adobe Experience Platform, vai a Flusso di pubblicazione e aprire il Libreria di sviluppo denominato Libreria dei contenuti. Fai clic su + Aggiungi tutte le risorse modificate quindi fai clic su Salva e genera per sviluppo. Le modifiche verranno ora pubblicate sul sito web demo.

WebSDK

Ogni volta che carichi un Pagina Generale ora, come per esempio la homepage del sito web demo, Offer Decisioning valuterà quale sia l'offerta applicabile e restituirà una risposta al sito web con i dettagli dell'offerta da mostrare. La visualizzazione dell’offerta sul sito web richiede una configurazione aggiuntiva, che eseguirai nel passaggio successivo.

14.3.3 Configura la proprietà client di raccolta dati di Adobe Experience Platform per ricevere e applicare offerte personalizzate

Vai a https://experience.adobe.com/#/data-collection/, a Proprietà. Cerca le proprietà del client di raccolta dati di Adobe Experience Platform, denominate ldap - Demo System (DD/MM/YYYY). Apri la proprietà Adobe Experience Platform Data Collection Client per il Web.

WebSDK

Nella tua proprietà, vai a Regole.

WebSDK

Fai clic su Aggiungi regola.

WebSDK

Come nome della regola, utilizza Homepage - Decisione ricevuta.

WebSDK

14.3.3.1 Evento

Fai clic su + Aggiungi sotto EVENTI per aggiungere un nuovo evento.

WebSDK

Per Configurazione evento, seleziona questo:

  • Estensione: AEP Web SDK
  • Tipo evento: Decisioni ricevute

WebSDK

Fai clic su Mantieni modifiche.

WebSDK

14.3.3.2 Condizione

Ora vedrete questo. Fai clic su + Aggiungi sotto CONDIZIONI per aggiungere una nuova condizione.

WebSDK

Per Configurazione condizione, seleziona questo:

  • Tipo di logica: Regolare
  • Estensione: Core
  • Tipo di condizione: Value Comparison
  • Nome: Core - Value Comparison
  • Restituisce true se
    • %pageName%
    • È uguale a
    • Luma Home

WebSDK

Fai clic su Mantieni modifiche.

WebSDK

14.3.3.3 Azione

Vedrete questo. Fai clic su + Aggiungi sotto AZIONI per aggiungere una nuova azione.

WebSDK

Per Configurazione azione, seleziona questo:

  • Estensione: Core
  • Tipo di azione: Codice personalizzato
  • Lingua: JavaScript

Quindi, fai clic su Open Editor

WebSDK

Incolla il codice seguente nell'editor.

event.decisions.forEach(function(payload) {
  payload.items.forEach(function(item) {
    console.log(">>>>> Offer Decisioning Web SDK Response", item);
    document.getElementById("brandhero").src = item.data.deliveryURL;
  });
});

WebSDK

Fai clic su Salva.

WebSDK

Fai clic su Mantieni modifiche.

WebSDK

Quindi, fai clic su Salva o Salva nella libreria

WebSDK

In Raccolta dati di Adobe Experience Platform, vai a Flusso di pubblicazione e aprire il Libreria di sviluppo denominato Libreria dei contenuti. Fai clic su + Aggiungi tutte le risorse modificate quindi fai clic su Salva e genera per sviluppo. Le modifiche verranno ora pubblicate sul sito web demo.

WebSDK

Con questa modifica, questa regola in Adobe Experience Platform Data Collection sarà in ascolto della risposta dell’Offer decisioning che fa parte della risposta dell’SDK per web e, quando la risposta viene ricevuta, l’immagine dell’offerta verrà visualizzata nella home page.

Osservando il sito web dimostrativo Luma, vedrai che questa immagine verrà sostituita ora:

WebSDK

E invece dell’immagine protagonista Luma predefinita, vedrai un’offerta come questa:

WebSDK

Nell’esercizio successivo, passerai a uno scenario demo dettagliato.

Passaggio successivo: 14.4 Prova la tua decisione utilizzando il sito web demo

Torna al modulo 14

Torna a tutti i moduli

In questa pagina