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.

Architectuur {modal="regular"}

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.

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.
  • 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

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

Om te beginnen moet u een kanaalconfiguratie maken om meldingen van App-berichten van Journey Optimizer te kunnen verzenden.

  1. Open in de Journey Optimizer-interface het menu Channels > General settings > Channel configurations en selecteer vervolgens Create channel configuration .

  2. Voer een naam en beschrijving (optioneel) voor de configuratie in. Bijvoorbeeld LumaInAppMessaging en Channel 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.
  3. 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).

  4. Selecteer het In-app overseinen kanaal.

  5. 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.

  6. 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 .
  7. Voer de app-id in voor het platform dat u wilt ondersteunen.

    creeer een kanaalconfiguratie {modal="regular"}

  8. 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.

  1. Selecteer Datastreams in de gebruikersinterface voor gegevensverzameling en selecteer de gegevensstroom, bijvoorbeeld Luma Mobile App .

  2. Selecteer Meer voor Experience Platform en selecteer uitgeven Edit van het contextmenu.

  3. In Datastreams > Omslag > Adobe Experience Platform scherm, zorg ervoor Adobe Journey Optimizer wordt geselecteerd. Zie {de montages van 0} Adobe Experience Platform voor meer informatie.

  4. Selecteer Save om de configuratie van de gegevensstroom op te slaan.

    de gegevensstroomconfiguratie van AEP {modal="regular"}

Journey Optimizer-extensie installeren

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

  1. Navigeer naar Tags > Extensions > Catalog .
  2. Open uw eigenschap, bijvoorbeeld Luma Mobile App Tutorial .
  3. Selecteer Catalog.
  4. Zoek naar de extensie Adobe Journey Optimizer .
  5. 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.

NOTE
Als u voltooide installeerde SDKssectie, dan is SDK reeds geïnstalleerd en u kunt deze stap overslaan.
iOS
  1. 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 .

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

  3. Controleer of AEPMessaging deel uitmaakt van uw lijst met importbewerkingen.

    import AEPMessaging

  4. 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
    ]
    
Android
  1. In de Studio van Android, zorg ervoor dat aepsdk-overseinen-androiddeel van de gebiedsdelen in build.gradle.kts in Android ChevronDown > Gradle Scripts uitmaakt. Zie Gradle.

  2. Navigeer aan Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in de het projectnavigator van Android Studio.

  3. Controleer of com.adobe.marketing.mobile.Messaging deel uitmaakt van uw lijst met importbewerkingen.

    import import com.adobe.marketing.mobile.Messaging

  4. 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

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.

  2. Selecteer Configure in de gebruikersinterface van Assurance.
    vorm klik {modal="regular"}

  3. Selecteer plus knoop naast In-App Messaging.

  4. Selecteer Save.
    sparen {modal="regular"}

  5. Selecteer In-App Messaging in de linkernavigatie.

  6. Selecteer het tabblad Validation. Bevestig dat u geen fouten krijgt.

    In-app Bevestiging {modal="regular"}

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.

  1. Selecteer in de gebruikersinterface van Journey Optimizer de optie Campaigns in het linkerspoor.

  2. Selecteer Create Campaign.

  3. In de Create your campaign dialoog, uitgezochte Klok Scheduled - Marketing en selecteert Confirm.

  4. In het Campaign - YYYY-MM-DD HH SS UTC+XX:XX scherm:

    1. Op het tabblad Properties :

      1. Voer bijvoorbeeld een naam in voor de campagne Luma Mobile In-App Campaign .
      2. Voeg desgewenst een beschrijving toe.
    2. Selecteer het tabblad Action.

      1. Onder Show message if, uitgezocht voeg toe Add action. Selecteer In-app message in het keuzemenu.

      2. Selecteer uw configuratie in het vervolgkeuzemenu In-app message configuration . Bijvoorbeeld LumaInAppMessaging .

      3. Selecteer uitgeven Edit triggers.

      4. In het dialoogvenster In-app message trigger :

        1. Selecteer Application launch en selecteer Track action in het vervolgkeuzemenu.

        2. Selecteer AddCircle Add condition.

        3. Selecteer Action en equals in de vervolgkeuzemenu's.

        4. Voer in-app in.

        5. Selecteer AddCircle Add condition.

        6. Selecteer Context data in de vervolgkeuzelijst en voer showMessage in.

        7. Selecteer equals in de vervolgkeuzelijst en voer true in.

          geeft trekkers {modal="regular"} uit

        8. Selecteer Done.

    3. Selecteer de tab Content in het scherm met de hoofddefinitie van de campagne.

      1. Schakel Advanced formatting in.

      2. Selecteer Modal als de Messaging layout . Selecteer Switch layout in het dialoogvenster Change layout .

      3. Op het tabblad Content .

        1. Voer https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png in voor de Media URL .
        2. 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... .

        In-app berichtinhoud {modal="regular"}

      4. Selecteer Settings tab.

        1. Selecteer Customize size in Message .
        2. Schakel Fit to content uit.
        3. Stel Height in op 75% .

        In-app berichtmontages {modal="regular"}

  5. Selecteer Review to activate. Om naar keuze om het even welke configuraties voor Content uit te geven, Properties, Actions, of meer, uitgezocht geeft uit.

  6. In het Review to activate (*campagnenaam *) ​scherm, selecteer Activate.

  7. Na een tijdje, ziet u uw campagnenaam met status Live in de Campaigns lijst.
    lijst van de Campagne {modal="regular"}

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.

iOS
  1. 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.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. 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"])
    }
    
Android
  1. Ga naar Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in de navigator van Android Studio. Vind de fun sendTrackAction(action: String, data: Map<String, String>?) functie, en voeg de volgende code toe, die de MobileCore.trackfunctie, die op de parameters action en data wordt gebaseerd roept.

    code language-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Ga naar Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt in de navigator van Android Studio. Zoek de code voor de 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.

iOS
  1. Rebuild en stel app in werking in de simulator of op een fysiek apparaat van Xcode, gebruikend Spel .

  2. Ga naar het tabblad Settings.

  3. Tik op In-App Message. Het bericht in de app wordt weergegeven in uw app.

    {width="300"}

Android
  1. Rebuild en stel app in werking in de simulator of op een fysiek apparaat van de Studio van Android, gebruikend Spel .

  2. Ga naar het tabblad Settings.

  3. Tik op In-App Message. Het bericht in de app wordt weergegeven in uw app.

    {width="300"}

Implementatie valideren in Assurance

U kunt uw berichten in de app valideren in de gebruikersinterface van Assurance.

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.

  2. Selecteer In-App Messaging.

  3. Selecteer Event List.

  4. Selecteer een Display message -item.

  5. Inspecteer de onbewerkte gebeurtenis, met name de html , die de volledige lay-out en inhoud van het bericht in de app bevat.

    Assurance In-App Bericht {modal="regular"}

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
9fed61f5-c338-47ad-8005-0b89a5f4af8b