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.
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.
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 enligt beskrivningen här. 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 appyta i AJO.
- Installera och konfigurera taggtillägget för Journey Optimizer.
- Uppdatera appen för att registrera Journey Optimizer-taggtillägget.
- Validera inställningar 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
Lägg till en appyta i datainsamling
-
I gränssnittet för datainsamling väljer du App Surfaces i den vänstra panelen.
-
Välj Create App Surface om du vill skapa en konfiguration.
-
Ange Name som konfiguration, till exempel
Luma App Tutorial
. -
Välj Apple iOS från Mobile Application Configuration.
-
Ange ID för mobilappspaket i fältet App ID (iOS Bundle ID). Exempel:
com.adobe.luma.tutorial.swiftui
. -
Välj Save.
Uppdatera datastream-konfiguration
Uppdatera konfigurationen av Experience Edge för att se till att data som skickas från din mobilapp till Edge Network vidarebefordras till Journey Optimizer.
-
I användargränssnittet för datainsamling väljer du Datastreams och markerar ditt datastream, till exempel Luma Mobile App.
-
Välj för Experience Platform och välj Edit på snabbmenyn.
-
Kontrollera att Adobe Journey Optimizer är markerat på skärmen Datastreams > > Adobe Experience Platform. Mer information finns i Adobe Experience Platform-inställningar.
-
Välj Save om du vill spara dataströmskonfigurationen.
Installera tillägget Journey Optimizer-taggar
För att din app ska fungera med Journey Optimizer måste du uppdatera din taggegenskap.
- Navigera till Tags > Extensions > Catalog.
- Öppna din egenskap, till exempel Luma Mobile App Tutorial.
- Välj Catalog.
- Sök efter tillägget Adobe Journey Optimizer.
- 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 kommer du att se att AJO Push Tracking Experience Event Dataset-datauppsättningen är vald i Event Dataset -listan för Development -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.
-
Kontrollera att AEP Messaging har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.
-
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
-
Se till att
AEPMessaging
ingår i din lista över importer.import AEPMessaging
-
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 ]
Validera inställningar med Assurance
-
Granska avsnittet Installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.
-
Välj Configure i försäkringsgränssnittet.
-
Välj knappen bredvid In-App Messaging.
-
Välj Save.
-
Välj In-App Messaging i den vänstra navigeringen.
-
Klicka på fliken Validation. Bekräfta att inga fel visas.
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 SDK-händelsehubben och kan användas av tillägg. SDK-händelsehubben tillhandahåller den grundläggande datastruktur som är knuten till alla SDK-tillägg för Mobile Platform, med en lista över registrerade tillägg och interna moduler, en lista över registrerade händelseavlyssnare och en delad tillståndsdatabas.
SDK-händelsehubben 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 installeras hanteras till exempel alla förfrågningar och interaktioner med erbjudandemotorn Journey Optimizer - Beslutshantering av händelsehubben.
-
I Journey Optimizer-gränssnittet väljer du Campaigns i den vänstra listen.
-
Välj Create Campaign.
-
På skärmen Create Campaign:
-
Välj In-app message och välj en appyta i listan App surface, till exempel Luma Mobile App.
-
Välj Create
-
-
På skärmen för Campaign-definitionen, på Properties, anger du ett Name för kampanjen, till exempel
Luma - In-App Messaging Campaign
, och ett Description, till exempelIn-app messaging campaign for Luma app
.
-
Bläddra ned till Action och välj Edit Content.
-
På skärmen In-App Message:
-
Välj Modal som Message Layout.
-
Ange
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
som Media URL. -
Ange en Header, till exempel
Welcome to this Luma In-App Message
, och ange en Body, till exempelTriggered by pushing that button in the app...
. -
Ange Dismiss som Button #1 text (primary).
-
Observera hur förhandsgranskningen uppdateras.
-
Välj Review to activate.
-
-
På skärmen Review to activate (Luma - In-App Messaging Campaign) väljer du i rutan Schedule.
för granskning av schema -
Gå tillbaka till skärmen Luma - In-App Messaging Campaign och välj Edit triggers.
-
I dialogrutan In-app message trigger konfigurerar du information om spårningsåtgärden som utlöser meddelandet i appen:
-
Om du vill ta bort Application launch event väljer du .
-
Använd Add condition upprepade gånger för att skapa följande logik för Show message if.
-
Klicka på Done.
Du har definierat en spårningsåtgärd där Action är lika med
in-app
och Context data med åtgärden är ett nyckelvärdepar på"showMessage" : "true"
. -
-
Välj Review to activate på skärmen Luma - In-App Messaging Campaign.
-
Välj Activate på skärmen Review to activate (Luma - In-App Messaging Campaign).
-
Du ser din Luma - In-App Messaging Campaign med status Live i listan Campaigns.
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.
-
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 funktionenMobileCore.track
baserat på parametrarnaaction
ochdata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
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"]) }
Validera med din app
-
Återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med .
-
Gå till fliken Settings.
-
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.
- Granska avsnittet Installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.
- Välj In-App Messaging.
- Välj Event List.
- Välj en Display message-post.
- Inspect Raw-händelsen, särskilt
html
, som innehåller den fullständiga layouten och innehållet i meddelandet i appen.
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.
Nästa: Skapa och visa erbjudanden