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.

Arkitektur

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.

NOTE
Den här lektionen är valfri och gäller endast för Journey Optimizer-användare som vill använda beslutsstyrningsfunktionen för att visa erbjudanden i en mobilapp.

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

TIP
Om du redan har konfigurerat miljön som en del av Konfigurera A/B-tester med Target kan du redan ha utfört några av stegen i det här inställningsavsnittet.

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.

  1. I gränssnittet för datainsamling väljer du Datastreams och välj till exempel din datastream Luma Mobile App.

  2. Välj Mer for Experience Platform och markera Redigera Redigera på snabbmenyn.

  3. I Datastreams > Mapp > 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.

  4. Om du vill spara din datastream-konfiguration väljer du Spara .

    AEP-konfiguration för datastream

Installera Journey Optimizer - Decisioning-taggtillägg

  1. Navigera till Taggar och hitta din mobila taggegenskap och öppna egenskapen.

  2. Välj Tillägg.

  3. Välj Katalog.

  4. Sök efter Adobe Journey Optimizer - beslut tillägg.

  5. Installera tillägget. Tillägget kräver ingen ytterligare konfiguration.

    Lägg till beslutstillägg

Uppdatera ditt schema

  1. Navigera till gränssnittet Datainsamling och välj Scheman från den vänstra listen.
  2. Välj Bläddra i det övre fältet.
  3. Välj ditt schema för att öppna det.
  4. Välj Lägg till Lägg till bredvid Fältgrupper.
  5. I Lägg till fältgrupper dialog, Sök 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.
    Föreslå
  6. 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:

  1. Gå till försäkringsgränssnittet.
  2. Välj Konfigurera i vänster rand och välj Lägg till nästa Validera inställningar under ADOBE JOURNEY OPTIMIZER AVGÖRANDE.
  3. Välj Spara.
  4. Välj Validera inställningar till vänster. Både datastream-konfigurationen och SDK-konfigurationen i ditt program valideras.
    Validering av AJO-beslut

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:

  1. I användargränssnittet för Journey Optimizer väljer du Komponenter Komponenter från BESLUTSHANTERING till vänster.

  2. Välj Placeringar i det övre fältet.

  3. 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:

  1. Välj Lägg till Skapa placering.

    1. i Information sektion, ange Mobile JSON som Namn, markera Mobil från Kanaltyp och JSON från Innehållstyp.
    2. Välj Spara för att spara placeringen.

    Skapa placering

Skapa erbjudanden

  1. I användargränssnittet för Journey Optimizer väljer du Erbjudanden Erbjudanden från BESLUTSHANTERING till vänster.

  2. I Erbjudanden skärm, välja Bläddra för att se en lista över erbjudanden.

  3. Välj Skapa erbjudande.

  4. I Nytt erbjudande dialogruta, välja Personligt erbjudande och klicka Nästa.

  5. I Information steg för Skapa nytt personaliserat erbjudande:

    1. Ange en Namn för erbjudandet, till exempel Luma - Juno Jacketoch ange Startdatum och -tid och Slutdatum och sluttid. Utanför dessa datum väljs inte erbjudandet av beslutsmotorn.

    2. Välj Nästa.

      Erbjudanden - information

  6. I Lägg till representationer steg för Skapa nytt personaliserat erbjudande:

    1. Välj Mobil Mobil från Kanal lista och markera Mobile JSON från Placement lista.

    2. Välj Egen for Innehåll.

    3. Välj Lägg till innehåll. I Lägg till personalisering dialog:

      1. Om Läge väljaren är tillgänglig, kontrollera att den är inställd på JSON.

      2. 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"
        }
        
      3. Välj Spara.

        Erbjudanden - anpassat innehåll

    4. Välj Nästa.

      Erbjudanderepresentationer

  7. I Lägg till begränsningar steg i Skapa nytt personaliserat erbjudande:

    1. Ange Prioritet till 10.

    2. Växla Inkludera fäste av.

    3. Välj Nästa.

      Erbjudanden - begränsningar

  8. I Granska steg för Skapa nya personaliserade erbjudande:

    1. Granska erbjudandet och välj Slutför.
    2. I Spara erbjudande dialogruta, välja Spara och godkänn.
  9. 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.

    1. I Journey Optimizer UI väljer du Erbjudanden Erbjudanden Välj Erbjudanden i det övre fältet i den vänstra listen.

    2. Markera raden i erbjudandet som du skapade.

    3. I den högra rutan väljer du Mer Fler åtgärder och på snabbmenyn väljer Duplicera 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" }
  10. 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.

    1. Välj Skapa erbjudande.

    2. I Nytt erbjudande dialogruta, välja Personligt erbjudande och markera Nästa.

    3. I Information steg för Skapa nytt reserverbjudande, ange Namn för erbjudandet, till exempel Luma - Fallback Offeroch markera Nästa.

    4. I Lägg till representationer steg för Skapa nytt reserverbjudande:

      1. Välj Mobil Mobil från Kanal lista och markera Mobile JSON från Placement lista.

      2. Välj Egen for Innehåll.

      3. Välj Lägg till innehåll.

      4. 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"
        }
        
      5. Välj Nästa.

  11. I Granska steg för Skapa nytt reserv erbjudande:

    1. Granska erbjudandet och välj Slutför.
    2. I Spara erbjudande dialogruta, välja Spara och godkänn.

Du bör nu ha följande lista över erbjudanden:
Erbjudandelista

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.

  1. I användargränssnittet för Journey Optimizer väljer du Erbjudanden från den vänstra listen.

  2. Välj Samlingar i det övre fältet.

  3. Välj Lägg till Skapa samling.

  4. I Ny samling dialogruta, ange Namn för din samling, till exempel Luma - Mobile App Collection, markera Skapa statisk samling och klicka Nästa.

  5. 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.

  6. Välj Spara.

    Erbjudanden - samling

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.

  1. I användargränssnittet för Journey Optimizer väljer du Erbjudanden från den vänstra listen.

  2. Välj Beslut i det övre fältet.

  3. Välj Lägg till Skapa beslut.

  4. I Information steg för Skapa ett nytt offertbeslut:

    1. Ange en Namn för beslutet, till exempel Luma - Mobile App Decision, ange Startdatum och -tid och Slutdatum och sluttid.
    2. Välj Nästa.
  5. I Lägg till beslutsomfattningar steg för Skapa ett nytt offertbeslut:

    1. Välj Mobile JSON från Placement lista.

    2. I Utvärderingskriterier platta, markera Lägg till Lägg till.

      1. I Lägg till erbjudandesamling väljer du din erbjudandesamling. Till exempel: Luma - Mobile App Collection.

      2. Välj Lägg till.

        Beslut - Välj samling

    3. Se till att Ingen är markerat för Kvalificering och Prioritet är markerat som Rankningsmetod.

    4. Välj Nästa.

      Beslutsomfattningar .

  6. I Lägg till reserverbjudande steg för Skapa ett nytt offertbeslut:

    1. Välj ditt reserverbjudande, till exempel Luma - Fallback offer.
    2. Välj Nästa.
  7. I Sammanfattning steg för Skapa ett nytt offertbeslut:

    1. Välj Slutför.
    2. I Spara offertbeslut dialogruta, välja Spara och aktivera.
    3. 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.

  1. I användargränssnittet för Journey Optimizer väljer du Erbjudanden.

  2. Välj Beslut i det övre fältet.

  3. Välj t.ex. ditt beslut Luma - Mobile App Decision.

  4. I Beslutsomfattningar platta, markera Kopiera Kopiera.

  5. Välj Beslutets omfattning.
    Kopiera beslutsomfattning

  6. 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.

NOTE
Om du har slutfört Installera SDK:er är SDK redan installerat och du kan hoppa över det här steget.
  1. I Xcode kontrollerar du att AEP-optimering läggs till i listan över paket i paketberoenden. Se Swift Package Manager.

  2. Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

  3. Säkerställ AEPOptimize är en del av din lista över importer.

    code language-swift
    import AEPOptimize
    
  4. 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
    ]
    
  5. Navigera till Luma > Luma > Model > Data > beslut i Xcode Project-navigatorn. Uppdatera activityId och placementId värden med beslutsinformation som du kopierat från Journey Optimizer gränssnitt.

  6. 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 och itemCount), för att skapa en giltig DecisionScope -objekt för implementeringen.
      För din information: övriga nyckelvärden i decisions.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 och Optimize.updatePropositions. Dessa funktioner rensar alla cachelagrade offerter och uppdaterar propositionerna för den här profilen.

  7. 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 är Optimize.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.
  8. 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)
    }
    
  9. 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

  1. Återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med Spela upp .

  2. Gå till Personalisation -fliken.

  3. Välj Edge Personalisation.

  4. 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:

  1. Granska installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.

  2. Välj Konfigurera i vänster rand och välj Lägg till nästa Granska och simulera under ADOBE JOURNEY OPTIMIZER AVGÖRANDE.

  3. Välj Spara.

  4. Välj Granska och simulera till vänster. Både datastream-konfigurationen valideras och SDK-inställningen i ditt program.

  5. Välj Begäranden i det övre fältet. Du ser Erbjudanden förfrågningar.
    Validering av AJO-beslut

  6. 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.
SUCCESS
Du har aktiverat appen för att visa erbjudanden med tillägget Journey Optimizer - Decisioning för Experience Platform Mobile SDK.
Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem om detta Experience League diskussionsinlägg.

Nästa: Utför A/B-tester

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b