Skapa och visa erbjudanden med Beslutshantering
Lär dig hur du visar erbjudanden från Journey Optimizer Decision Management i dina mobilappar med Experience Platform Mobile SDK.
Med Journey Optimizer Decision Management kan ni leverera det bästa erbjudandet och upplevelsen till era kunder över alla kontaktytor vid rätt tidpunkt. När ni väl utformat er målgrupp kan ni inrikta er på personaliserade erbjudanden.
Beslutshantering förenklar personaliseringen med ett centralt bibliotek med marknadsföringserbjudanden och en beslutsmotor som tillämpar regler och begränsningar på komplexa realtidsprofiler som skapats av Adobe Experience Platform. Resultatet blir att ni kan skicka rätt erbjudande till kunderna vid rätt tidpunkt. Se Om beslutshantering för mer information.
Förutsättningar
- App med SDK:er har installerats och konfigurerats.
- Konfigurera appen för Adobe Experience Platform.
- Tillgång till Journey Optimizer - Beslutshantering med rätt behörighet att hantera erbjudanden och beslut enligt beskrivningen här.
Utbildningsmål
I den här lektionen ska du
- Uppdatera Edge-konfigurationen för beslutshantering.
- Uppdatera taggegenskapen med tillägget Journey Optimizer - Decisioning.
- Uppdatera ditt schema för att hämta offerthändelser.
- Validera inställningar i Assurance.
- Skapa ett offertbeslut baserat på erbjudanden från Journey Optimizer - Beslutshantering.
- Uppdatera appen och registrera tillägget Optimizer.
- Implementera erbjudanden från Beslutshantering i appen.
Inställningar
Uppdatera datastream-konfiguration
För att säkerställa att data som skickas från din mobilapp till Platform Edge Network vidarebefordras till Journey Optimizer - Beslutshantering måste du uppdatera din datastream.
-
I gränssnittet för datainsamling väljer du Datastreams och välj till exempel din datastream Luma Mobile App.
-
Välj for Experience Platform och markera Redigera på snabbmenyn.
-
I Datastreams > > Adobe Experience Platform skärm, se Offer decisioning, Kantsegmentering och Adobe Journey Optimizer är markerade. Om du ska göra mållektionen väljer du Destinationer för anpassning, också. Se Adobe Experience Platform-inställningar för mer information.
-
Om du vill spara din datastream-konfiguration väljer du Spara .
Installera Journey Optimizer - Decisioning-taggtillägg
-
Navigera till Taggar och hitta din mobila taggegenskap och öppna egenskapen.
-
Välj Tillägg.
-
Välj Katalog.
-
Sök efter Adobe Journey Optimizer - beslut tillägg.
-
Installera tillägget. Tillägget kräver ingen ytterligare konfiguration.
Uppdatera ditt schema
- Navigera till gränssnittet Datainsamling och välj Scheman från den vänstra listen.
- Välj Bläddra i det övre fältet.
- Välj ditt schema för att öppna det.
- Välj Lägg till bredvid Fältgrupper.
- I Lägg till fältgrupper dialog,
sök efter
proposition
, markera Experience Event - Proposition Interactions och markera Lägg till fältgrupper. Den här fältgruppen samlar in data om upplevelsehändelser som är relevanta för erbjudanden: vilket erbjudande som presenteras, som en del av vilken samling, vilket beslut och andra parametrar (se senare i den här lektionen). Men vad händer med erbjudandet? Visas den, interagerar med den, stängs av och så vidare.
- Välj Spara för att spara ändringarna i ditt schema.
Validera inställningar i Assurance
Så här validerar du inställningarna i Assurance:
- Gå till försäkringsgränssnittet.
- Välj Konfigurera i vänster rand och välj nästa Validera inställningar under ADOBE JOURNEY OPTIMIZER AVGÖRANDE.
- Välj Spara.
- Välj Validera inställningar till vänster. Både datastream-konfigurationen och SDK-konfigurationen i ditt program valideras.
Skapa placering
Innan ni kan skapa erbjudanden måste ni definiera hur och var dessa erbjudanden kan placeras i mobilappen. I Beslutshantering definierar du placeringar för detta ändamål och du definierar en placering för den mobila kanal som stöder en JSON-nyttolast:
-
I användargränssnittet för Journey Optimizer väljer du Komponenter från BESLUTSHANTERING till vänster.
-
Välj Placeringar i det övre fältet.
-
Om det inte finns någon placering med namnet Mobile JSON, Mobil as Kanaltyp och JSON as Innehållstyp måste du skapa en placering. Annars fortsätter du Skapa erbjudanden.
Så här skapar du Mobile JSON-placeringen:
-
Välj Skapa placering.
- i Information sektion, ange
Mobile JSON
som Namn, markera Mobil från Kanaltyp och JSON från Innehållstyp. - Välj Spara för att spara placeringen.
- i Information sektion, ange
Skapa erbjudanden
-
I användargränssnittet för Journey Optimizer väljer du Erbjudanden från BESLUTSHANTERING till vänster.
-
I Erbjudanden skärm, välja Bläddra för att se en lista över erbjudanden.
-
Välj Skapa erbjudande.
-
I Nytt erbjudande dialogruta, välja Personligt erbjudande och klicka Nästa.
-
I Information steg för Skapa nytt personaliserat erbjudande:
-
Ange en Namn för erbjudandet, till exempel
Luma - Juno Jacket
och ange Startdatum och -tid och Slutdatum och sluttid. Utanför dessa datum väljs inte erbjudandet av beslutsmotorn. -
Välj Nästa.
-
-
I Lägg till representationer steg för Skapa nytt personaliserat erbjudande:
-
Välj Mobil från Kanal lista och markera Mobile JSON från Placement lista.
-
Välj Egen for Innehåll.
-
Välj Lägg till innehåll. I Lägg till personalisering dialog:
-
Om Läge väljaren är tillgänglig, kontrollera att den är inställd på JSON.
-
Ange följande 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" }
-
Välj Spara.
-
-
Välj Nästa.
-
-
I Lägg till begränsningar steg i Skapa nytt personaliserat erbjudande:
-
Ange Prioritet till
10
. -
Växla Inkludera fäste av.
-
Välj Nästa.
-
-
I Granska steg för Skapa nya personaliserade erbjudande:
- Granska erbjudandet och välj Slutför.
- I Spara erbjudande dialogruta, välja Spara och godkänn.
-
Upprepa steg 3-8 för att skapa ytterligare fyra erbjudanden med olika namn och innehåll. Alla andra konfigurationsvärden, till exempel Startdatum och -tid eller Prioritet, liknar det första erbjudandet du skapade. Du kan snabbt skapa dubbletter och redigera erbjudanden.
-
I Journey Optimizer UI väljer du Erbjudanden Välj Erbjudanden i det övre fältet i den vänstra listen.
-
Markera raden i erbjudandet som du skapade.
-
I den högra rutan väljer du Fler åtgärder och på snabbmenyn väljer Duplicera.
Använd tabellen nedan för att definiera de fyra andra erbjudandena.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed Namn på erbjudande Erbjud innehåll i JSON Luma - vattenflaskan har fastnat { "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 - Önskat träningsträd { "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 - Adrienne Trek Jacket { "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" }
-
-
Som sista steg måste ni skapa ett reserverbjudande, som är ett erbjudande som skickas till kunderna om de inte är berättigade till andra erbjudanden.
-
Välj Skapa erbjudande.
-
I Nytt erbjudande dialogruta, välja Personligt erbjudande och markera Nästa.
-
I Information steg för Skapa nytt reserverbjudande, ange Namn för erbjudandet, till exempel
Luma - Fallback Offer
och markera Nästa. -
I Lägg till representationer steg för Skapa nytt reserverbjudande:
-
Välj Mobil från Kanal lista och markera Mobile JSON från Placement lista.
-
Välj Egen for Innehåll.
-
Välj Lägg till innehåll.
-
I Lägg till personalisering anger du följande JSON och väljer Spara:
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" }
-
Välj Nästa.
-
-
-
I Granska steg för Skapa nytt reserv erbjudande:
- Granska erbjudandet och välj Slutför.
- I Spara erbjudande dialogruta, välja Spara och godkänn.
Du bör nu ha följande lista över erbjudanden:
Skapa en samling
För att kunna presentera ett erbjudande för din mobilappsanvändare måste du definiera en erbjudandesamling som består av ett eller flera av de erbjudanden du har skapat.
-
I användargränssnittet för Journey Optimizer väljer du Erbjudanden från den vänstra listen.
-
Välj Samlingar i det övre fältet.
-
Välj Skapa samling.
-
I Ny samling dialogruta, ange Namn för din samling, till exempel
Luma - Mobile App Collection
, markera Skapa statisk samling och klicka Nästa. -
I Luma - Mobile App Collection markerar du de erbjudanden du vill inkludera i samlingen. I den här självstudiekursen väljer du fem erbjudanden du skapat. Du kan enkelt filtrera listan med hjälp av sökfältet, till exempel genom att skriva Luma.
-
Välj Spara.
Skapa ett beslut
Det sista steget är att definiera ett beslut, vilket är kombinationen av ett eller flera beslutsomfattningar och ditt reserverbjudande.
Ett beslutsomfång är en kombination av en specifik placering (till exempel HTML i ett e-postmeddelande eller JSON i en mobilapp) och ett eller flera utvärderingskriterier.
Ett utvärderingskriterium är en kombination av
- en erbjudandesamling,
- regler för behörighet: Erbjudandet gäller t.ex. endast en viss målgrupp.
- en rangordningsmetod: när det finns flera erbjudanden att välja mellan, vilken metod använder du för att rangordna dem (t.ex. efter erbjudandeprioritet, med en formel eller en AI-modell).
Se Viktiga steg för att skapa och hantera erbjudanden om du bättre vill förstå hur placeringar, regler, rankningar, erbjudanden, representationer, samlingar, beslut och så vidare, interagerar och relaterar till varandra. Den här lektionen handlar endast om att använda beslutsresultatet i stället för att vara flexibel när det gäller att definiera beslut inom Journey Optimizer - Beslutshantering.
-
I användargränssnittet för Journey Optimizer väljer du Erbjudanden från den vänstra listen.
-
Välj Beslut i det övre fältet.
-
Välj Skapa beslut.
-
I Information steg för Skapa ett nytt offertbeslut:
- Ange en Namn för beslutet, till exempel
Luma - Mobile App Decision
, ange Startdatum och -tid och Slutdatum och sluttid. - Välj Nästa.
- Ange en Namn för beslutet, till exempel
-
I Lägg till beslutsomfattningar steg för Skapa ett nytt offertbeslut:
-
Välj Mobile JSON från Placement lista.
-
I Utvärderingskriterier platta, markera Lägg till.
-
I Lägg till erbjudandesamling väljer du din erbjudandesamling. Till exempel: Luma - Mobile App Collection.
-
Välj Lägg till.
-
-
Se till att Ingen är markerat för Kvalificering och Prioritet är markerat som Rankningsmetod.
-
Välj Nästa.
.
-
-
I Lägg till reserverbjudande steg för Skapa ett nytt offertbeslut:
- Välj ditt reserverbjudande, till exempel Luma - Fallback offer.
- Välj Nästa.
-
I Sammanfattning steg för Skapa ett nytt offertbeslut:
- Välj Slutför.
- I Spara offertbeslut dialogruta, välja Spara och aktivera.
- I Beslut kan du se ditt beslut med status Live.
Ditt beslut om erbjudandet, som består av en uppsättning erbjudanden, är nu klart att användas. Om du vill använda beslutet i din app måste du i koden hänvisa till beslutsomfånget.
-
I användargränssnittet för Journey Optimizer väljer du Erbjudanden.
-
Välj Beslut i det övre fältet.
-
Välj t.ex. ditt beslut Luma - Mobile App Decision.
-
I Beslutsomfattningar platta, markera Kopiera.
-
Välj Beslutets omfattning.
-
Använd en textredigerare för att klistra in beslutsomfånget för senare bruk. Beslutsomfånget har följande JSON-format.
code language-json { "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx", "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx" }
Implementera erbjudanden i din app
Som tidigare nämnts tillhandahåller installation av ett mobiltaggtillägg bara konfigurationen. Därefter måste du installera och registrera Optimera SDK. Om de här stegen inte är tydliga går du igenom Installera SDK:er -avsnitt.
-
I Xcode kontrollerar du att AEP-optimering läggs till i listan över paket i paketberoenden. Se Swift Package Manager.
-
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
-
Säkerställ
AEPOptimize
är en del av din lista över importer.code language-swift import AEPOptimize
-
Säkerställ
Optimize.self
är en del av den array med tillägg som du registrerar.code language-swift 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 ]
-
Navigera till Luma > Luma > Model > Data > beslut i Xcode Project-navigatorn. Uppdatera
activityId
ochplacementId
värden med beslutsinformation som du kopierat från Journey Optimizer gränssnitt. -
Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project-navigatorn. Hitta
func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async
funktion. Lägg till följande kod:code language-swift // 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) }
Den här funktionen:
-
ställer in en XDM-ordlista
xdmData
, som innehåller ECID för att identifiera den profil som du måste presentera erbjudandena för. -
definierar
decisionScope
, ett objekt som baseras på det beslut du har definierat i Journey Optimizer - Beslutshantering och som definieras med hjälp av det kopierade beslutsomfånget från Skapa ett beslut. Luma-appen använder en konfigurationsfil (decisions.json
) som hämtar scopeparametrarna, baserat på följande JSON-format:code language-swift "scopes": [ { "name": "name of the scope", "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx", "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx", "itemCount": 2 } ]
Du kan dock använda vilken implementeringsmetod som helst för att se till att API:erna för Optimera får rätt parametrar (
activityId
,placementId
ochitemCount
), för att skapa en giltigDecisionScope
-objekt för implementeringen.
För din information: övriga nyckelvärden idecisions.json
filen är till för framtida bruk och är inte relevant och används för närvarande i den här lektionen och som en del av kursen. -
anropar två API
Optimize.clearCachePropositions
ochOptimize.updatePropositions
. Dessa funktioner rensar alla cachelagrade offerter och uppdaterar propositionerna för den här profilen.
-
-
Navigera till Luma > Luma > Views > Personalisering > EdgeOffersView i Xcode Project-navigatorn. Hitta
func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async
och inspektera koden för den här funktionen. Den viktigaste delen av funktionen ärOptimize.onPropositionsUpdate
API-anrop, som- hämtar förslagen för den aktuella profilen baserat på beslutsomfånget (som du har definierat i Journey Optimizer - Beslutshantering),
- hämtar erbjudandet från erbjudandet,
- frigör innehållet i erbjudandet så att det kan visas korrekt i appen, och
- utlöser
displayed()
åtgärd för erbjudandet som skickar tillbaka en händelse till Edge Network som talar om att erbjudandet visas.
-
Fortfarande i EdgeOffersView lägger du till följande kod i
.onFirstAppear
modifierare. Den här koden ser till att callback-funktionen för uppdatering av erbjudanden registreras endast en gång.code language-swift // Invoke callback for offer updates Task { await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount) }
-
Fortfarande i EdgeOffersView lägger du till följande kod i
.task
modifierare. Den här koden uppdaterar erbjudandena när vyn uppdateras.code language-swift // Clear and update offers await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
Validera med appen
-
Återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med .
-
Gå till Personalisation -fliken.
-
Välj Edge Personalisation.
-
Bläddra högst upp så visas två slumpmässiga erbjudanden från samlingen som du har definierat i DECISION LUMA - MOBILE APP DECISION platta.
{width="300"}
Anbuden är slumpmässiga eftersom ni har gett alla erbjudanden samma prioritet och rangordningen för beslutet baseras på prioritet.
Validera implementering i Assurance
Så här validerar du erbjudandeimplementeringen i Assurance:
-
Granska installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.
-
Välj Konfigurera i vänster rand och välj nästa Granska och simulera under ADOBE JOURNEY OPTIMIZER AVGÖRANDE.
-
Välj Spara.
-
Välj Granska och simulera till vänster. Både datastream-konfigurationen valideras och SDK-inställningen i ditt program.
-
Välj Begäranden i det övre fältet. Du ser Erbjudanden förfrågningar.
-
Du kan utforska Simulera och Händelselista om du vill ha mer funktionalitet kan du kontrollera hur du har konfigurerat Journey Optimizer Decision Management.
Nästa steg
Nu bör du ha alla verktyg du behöver för att börja lägga till fler funktioner i implementeringen av Journey Optimizer - Beslutshantering. Exempel:
- tillämpa olika parametrar för erbjudandena (till exempel prioritet, capping)
- samla profilattribut i appen (se Profil) och använd dessa profilattribut för att bygga målgrupper. Använd sedan dessa målgrupper som en del av reglerna för behörighet i ditt beslut.
- kombinerar mer än ett beslutsområde.
Nästa: Utför A/B-tester