Creare e visualizzare le offerte con Gestione delle decisioni

Nell'interfaccia utente di Data Collection, seleziona Datastreams e quindi il tuo datastream, ad esempio Luma Mobile App.

Seleziona per Experience Platform e seleziona Modifica dal menu di scelta rapida.

Nella schermata Datastreams > > Adobe Experience Platform, assicurati che siano selezionati Offer Decisioning, Edge Segmentation e Adobe Journey Optimizer. Se vuoi seguire la lezione di Target, seleziona anche Destinazioni Personalization. Per ulteriori informazioni, vedere Impostazioni di Adobe Experience Platform.

Per salvare la configurazione dello stream di dati, seleziona Salva.

Passa a Tag, individua la proprietà del tag mobile e apri la proprietà.

Seleziona Estensioni.

Seleziona Catalogo.

Cerca l'estensione Adobe Journey Optimizer - Decisioning.

Installa l’estensione. L'estensione non richiede una configurazione aggiuntiva.

Nell'interfaccia utente di Journey Optimizer, seleziona Componenti da GESTIONE DECISIONI nella barra a sinistra.

Seleziona Posizionamenti dalla barra superiore.

Se non è presente alcun posizionamento con nome JSON per dispositivi mobili come ​​ Tipo di canale ​​ e ​​ JSON ​​ come ​​ Tipo di contenuto ​​ , è necessario creare un posizionamento. In caso contrario, continuare a Creare le offerte.

Seleziona Crea posizionamento.

1. nella sezione Dettagli, immetti Mobile JSON come Nome, seleziona Mobile da Tipo di canale e JSON da Tipo di contenuto.
2. Seleziona Salva per salvare il posizionamento.

Nell'interfaccia utente di Journey Optimizer, seleziona Offerte da GESTIONE DELLE DECISIONI nella barra a sinistra.

Nella schermata Offerte, seleziona Sfoglia per visualizzare l'elenco delle offerte.

Seleziona Crea offerta.

Nella finestra di dialogo Nuova offerta, seleziona Offerta personalizzata e fai clic su Successiva.

Nel passaggio Dettagli di Crea una nuova offerta personalizzata:

1. Immetti un Nome per l'offerta, ad esempio Luma - Juno Jacket, e una Data e ora di inizio e una Data e ora di fine. Al di fuori di queste date, l’offerta non verrà selezionata dal motore delle decisioni.

2. Seleziona Avanti.

   

Nel passaggio Aggiungi rappresentazioni di Crea una nuova offerta personalizzata:

1. Seleziona Mobile dall'elenco Channel e seleziona Mobile JSON dall'elenco Placement.

2. Seleziona Personalizzato per Contenuto.

3. Seleziona Aggiungi contenuto. Nella finestra Aggiungi personalizzazione:

   1. Se è disponibile un selettore Mode, assicurati che sia impostato su JSON.

   2. Immetti il seguente JSON:

      code language-json

      { "title": "Juno Jacket", "text": "On colder-than-comfortable mornings, you'll love warming up in the Juno All-Ways Performance Jacket, designed to compete with wind and chill. Built-in Cocona™ technology aids evaporation, while a special zip placket and stand-up collar keep your neck protected.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj06-purple_main.jpg" }

   3. Seleziona Salva.

      

4. Seleziona Avanti.

   

Nel passaggio Aggiungi vincoli di Crea una nuova offerta personalizzata:

1. Imposta Priorità su 10.

2. Disattiva Includi limite.

3. Seleziona Avanti.

   

Nel passaggio Rivedi di Crea nuova offerta personalizzata:

1. Rivedi l'offerta, quindi seleziona Fine.
2. Nella finestra di dialogo Salva offerta, seleziona Salva e approva.

Ripeti i passaggi da 3 a 8 per creare altre quattro offerte con nomi e contenuti diversi. Tutti gli altri valori di configurazione, ad esempio Data e ora di inizio o Priorità, sono simili alla prima offerta creata. Puoi creare rapidamente offerte duplicate e modificarle.

1. Nell'interfaccia utente di Journey Optimizer, seleziona Offerte dalla barra a sinistra, quindi seleziona Offerte dalla barra superiore.

2. Seleziona la riga dell’offerta creata.

3. Nel riquadro di destra, selezionare Altre azioni e dal menu di scelta rapida selezionare Duplica.

   Utilizza la tabella seguente per definire le altre quattro offerte.

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed
   Offer name (Nome offerta)	Contenuto dell’offerta in JSON
   Luma - Afferma bottiglia d’acqua	{ "title": "Affirm Water Bottle", "text": "You'll stay hydrated with ease with the Affirm Water Bottle by your side or in hand. Measurements on the outside help you keep track of how much you're drinking, while the screw-top lid prevents spills. A metal carabiner clip allows you to attach it to the outside of a backpack or bag for easy access.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/fitness-equipment/ug06-lb-0.jpg" }
   Luma - Desiree Fitness Tee	{ "title": "Desiree Fitness Tee", "text": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/tees/ws05-yellow_main.jpg" }
   Luma - Giubbotto Adrienne Trek	{ "title": "Adrienne Trek Jacket", "text": "You're ready for a cross-country jog or a coffee on the patio in the Adrienne Trek Jacket. Its style is unique with stand collar and drawstrings, and it fits like a jacket should.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj08-gray_main.jpg" }
   Luma - Aero Daily Fitness Tee	{ "title": "Aero Daily Fitness Tee", "text": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology beneath its unassuming look.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/men/tops/tees/ms01-black_main.jpg" }

Come passaggio finale, devi creare un’offerta di fallback, ovvero un’offerta inviata ai clienti che non sono idonei per altre offerte.

1. Seleziona Crea offerta.

2. Nella finestra di dialogo Nuova offerta, seleziona Offerta personalizzata e Successiva.

3. Nel passaggio Dettagli di Crea nuova offerta di fallback, immetti un Nome per l'offerta, ad esempio Luma - Fallback Offer, e seleziona Successivo.

4. Nel passaggio Aggiungi rappresentazioni di Crea nuova offerta di fallback:

   1. Seleziona Mobile dall'elenco Channel e seleziona Mobile JSON dall'elenco Placement.

   2. Seleziona Personalizzato per Contenuto.

   3. Seleziona Aggiungi contenuto.

   4. Nella finestra di dialogo Aggiungi personalizzazione, immetti il seguente JSON e seleziona Salva:

      code language-json
      { "title": "Luma", "text": "Your store for sports wear and equipment.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png" }

   5. Seleziona Avanti.

Nel passaggio Rivedi di Crea nuova offerta di fallback:

1. Rivedi l'offerta, quindi seleziona Fine.
2. Nella finestra di dialogo Salva offerta, seleziona Salva e approva.

Nell'interfaccia utente di Journey Optimizer, seleziona Offerte dalla barra a sinistra.

Seleziona Raccolte dalla barra superiore.

Selezionare Crea raccolta.

Nella finestra di dialogo Nuova raccolta, immetti un Nome per la raccolta, ad esempio Luma - Mobile App Collection, seleziona Crea raccolta statica e fai clic su Avanti.

In Luma - Mobile App Collection, selezionare le offerte da includere nella raccolta. Per questa esercitazione, scegli le cinque offerte create. È possibile filtrare facilmente l'elenco utilizzando il campo di ricerca, ad esempio digitando Luma.

Seleziona Salva.

Nell'interfaccia utente di Journey Optimizer, seleziona Offerte dalla barra a sinistra.

Seleziona Decisioni dalla barra superiore.

Seleziona Crea decisione.

Nel passaggio Dettagli di Crea una nuova decisione di offerta:

1. Immettere un Nome per la decisione, ad esempio Luma - Mobile App Decision, immettere Data e ora di inizio e Data e ora di fine.
2. Seleziona Avanti.

Nel passaggio Aggiungi ambiti decisionali di Crea una nuova decisione di offerta:

1. Seleziona JSON mobile dall'elenco Posizionamento.

2. Nel riquadro Criteri di valutazione, selezionare Aggiungi.

   1. Nella finestra di dialogo Aggiungi raccolta di offerte, seleziona la raccolta di offerte. Ad esempio, Luma - Mobile App Collection.

   2. Seleziona Aggiungi.

      

3. Assicurati che None sia selezionato per Eligibility e che Offer priority sia selezionato come metodo di classificazione.

4. Seleziona Avanti.

   .

Nel passaggio Aggiungi offerta di fallback di Crea una nuova decisione di offerta:

1. Selezionare l'offerta di fallback, ad esempio Luma - Fallback offer.
2. Seleziona Avanti.

Nel passaggio Riepilogo di Crea una nuova decisione di offerta:

1. Seleziona Fine.
2. Nella finestra di dialogo Salva decisione offerta, seleziona Salva e attiva.
3. Nella scheda Decisioni, visualizzi la tua decisione con stato Live.

Nell'interfaccia utente di Journey Optimizer, seleziona Offerte.

Seleziona Decisioni dalla barra superiore.

Selezionare la decisione, ad esempio Luma - Mobile App Decision.

Nel riquadro Ambiti decisione, selezionare Copia.

Dal menu contestuale, selezionare Ambito decisione.

Utilizza un qualsiasi editor di testo per incollare l’ambito decisionale per un utilizzo successivo. L’ambito della decisione ha il seguente formato JSON.

{
    "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx",
    "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx"
}

In Xcode, accertati che AEP Optimize sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.

Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.

Assicurarsi che AEPOptimize faccia parte dell'elenco delle importazioni.

import AEPOptimize

Assicurarsi che Optimize.self faccia parte dell'array di estensioni che si sta registrando.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Passa a Luma > Luma > Model > Data > decisioni nel Navigator dei progetti Xcode. Aggiorna i valori activityId e placementId con i dettagli dell'ambito di decisione copiati dall'interfaccia di Journey Optimizer.

Passa a Luma > Luma > Utils > MobileSDK nel Navigatore progetti Xcode. Trovare la funzione func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async. Aggiungi il seguente codice:

// set up the XDM dictionary, define decision scope and call update proposition API
Task {
   let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]]
   let identityMap = ["identityMap" : ecid]
   let xdmData = ["xdm" : identityMap]
   let decisionScope = DecisionScope(activityId: activityId, placementId: placementId, itemCount: UInt(itemCount))
   Optimize.clearCachedPropositions()
   Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData)
}

Questa funzione:

• configura un dizionario XDM xdmData contenente l'ECID per identificare il profilo per il quale si devono presentare le offerte.

• definisce decisionScope, un oggetto basato sulla decisione definita nell'interfaccia Journey Optimizer - Gestione decisioni e definito utilizzando l'ambito di decisione copiato da Crea una decisione. L'app Luma utilizza un file di configurazione (decisions.json) che recupera i parametri di ambito in base al seguente formato JSON:

  code language-swift
  "scopes": [ { "name": "name of the scope", "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx", "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx", "itemCount": 2 } ]

  È tuttavia possibile utilizzare qualsiasi tipo di implementazione per assicurarsi che le API di ottimizzazione ottengano i parametri corretti (activityId, placementId e itemCount) per creare un oggetto DecisionScope valido per l'implementazione.
  Per informazioni: gli altri valori chiave nel file decisions.json sono per uso futuro e non rilevanti e sono attualmente utilizzati in questa lezione e come parte dell'esercitazione.

• chiama due API: Optimize.clearCachePropositions e Optimize.updatePropositions. Queste funzioni cancellano tutte le proposte memorizzate nella cache e aggiornano le proposte per questo profilo.

Passa a Luma > Luma > Views > Personalization > EdgeOffersView nel navigatore progetti Xcode. Trovare la funzione func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async ed esaminare il codice di questa funzione. La parte più importante di questa funzione è la chiamata API Optimize.onPropositionsUpdate, che

• recupera le proposte per il profilo corrente in base all’ambito della decisione (definito in Journey Optimizer - Gestione delle decisioni),
• recupera l’offerta dalla proposta,
• decomprime il contenuto dell’offerta in modo che possa essere visualizzato correttamente nell’app; e
• attiva l'azione displayed() sull'offerta che invia nuovamente un evento all'Edge Network informando che l'offerta è visualizzata.

Sempre in EdgeOffersView, aggiungi il seguente codice al modificatore .onFirstAppear. Questo codice assicura che il callback per l’aggiornamento delle offerte venga registrato una sola volta.

// Invoke callback for offer updates
Task {
    await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
}

Sempre in EdgeOffersView, aggiungere il codice seguente al modificatore .task. Questo codice aggiorna le offerte quando la vista viene aggiornata.

// Clear and update offers
await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)

Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Xcode, utilizzando .

Passa alla scheda Personalisation.

Seleziona Edge Personalisation.

Scorri verso l'alto per visualizzare due offerte casuali dalla raccolta definita nella sezione DECISION LUMA - MOBILE APP DECISION.

{width="300"}

Le offerte sono casuali, in quanto hai assegnato a tutte la stessa priorità e la classificazione per la decisione si basa sulla priorità.

Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.

Seleziona Configura nella barra a sinistra e seleziona accanto a Rivedi e simula sotto ADOBE JOURNEY OPTIMIZER DECISIONING.

Seleziona Salva.

Seleziona Rivedi e simula nella barra a sinistra. La configurazione di entrambi gli stream di dati viene convalidata e la configurazione dell’SDK nell’applicazione.

Seleziona Richieste nella barra superiore. Sono visualizzate le Offerte richieste.

Puoi esplorare le schede Simula e Elenco eventi per ulteriori funzionalità, controllando la configurazione di Journey Optimizer Decision Management.