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. Als u reizen gebruikt (zie de Journey Optimizer-pushberichten les), worden handelingen op volgorde uitgevoerd.

Architectuur

Voordat u in-app berichten verzendt met Journey Optimizer, moet u ervoor zorgen dat de juiste configuraties en integratie aanwezig zijn. Voor meer informatie over de gegevensstroom in de app in Journey Optimizer raadpleegt u de documentatie.

NOTE
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 toegangsrechten zoals beschreven hier. 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.
  • Valideer installatie in Betrouwbaarheid.
  • 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 uw omgeving al hebt ingesteld als onderdeel van het Journey Optimizer-pushberichten les, zou u sommige stappen in deze opstellingssectie reeds kunnen reeds uitgevoerd hebben.

Een toepassingsoppervlak toevoegen aan gegevensverzameling

  1. Van de Interface voor gegevensverzameling, selecteert u Toepassingsoppervlakken in het linkerdeelvenster.

  2. Als u een configuratie wilt maken, selecteert u App-oppervlak maken.
    startpagina van app

  3. Voer een Naam voor de configuratie, bijvoorbeeld Luma App Tutorial .

  4. Van Configuratie van mobiele toepassingen, selecteert u Apple iOS.

  5. Voer de bundel-id voor de mobiele app in het dialoogvenster Toepassings-id (iOS-bundel-id) veld. Bijvoorbeeld: com.adobe.luma.tutorial.swiftui.

  6. Selecteren Opslaan.

    configuratie toepassingsoppervlak

Gegevensstroomconfiguratie bijwerken

Om ervoor te zorgen dat gegevens die u van uw mobiele app naar het Edge-netwerk verzendt, naar Journey Optimizer worden doorgestuurd, werkt u de configuratie van Experience Edge bij.

  1. Selecteer in de gebruikersinterface voor gegevensverzameling de optie Gegevensstromen en selecteert u bijvoorbeeld uw gegevensstroom Luma Mobile App.

  2. Selecteren Meer for Experience Platform en selecteert u Bewerken Bewerken in het contextmenu.

  3. In de Gegevensstromen > Map > Adobe Experience Platform scherm, controleren Adobe Journey Optimizer is geselecteerd. Zie Adobe Experience Platform-instellingen voor meer informatie .

  4. Als u de configuratie van de gegevensstroom wilt opslaan, selecteert u Opslaan.

    AEP-configuratie gegevensstroom

Journey Optimizer-extensie installeren

Uw app werkt alleen met Journey Optimizer als u de eigenschap tag bijwerkt.

  1. Navigeren naar Tags > Extensies > Catalogus.
  2. De eigenschap openen, bijvoorbeeld Luma Mobile App Tutorial.
  3. Selecteren Catalogus.
  4. Zoeken naar Adobe Journey Optimizer extensie.
  5. De extensie installeren.

Wanneer alleen in uw app berichten gebruiken, in Extensie installeren of Extensie configureren hoeft u niets te configureren. Als u echter al de Pushmeldingen in de zelfstudie ziet u dat voor de Ontwikkeling milieu, Dataset voor AJO-gebeurtenis voor het bijhouden van push dataset wordt geselecteerd uit de Gebeurtenisgegevens lijst.

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 SDK voor berichten installeren en registreren. Als deze stappen niet duidelijk zijn, herzie SDK's installeren sectie.

NOTE
Als u het SDK's installeren is de SDK al geïnstalleerd en kunt u deze stap overslaan.
  1. Controleer in Xcode of AEP-berichten wordt toegevoegd aan de lijst met pakketten in Pakketafhankelijke onderdelen. Zie Swift Package Manager.

  2. Navigeren naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.

  3. Zorgen AEPMessaging maakt deel uit van uw lijst met importbewerkingen.

    import AEPMessaging

  4. Zorgen Messaging.self maakt deel uit 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
    ]
    

Setup valideren met betrouwbaarheid

  1. Controleer de installatie-instructies om de simulator of het apparaat aan te sluiten op Betrouwbaarheid.

  2. Selecteer in de betrouwbaarheidsinterface de optie Configureren.
    configureren, klik

  3. Selecteer de Plus knop naast In-app berichten.

  4. Selecteren Opslaan.
    opslaan

  5. Selecteren In-app berichten in de linkernavigatie.

  6. Selecteer de Validatie tab. Bevestig dat u geen fouten krijgt.

    Validatie in de toepassing

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 deze zelfstudie gaat u de generieke API's van de Mobile Core en de API's die onafhankelijk zijn van de extensie gebruiken (zie Algemene mobiele kern-API's) om het bijhouden van gebeurtenissen van gebruikersschermen, handelingen 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 aan alle SDK-extensies van het mobiele platform is gekoppeld, 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.

  1. Selecteer in de gebruikersinterface van Journey Optimizer Campagnes van de linkerspoorstaaf.

  2. Selecteren Campagne maken.

  3. In de Campagne maken scherm:

    1. Selecteren Bericht in de app en selecteer een toepassingsoppervlak in het menu App-oppervlak lijst, bijvoorbeeld Luma Mobile App.

    2. Selecteren Maken

      Campagneigenschappen

  4. In het scherm Campagne-definitie, op Eigenschappen, voert u een Naam bijvoorbeeld voor de campagne Luma - In-App Messaging Campaignen Beschrijving bijvoorbeeld In-app messaging campaign for Luma app.
    Campagneraam

  5. Omlaag schuiven naar Handeling en selecteert u Inhoud bewerken.

  6. In de Bericht in de app scherm:

    1. Selecteren Modal als de Berichtlay-out.

    2. Enter https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png voor de Media-URL.

    3. Voer een Koptekst bijvoorbeeld Welcome to this Luma In-App Message en voert u een Lichaam bijvoorbeeld Triggered by pushing that button in the app....

    4. Enter Afwijzen als de Knop #1 tekst (primair).

    5. De voorvertoning wordt bijgewerkt.

    6. Selecteren Controleren om te activeren.

      Editor in app

  7. In de Controleren om te activeren (Luma - Berichtencampagne in de app) scherm, selecteren Bewerken in de Schema tegel.
    Plan voor revisie selecteren

  8. Terug in de Luma - In-App Messaging Campaign scherm, selecteren Bewerken Triggers bewerken.

  9. In de In-app berichttrigger configureren, configureert u de details van de trackactie die het bericht in de app activeert:

    1. Om te verwijderen Gebeurtenis voor starten van toepassing, selecteert u Sluiten .

    2. Gebruiken Toevoegen Voorwaarde toevoegen herhaaldelijk de volgende logica maken voor Bericht weergeven als.

    3. Klikken Gereed.

      Triggerlogica

    U hebt een handeling track gedefinieerd, waarbij de Handeling equals in-app en de Contextgegevens met de handeling is een sleutelwaardepaar van "showMessage" : "true".

  10. Terug in de Luma - In-App Messaging Campaign scherm, selecteren Controleren om te activeren.

  11. In de Controleren om te activeren (Luma - Berichtencampagne in de app) scherm, selecteren Activeren.

  12. U ziet uw Luma - In-App Messaging Campaign met status Live in de Campagnes lijst.
    Lijst met campagnes

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.

  1. Ga naar Luma > Luma > Utils > MobileSDK in de Xcode-projectnavigator. Zoek de func sendTrackAction(action: String, data: [String: Any]?) en voegt de volgende code toe, die de MobileCore.track functie, gebaseerd op de parameters action en data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Ga naar Luma > Luma > Views > General > ConfigView in de Xcode-projectnavigator. 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"])
    }
    

Valideren met uw app

  1. De app opnieuw samenstellen en uitvoeren in de simulator of op een fysiek apparaat van Xcode met Afspelen .

  2. Ga naar de Instellingen tab.

  3. Tikken Bericht in de app. Het bericht in de app wordt weergegeven in uw app.

    {width="300"}

Implementatie valideren bij Betrouwbaarheid

U kunt uw in-app berichten in de UI van de Verzekering bevestigen.

  1. Controleer de installatie-instructies om de simulator of het apparaat aan te sluiten op Betrouwbaarheid.
  2. Selecteren In-app berichten.
  3. Selecteren Gebeurtenislijst.
  4. Selecteer een Bericht weergeven vermelding.
  5. Inspect the raw event, vooral the html, die de volledige lay-out en inhoud van het bericht in de app bevat.
    Betrouwbaarheid in app-bericht

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 berichtencampagne in de app toegevoegd met Journey Optimizer en de Journey Optimizer-extensie voor de Experience Platform Mobile SDK.
Bedankt dat u tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene feedback wilt delen of suggesties voor toekomstige inhoud wilt hebben, deelt u deze over deze Experience League Communautaire discussiestuk.

Volgende: Aanbiedingen maken en weergeven

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