Documentatie Experience Platform Tutorial voor mobiele apps

In-app berichten maken en verzenden

Laatst bijgewerkt: 5 mei 2025

Onderwerpen:

Gemaakt voor:

Beginner
tussenpersoon
Ontwikkelaar

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.

Architectuur

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.

OPMERKING

Deze les is optioneel en is alleen van toepassing op Journey Optimizer-gebruikers die in-app berichten willen verzenden.

Vereisten

App met SDK's geïnstalleerd en geconfigureerd met succes gemaakt en uitgevoerd.
Stel de app in voor Adobe Experience Platform.
Toegang tot Journey Optimizer en voldoende toestemmingen zoals die hierworden beschreven. 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 App Surface in AJO.
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

TIP

Als u opstelling uw milieu reeds als deel van Journey Optimizer duw overseinenles hebt, zou u sommige stappen in deze opstellingssectie reeds kunnen reeds uitgevoerd hebben.

Een kanaalconfiguratie maken in Journey Optimizer

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.

OPMERKING
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 gebruikend deze configuratie. Alle toestemmingsbeleid verbonden aan de marketing actie wordt gebruikt om de voorkeur van uw klanten te respecteren. leer meer over marketing acties.
Selecteer het platform waarvoor u de instellingen wilt definiëren. Op deze manier kunt u de doelapp voor elk platform opgeven en zorgt u voor consistente levering van inhoud op meerdere platforms.

OPMERKING
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 .
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 voor Experience Platform en selecteer Edit van het contextmenu.
In Datastreams > > Adobe Experience Platform scherm, zorg ervoor Adobe Journey Optimizer wordt geselecteerd. Zie {de montages van 0} Adobe Experience Platform 🔗 voor meer informatie.
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. Nochtans, als u reeds de Push berichtenles in het leerprogramma hebt gevolgd, zult u zien 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.

OPMERKING

Als u voltooide installeerde SDKssectie, dan is SDK reeds geïnstalleerd en u kunt deze stap overslaan.

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.

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
]

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 knoop naast In-App Messaging.
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 van het mobiele platform, een lijst met geregistreerde extensies en interne modules, een lijst met geregistreerde gebeurtenislisteners en een database met gedeelde statussen.

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, worden alle verzoeken en interacties met de aanbiedingsengine van Journey Optimizer - Decision Management afgehandeld door de gebeurtenishub.

Selecteer in de gebruikersinterface van Journey Optimizer de optie Campaigns in het linkerspoor.
Selecteer Create Campaign.
In het Create Campaign -scherm:
1. Selecteer In-app message en selecteer bijvoorbeeld een toepassingsoppervlak in de lijst App surface Luma Mobile App .
2. Selecteren Create
Voer in het definitiescherm Campagne op Properties een Name voor de campagne in, bijvoorbeeld Luma - In-App Messaging Campaign , en een Description , bijvoorbeeld In-app messaging campaign for Luma app .
Schuif omlaag naar Action en selecteer Edit Content .
In het In-App Message -scherm:
1. Selecteer Modal als de Message Layout .
2. Voer https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png in voor de Media URL .
3. Voer bijvoorbeeld een Header Welcome to this Luma In-App Message in en voer een Body in, bijvoorbeeld Triggered by pushing that button in the app... .
4. Voer Dismiss in als de Button #1 text (primary) .
5. De voorvertoning wordt bijgewerkt.
6. Selecteer Review to activate.
In het Review to activate (Luma - In-App Messaging Campaign) scherm, uitgezocht in de Schedule tegel uit.
Terug in het Luma - In-App Messaging Campaign scherm, uitgezocht Edit triggers uit.
In het dialoogvenster In-app message trigger configureert u de details van de handeling track waarmee het bericht in de app wordt geactiveerd:
1. Om Application launch event te verwijderen, selecteer .
2. Het gebruik toe Add condition herhaaldelijk om de volgende logica voor Show message if te bouwen.
3. Klik op Done.
U hebt een handeling track gedefinieerd, waarbij de waarde Action gelijk is aan in-app en de waarde Context data aan de handeling een sleutelwaardepaar is van "showMessage" : "true" .
Selecteer Review to activate weer in het Luma - In-App Messaging Campaign -scherm.
Selecteer Activate in het Review to activate (Luma - In-App Messaging Campaign) -scherm.
U ziet de Luma - In-App Messaging Campaign with status Live in de lijst Campaigns .

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 de MobileCore.trackfunctie, die op de parameters action en data wordt gebaseerd roept.
// 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:

// Setting parameters and calling function to send in-app message
Task {
    MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"])
}

Valideren met uw app

Rebuild en stel app in werking in de simulator of op een fysiek apparaat van Xcode, gebruikend .
Ga naar de tab 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.

SUCCESS

U hebt de app voor berichten in de app ingeschakeld en een berichtcampagne in de app toegevoegd met Journey Optimizer en de Journey Optimizer-extensie voor de Experience Platform Mobile SDK.

Bedankt dat je tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van Experience Leaguedelen.

Volgende: creeer en vertoningsaanbiedingen

recommendation-more-help