Skapa och skicka meddelanden i appen

Lär dig skapa meddelanden i appen för mobilappar med Experience Platform Mobile SDK och Journey Optimizer.

Med Journey Optimizer kan ni skapa kampanjer för att skicka meddelanden i appen till riktade målgrupper. Kampanjer i Journey Optimizer används för att leverera engångsinnehåll till en viss målgrupp via olika kanaler. Med kampanjer utförs åtgärder samtidigt, antingen omedelbart eller baserat på ett angivet schema. När du använder resor (se lektionen Journey Optimizer push-meddelanden) utförs åtgärder i sekvens.

Arkitektur {modal="regular"}

Innan du skickar meddelanden i appen med Journey Optimizer måste du se till att rätt konfigurationer och integreringar finns på plats. Mer information om dataflödet för meddelanden i programmet i Journey Optimizer finns i dokumentationen.

NOTE
Den här lektionen är valfri och gäller endast för Journey Optimizer-användare som vill skicka meddelanden i appen.

Förhandskrav

  • App med SDK:er har installerats och konfigurerats.
  • Konfigurera appen för Adobe Experience Platform.
  • Åtkomst till Journey Optimizer och tillräcklig behörighet för push-meddelanden. Du behöver även tillräcklig behörighet för följande Journey Optimizer-funktioner.
    • Hantera kampanjer.
  • Fysisk iOS-enhet eller simulator för testning.

Utbildningsmål

I den här lektionen ska du

  • Skapa en kanalkonfiguration i Journey Optimizer.
  • Installera och konfigurera taggtillägget för Journey Optimizer.
  • Uppdatera appen för att registrera Journey Optimizer-taggtillägget.
  • Validera konfigurationen i Assurance.
  • Definiera er egen kampanj och upplevelse av meddelanden i appen i Journey Optimizer.
  • Skicka ditt eget meddelande i appen inifrån appen.

Inställningar

TIP
Om du redan har konfigurerat din miljö som en del av Journey Optimizer push messaging -lektionen kanske du redan har utfört några av stegen i det här installationsavsnittet.

Skapa en kanalkonfiguration

Till att börja med måste du skapa en kanalkonfiguration som gör att du kan skicka meddelanden från Journey Optimizer i appmeddelanden.

  1. Öppna menyn Channels > General settings > Channel configurations i Journey Optimizer-gränssnittet och välj sedan Create channel configuration.

  2. Ange ett namn och en beskrivning (valfritt) för konfigurationen. Till exempel LumaInAppMessaging och Channel for in-app messaging.

    note note
    NOTE
    Namn måste börja med en bokstav (A-Z). Det får bara innehålla alfanumeriska tecken. Du kan också använda understreck _, punkt . och bindestreck -.
  3. Om du vill tilldela anpassade eller grundläggande dataanvändningsetiketter till konfigurationen kan du välja Manage access. Läs mer om OLAC (Object Level Access Control).

  4. Välj kanalen Meddelanden i appen.

  5. Välj Marketing action om du vill associera medgivandeprinciper med de meddelanden som använder den här konfigurationen. Alla profiler för samtycke som är kopplade till marknadsföringsåtgärden används för att ta hänsyn till kundernas önskemål. Läs mer om marknadsföringsåtgärder. Till exempel: Push Targeting.

  6. Välj den plattform som du vill definiera inställningarna för. Med den här inställningen kan du ange målappen för varje plattform och säkerställa enhetlig innehållsleverans på flera plattformar.

    note note
    NOTE
    För iOS- och Android-plattformar baseras leveransen enbart på program-ID:t. Om båda apparna har samma program-ID levereras innehåll till båda, oavsett vilken plattform som valts i Channel configuration.
  7. Ange app-id:n för den plattform som du vill ha stöd för.

    Skapa en kanalkonfiguration {modal="regular"}

  8. Välj Submit om du vill spara ändringarna.

Uppdatera datastream-konfiguration

Uppdatera Experience Edge-konfigurationen för att se till att data som skickas från din mobilapp till Edge Network vidarebefordras till Journey Optimizer.

  1. I användargränssnittet för datainsamling väljer du Datastreams och markerar ditt datastream, till exempel Luma Mobile App.

  2. Välj Mer för Experience Platform och välj Redigera Edit på snabbmenyn.

  3. Kontrollera att Datastreams är markerat på skärmen > Mapp Adobe Experience Platform > Adobe Journey Optimizer. Mer information finns i Adobe Experience Platform-inställningar.

  4. Välj Save om du vill spara dataströmskonfigurationen.

    AEP datastream-konfiguration {modal="regular"}

Installera tillägget Journey Optimizer-taggar

För att din app ska fungera med Journey Optimizer måste du uppdatera din taggegenskap.

  1. Navigera till Tags > Extensions > Catalog.
  2. Öppna din egenskap, till exempel Luma Mobile App Tutorial.
  3. Välj Catalog.
  4. Sök efter tillägget Adobe Journey Optimizer.
  5. Installera tillägget.

När endast använder meddelanden i appen i Install Extension eller Configure Extension behöver du inte konfigurera någonting. Om du redan har följt lektionen Push-meddelanden i självstudiekursen ser du att Development-datauppsättningen har valts i listan AJO Push Tracking Experience Event Dataset för Event Dataset -miljön.

Implementera Journey Optimizer i appen

Som tidigare nämnts tillhandahåller installation av ett mobiltaggtillägg bara konfigurationen. Därefter måste du installera och registrera Messaging SDK. Om de här stegen inte är tydliga går du igenom avsnittet Installera SDK.

NOTE
Om du har slutfört avsnittet Installera SDK:er är SDK redan installerat och du kan hoppa över det här steget.
iOS
  1. Kontrollera att AEP Messaging har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.

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

  3. Se till att AEPMessaging ingår i din lista över importer.

    import AEPMessaging

  4. Kontrollera att Messaging.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
    ]
    
Android
  1. I Android Studio kontrollerar du att aepsdk-messaging-android är en del av beroendena i build.gradle.kts i Android ChevronDown > Gradle Scripts. Se Gradle.

  2. Navigera till Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication i projektnavigeraren i Android Studio.

  3. Se till att com.adobe.marketing.mobile.Messaging ingår i din lista över importer.

    import import com.adobe.marketing.mobile.Messaging

  4. Kontrollera att Messaging.EXTENSION är en del av den array med tillägg som du registrerar.

    code language-kotlin
    val extensions = listOf(
        Identity.EXTENSION,
        Lifecycle.EXTENSION,
        Signal.EXTENSION,
        Edge.EXTENSION,
        Consent.EXTENSION,
        UserProfile.EXTENSION,
        Places.EXTENSION,
        Messaging.EXTENSION,
        Optimize.EXTENSION,
        Assurance.EXTENSION
    )
    

Validera installationen med Assurance

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

  2. I Assurance-gränssnittet väljer du Configure.
    konfigurera klicka {modal="regular"}

  3. Välj knappen Plus bredvid In-App Messaging.

  4. Välj Save.
    spara {modal="regular"}

  5. Välj In-App Messaging i den vänstra navigeringen.

  6. Klicka på fliken Validation. Bekräfta att inga fel visas.

    Validering i appen {modal="regular"}

Skapa ett eget meddelande i appen

Om du vill skapa ett eget meddelande i appen måste du definiera en kampanj i Journey Optimizer som utlöser ett meddelande i appen baserat på händelser som inträffar. Dessa händelser kan vara:

  • data som skickas till Adobe Experience Platform,
  • viktiga spårningshändelser, som åtgärd, eller tillstånd eller insamling av PII-data, via de allmänna API:erna för Mobile Core,
  • livscykelhändelser, som start, installation, uppgradering, stängning eller krasch,
  • geopositioneringshändelser, som att ange eller avsluta en intressepunkt.

I den här självstudiekursen ska du använda de generiska och tilläggsoberoende API:erna för Mobile Core (se Generiska API:er för Mobile Core) för att underlätta händelsespårning av användarskärmar, åtgärder och PII-data. Händelser som genereras av dessa API:er publiceras till händelsehubben i SDK och kan användas av tillägg. SDK händelsehubb tillhandahåller den grundläggande datastruktur som är knuten till alla SDK-tillägg för mobilplattformen. Händelsehubben upprätthåller en lista över registrerade tillägg och interna moduler, en lista över registrerade händelseavlyssnare och en delad tillståndsdatabas.

SDK händelsehubb publicerar och tar emot händelsedata från registrerade tillägg för att förenkla integreringen med Adobe och tredjepartslösningar. När tillägget Optimera är installerat hanterar händelsehubben alla förfrågningar och interaktioner med erbjudandemotorn Journey Optimizer - Beslutshantering.

  1. I Journey Optimizer-gränssnittet väljer du Campaigns i den vänstra listen.

  2. Välj Create Campaign.

  3. I dialogrutan Create your campaign väljer du Klocka Scheduled - Marketing och sedan Confirm.

  4. På skärmen Campaign - ÅÅÅ-MM-DD HHSS UTC+XX:XX:

    1. På fliken Properties:

      1. Ange ett namn för kampanjen, till exempel Luma Mobile In-App Campaign.
      2. Du kan också lägga till en beskrivning.
    2. Klicka på fliken Action.

      1. Under Show message if väljer du Lägg till Add action. Välj In-app message i listrutan.

      2. Välj din konfiguration i listrutan In-app message configuration. Exempel: LumaInAppMessaging.

      3. Välj Redigera Edit triggers.

      4. I dialogrutan In-app message trigger:

        1. Välj Application launch och välj Track action i listrutan.

        2. Välj AddCircle Add condition.

        3. Välj Action och equals i listrutorna.

        4. Ange in-app.

        5. Välj AddCircle Add condition.

        6. Välj Context data i listrutan och ange showMessage.

        7. Välj equals i listrutan och ange true.

          Redigera utlösare {modal="regular"}

        8. Välj Done.

    3. Gå tillbaka till huvudskärmen för kampanjdefinition och välj fliken Content.

      1. Aktivera Advanced formatting.

      2. Välj Modal som Messaging layout. Välj Switch layout i dialogrutan Change layout.

      3. På fliken Content.

        1. Ange https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png som Media URL.
        2. Ange en Header, till exempel Welcome to this Luma In-App Message, och ange en Body, till exempel Triggered by pushing that button in the app....

        Meddelandeinnehåll i appen {modal="regular"}

      4. Välj fliken Settings.

        1. Välj Customize size i Message.
        2. Inaktivera Fit to content.
        3. Ange Height till 75%.

        Meddelandeinställningar i appen {modal="regular"}

  5. Välj Review to activate. Om du vill redigera någon av konfigurationerna för Content, Properties, Actions eller mer väljer du Redigera .

  6. Välj **Review to activate (på skärmen kampanjnamn)Activate.

  7. Efter ett tag visas ditt kampanjnamn med status Live i listan Campaigns.
    Kampanjlista {modal="regular"}

Utlös meddelandet i appen

Du har alla ingredienser på plats för att skicka ett meddelande i appen. Det som återstår är hur du utlöser det här meddelandet i appen i din app.

iOS
  1. Gå till Luma > Luma > Utils > MobileSDK i Xcode Project-navigatorn. Hitta funktionen func sendTrackAction(action: String, data: [String: Any]?) och lägg till följande kod som anropar funktionen MobileCore.track baserat på parametrarna action och data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Gå till Luma > Luma > Views > General > ConfigView i Xcode Project Navigator. Sök efter koden för knappen Meddelande i appen och lägg till följande kod:

    code language-swift
    // Setting parameters and calling function to send in-app message
    Task {
        MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"])
    }
    
Android
  1. Gå till Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK i Android Studio-navigatorn. Hitta funktionen fun sendTrackAction(action: String, data: Map<String, String>?) och lägg till följande kod som anropar funktionen MobileCore.track baserat på parametrarna action och data.

    code language-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Gå till Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt i Android Studio-navigatorn. Hitta koden för hanterarknappen onInAppMessageClick och lägg till följande kod:

    code language-kotlin
    // Setting parameters and calling function to send in-app message
    MobileSDK.shared.sendTrackAction(
        "in-app",
        mapOf("showMessage" to "true")
    )
    

Validera med din app

Du kan validera meddelandena i appen inifrån själva appen.

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

  2. Gå till fliken Settings.

  3. Tryck på In-App Message. Meddelandet visas i appen.

    {width="300"}

Android
  1. Återskapa och kör appen i simulatorn eller på en fysisk enhet från Android Studio med Play .

  2. Gå till fliken Settings.

  3. Tryck på In-App Message. Meddelandet visas i appen.

    {width="300"}

Validera implementering i Assurance

Du kan validera dina meddelanden i appen i Assurance-gränssnittet.

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

  2. Välj In-App Messaging.

  3. Välj Event List.

  4. Välj en Display message-post.

  5. Granska raw-händelsen, särskilt html, som innehåller den fullständiga layouten och innehållet i meddelandet i appen.

    Assurance-meddelande i appen {modal="regular"}

Nästa steg

Nu bör du ha alla verktyg du behöver för att börja lägga till meddelanden i appen, där det är relevant och tillämpligt. Du kan till exempel marknadsföra produkter baserat på specifika interaktioner som du spårar i din app.

SUCCESS
Du har aktiverat appen för meddelanden i appen och lagt till en meddelandekampanj i appen med Journey Optimizer och Journey Optimizer-tillägget för Experience Platform Mobile SDK.
Tack för att du har lagt 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 i det här Experience League Community-diskussionsinlägget.

Nästa: Skapa och visa erbjudanden

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