In-app berichten maken en verzenden
Leer hoe u in-app berichten voor mobiele apps maakt met Experience Platform Mobile SDK en Journey Optimizer.
Met Journey Optimizer kunt u campagnes maken om in-app berichten naar bepaalde doelgroepen te verzenden. Campagnes in Journey Optimizer worden gebruikt om via verschillende kanalen eenmalige inhoud aan een specifiek publiek te leveren. Met campagnes, worden de acties uitgevoerd gelijktijdig, of onmiddellijk, of gebaseerd op een gespecificeerd programma. Wanneer het gebruiken van reizen (zie Journey Optimizer duw berichtenles), worden de acties uitgevoerd in opeenvolging.
Voordat u in-app berichten verzendt met Journey Optimizer, moet u ervoor zorgen dat de juiste configuraties en integratie aanwezig zijn. Om de in-app overseinenstroom in Journey Optimizer te begrijpen, verwijs naar de documentatie.
Vereisten
- App met SDK's geïnstalleerd en geconfigureerd met succes gemaakt en uitgevoerd.
- Stel de app in voor Adobe Experience Platform.
- De toegang tot Journey Optimizer en voldoende toestemmingen voor dupberichten. U hebt ook voldoende machtigingen nodig voor de volgende Journey Optimizer-functies.
- Campagnes beheren.
- Fysiek iOS-apparaat of simulator voor testen.
Leerdoelstellingen
In deze les zult u
- Maak een kanaalconfiguratie in Journey Optimizer.
- De Journey Optimizer-tagextensie installeren en configureren.
- Werk uw app bij om de Journey Optimizer-tagextensie te registreren.
- Instellingen valideren in Assurance.
- Definieer uw eigen campagne en berichtervaring in de app in Journey Optimizer.
- Verzend uw eigen in-app-bericht vanuit de app.
Instellen
Een kanaalconfiguratie maken
Om te beginnen moet u een kanaalconfiguratie maken om meldingen van App-berichten van Journey Optimizer te kunnen verzenden.
-
Open in de Journey Optimizer-interface het menu Channels > General settings > Channel configurations en selecteer vervolgens Create channel configuration .
-
Voer een naam en beschrijving (optioneel) voor de configuratie in. Bijvoorbeeld
LumaInAppMessaging
enChannel for in-app messaging
.note note NOTE Namen moeten beginnen met een letter (A-Z). Het mag alleen alfanumerieke tekens bevatten. U kunt ook onderstrepingsteken _
-, punt.
- en afbreekstreepjes-
gebruiken. -
Als u aangepaste of basislabels voor gegevensgebruik aan de configuratie wilt toewijzen, kunt u Manage access selecteren. leer meer over de Controle van de Toegang van het Niveau van Objecten (OLAC).
-
Selecteer het In-app overseinen kanaal.
-
Selecteer Marketing action(s) om het toestemmingsbeleid aan de berichten te associëren die deze configuratie gebruiken. Alle toestemmingsbeleid verbonden aan de marketing actie wordt gebruikt om de voorkeur van uw klanten te respecteren. leer meer over marketing acties. Bijvoorbeeld: push-gericht.
-
Selecteer het platform waarvoor u de instellingen wilt definiëren. Met deze instelling kunt u de doelapp voor elk platform opgeven en zorgt u voor consistente levering van inhoud op meerdere platforms.
note note NOTE Voor iOS- en Android-platforms is de levering uitsluitend gebaseerd op de toepassings-id. Als beide toepassingen dezelfde toepassings-id hebben, wordt inhoud geleverd aan beide toepassingen, ongeacht het platform dat is geselecteerd in de Channel configuration . -
Voer de app-id in voor het platform dat u wilt ondersteunen.
-
Selecteer Submit om uw wijzigingen op te slaan.
Gegevensstroomconfiguratie bijwerken
Werk de configuratie van Experience Edge bij om ervoor te zorgen dat gegevens die vanuit uw mobiele app naar de Edge Network worden verzonden, naar Journey Optimizer worden doorgestuurd.
-
Selecteer Datastreams in de gebruikersinterface voor gegevensverzameling en selecteer de gegevensstroom, bijvoorbeeld Luma Mobile App .
-
Selecteer
-
In Datastreams >
-
Selecteer Save om de configuratie van de gegevensstroom op te slaan.
Journey Optimizer-extensie installeren
Uw app werkt alleen met Journey Optimizer als u de eigenschap tag bijwerkt.
- Navigeer naar Tags > Extensions > Catalog .
- Open uw eigenschap, bijvoorbeeld Luma Mobile App Tutorial .
- Selecteer Catalog.
- Zoek naar de extensie Adobe Journey Optimizer .
- De extensie installeren.
Wanneer slechts gebruikend in-app berichten in uw app, in Install Extension of Configure Extension, te hoeven u om het even wat te vormen. Als u reeds de Push berichtenles in het leerprogramma hebt gevolgd, ziet u dat voor het Development milieu, de AJO Push Tracking Experience Event Dataset dataset van de Event Dataset lijst wordt geselecteerd.
Journey Optimizer implementeren in de app
Zoals in vorige lessen is besproken, biedt het installeren van een extensie voor mobiele tags alleen de configuratie. Vervolgens moet u de Messaging SDK installeren en registreren. Als deze stappen niet duidelijk zijn, herzie installeer SDKssectie.
-
In Xcode, zorg ervoor dat het Overseinen van AEPaan de lijst van pakketten in de Afhankelijkheden van het Pakket wordt toegevoegd. Zie {de Manager van het Pakket van 0} Swift .
-
Navigeer naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.
-
Controleer of
AEPMessaging
deel uitmaakt van uw lijst met importbewerkingen.import AEPMessaging
-
Controleer of
Messaging.self
deel uitmaakt van de array met extensies die u registreert.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 ]
-
In de Studio van Android, zorg ervoor dat aepsdk-overseinen-androiddeel van de gebiedsdelen in build.gradle.kts in Android
-
Navigeer aan Android
-
Controleer of
com.adobe.marketing.mobile.Messaging
deel uitmaakt van uw lijst met importbewerkingen.import import com.adobe.marketing.mobile.Messaging
-
Controleer of
Messaging.EXTENSION
deel uitmaakt van de array met extensies die u registreert.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 )
Setup valideren met Assurance
-
Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.
-
Selecteer Configure in de gebruikersinterface van Assurance.
-
Selecteer
-
Selecteer Save.
-
Selecteer In-App Messaging in de linkernavigatie.
-
Selecteer het tabblad Validation. Bevestig dat u geen fouten krijgt.
Uw eigen bericht in de app maken
Als u uw eigen bericht in de app wilt maken, moet u een campagne in Journey Optimizer definiëren die een bericht in de app activeert op basis van gebeurtenissen die plaatsvinden. Deze gebeurtenissen kunnen zijn:
- naar Adobe Experience Platform verzonden gegevens;
- kern volgende gebeurtenissen, zoals actie, of staat of inzameling van PII- gegevens, door Mobile Core generische APIs;
- levenscyclusgebeurtenissen van toepassingen, zoals starten, installeren, upgraden, sluiten of vastlopen,
- gebeurtenissen voor geolocatie, zoals het betreden of afsluiten van een interessant punt.
In dit leerprogramma, gaat u de Mobiele Kern generische en uitbreiding-onafhankelijke APIs gebruiken (zie Mobiele Kern generische APIs) om gebeurtenis het volgen van gebruikersschermen, acties, en PII gegevens te vergemakkelijken. Gebeurtenissen die door deze API's worden gegenereerd, worden gepubliceerd naar de SDK-gebeurtenishub en zijn beschikbaar voor gebruik door extensies. De SDK-gebeurtenishub biedt de basisgegevensstructuur die is gekoppeld aan alle SDK-extensies voor mobiele platforms. De gebeurtenishub onderhoudt een lijst van geregistreerde uitbreidingen en interne modules, een lijst van geregistreerde gebeurtenisluisteraars, en een gedeeld staatsgegevensbestand.
De SDK-gebeurtenishub publiceert en ontvangt gebeurtenisgegevens van geregistreerde extensies om de integratie met Adobe en oplossingen van derden te vereenvoudigen. Wanneer bijvoorbeeld de extensie Optimize is geïnstalleerd, verwerkt de gebeurtenishub alle verzoeken en interacties met de aanbiedingsengine Journey Optimizer - Decision Management.
-
Selecteer in de gebruikersinterface van Journey Optimizer de optie Campaigns in het linkerspoor.
-
Selecteer Create Campaign.
-
In de Create your campaign dialoog, uitgezochte
-
In het Campaign - YYYY-MM-DD HH SS UTC+XX:XX scherm:
-
Op het tabblad Properties :
- Voer bijvoorbeeld een naam in voor de campagne
Luma Mobile In-App Campaign
. - Voeg desgewenst een beschrijving toe.
- Voer bijvoorbeeld een naam in voor de campagne
-
Selecteer het tabblad Action.
-
Onder Show message if, uitgezocht
-
Selecteer uw configuratie in het vervolgkeuzemenu In-app message configuration . Bijvoorbeeld LumaInAppMessaging .
-
Selecteer
-
In het dialoogvenster In-app message trigger :
-
Selecteer Application launch en selecteer Track action in het vervolgkeuzemenu.
-
Selecteer
-
Selecteer Action en equals in de vervolgkeuzemenu's.
-
Voer
in-app
in. -
Selecteer
-
Selecteer Context data in de vervolgkeuzelijst en voer
showMessage
in. -
Selecteer equals in de vervolgkeuzelijst en voer
true
in. -
Selecteer Done.
-
-
-
Selecteer de tab Content in het scherm met de hoofddefinitie van de campagne.
-
Schakel Advanced formatting in.
-
Selecteer Modal als de Messaging layout . Selecteer Switch layout in het dialoogvenster Change layout .
-
Op het tabblad Content .
- Voer
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
in voor de Media URL . - Voer bijvoorbeeld een Header
Welcome to this Luma In-App Message
in en voer een Body in, bijvoorbeeldTriggered by pushing that button in the app...
.
- Voer
-
Selecteer Settings tab.
- Selecteer Customize size in Message .
- Schakel Fit to content uit.
- Stel Height in op 75% .
-
-
-
Selecteer Review to activate. Om naar keuze om het even welke configuraties voor Content uit te geven, Properties, Actions, of meer, uitgezocht
-
In het Review to activate (*campagnenaam *) scherm, selecteer Activate.
-
Na een tijdje, ziet u uw campagnenaam met status Live in de Campaigns lijst.
Het bericht in de app activeren
U beschikt over alle ingrediënten om een bericht in de app te verzenden. Dit bericht in de app blijft in de app geactiveerd.
-
Ga naar Luma > Luma > Utils > MobileSDK in de Xcode-projectnavigator. Vind de
func sendTrackAction(action: String, data: [String: Any]?)
functie, en voeg de volgende code toe, die deMobileCore.track
functie, die op de parametersaction
endata
wordt gebaseerd roept.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Ga naar Luma > Luma > Views > General > ConfigView in de Xcode Project Navigator. Zoek de code voor de knoop van het Bericht in-App en voeg de volgende code toe:
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
-
Ga naar Android
fun sendTrackAction(action: String, data: Map<String, String>?)
functie, en voeg de volgende code toe, die deMobileCore.track
functie, die op de parametersaction
endata
wordt gebaseerd roept.code language-kotlin // Send trackAction event MobileCore.track(action, data)
-
Ga naar Android
onInAppMessageClick
handlerknop en voeg de volgende code toe:code language-kotlin // Setting parameters and calling function to send in-app message MobileSDK.shared.sendTrackAction( "in-app", mapOf("showMessage" to "true") )
Valideren met uw app
U kunt de berichten in de app valideren vanuit de app zelf.
-
Rebuild en stel app in werking in de simulator of op een fysiek apparaat van Xcode, gebruikend
-
Ga naar het tabblad Settings.
-
Tik op In-App Message. Het bericht in de app wordt weergegeven in uw app.
-
Rebuild en stel app in werking in de simulator of op een fysiek apparaat van de Studio van Android, gebruikend
-
Ga naar het tabblad Settings.
-
Tik op In-App Message. Het bericht in de app wordt weergegeven in uw app.
Implementatie valideren in Assurance
U kunt uw berichten in de app valideren in de gebruikersinterface van Assurance.
-
Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.
-
Selecteer In-App Messaging.
-
Selecteer Event List.
-
Selecteer een Display message -item.
-
Inspecteer de onbewerkte gebeurtenis, met name de
html
, die de volledige lay-out en inhoud van het bericht in de app bevat.
Volgende stappen
U moet nu over alle gereedschappen beschikken om waar nodig en van toepassing in-app berichten toe te voegen. Zo kunt u bijvoorbeeld producten promoten op basis van specifieke interacties die u in uw app bijhoudt.
Volgende: creeer en vertoningsaanbiedingen