Pushmeldingen maken en verzenden

Navigeer in de Apple Developer Portal naar Keys .

Selecteer + om een sleutel te maken.

Geef een Key Name op.

Selecteer Apple Push Notification service (APNs) checkbox.

Selecteer Continue.

Controleer de configuratie en selecteer Register .

Download de persoonlijke sleutel van .p8 . Het wordt gebruikt in de configuratie van de Oppervlakte van de Toepassing later in deze les.

Noteer de Key ID . Het wordt gebruikt in de configuratie van de Oppervlakte van de App.

Noteer de Team ID . Het wordt gebruikt in de configuratie van de Oppervlakte van de App.

Van de interface van de Inzameling van Gegevens, selecteer App Surfaces in het linkerpaneel.

Selecteer Create App Surface als u een configuratie wilt maken.

Voer een Name in voor de configuratie, bijvoorbeeld Luma App Tutorial .

Selecteer Apple iOS in Mobile Application Configuration .

Voer de bundel-id voor de mobiele app in het veld App ID (iOS Bundle ID) in. Bijvoorbeeld com.adobe.luma.tutorial.swiftui .

Schakel de schakeloptie Push Credentials in om uw referenties toe te voegen.

De belemmering en laat vallen uw .p8 Sleutel van de Authentificatie van het Bericht van de Duw van Apple dossier.

Geef Key ID op, een tekenreeks van 10 tekens die is toegewezen tijdens het maken van de p8 auth-toets. Het kan onder het Keys lusje in de Certificaten, Herkenningstekens en de pagina van Profielen van de de poortpagina's van de Ontwikkelaar van Apple worden gevonden. Zie ook tot een privé sleutelleiden.

Geef de Team ID op. Identiteitskaart van het Team is een waarde die onder het 1} lusje van het Lidmaatschap {of bij de bovenkant van de het poortpagina van de Ontwikkelaar van Apple kan worden gevonden. Zie ook tot een privé sleutelleiden.

Selecteer Save.

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:

1. Selecteer AJO Push Profile Dataset in Profile Dataset als dit nog niet is geselecteerd. Deze profieldataset wordt vereist wanneer het gebruiken van de MobileCore.setPushIdentifier API vraag (zie het apparatenteken van het Register voor duw berichten) die het unieke herkenningsteken voor duw berichten (a.k.a. duw herkenningsteken) als deel van het profiel van de gebruiker verzekert.

2. Adobe Journey Optimizer is geselecteerd. Zie {de montages van 0} Adobe Experience Platform 🔗 voor meer informatie.

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

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.

In het dialoogvenster Install Extension

1. Selecteer een omgeving, bijvoorbeeld Development .

2. Selecteer de AJO Push Tracking Experience Event Dataset dataset van de Event Dataset lijst.

3. Selecteer Save to Library and Build.

   

Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat aan Verzekering te verbinden.

Selecteer Configure in de gebruikersinterface van Verzekering.

Selecteer naast Push Debug.

Selecteer Save.

Selecteer Push Debug in de linkernavigatie.

Selecteer het tabblad Validate Setup.

Selecteer het apparaat in de lijst Client .

Bevestig dat u geen fouten krijgt.

Selecteer het tabblad Send Test Push.

(optioneel) Wijzig de standaarddetails voor Title en Body

Selecteer Send Test Push Notification.

Controleer Test Results.

De pushmelding voor de test wordt weergegeven in uw app.

{width="300"}

Ga naar uw app in Xcode.

Selecteer Luma in de projectnavigator.

Selecteer het doel Luma .

Selecteer het Ondertekenen & Capabilities lusje.

Configureer Automatic manage signing, Team en Bundle Identifier of gebruik uw specifieke Apple-ontwikkelinrichtingsgegevens.

{modal="regular"}

Selecteer in Xcode Luma in de lijst TARGETS , selecteer het tabblad Signing & Capabilities , selecteer de knop + Capability en selecteer vervolgens Push Notifications . Hierdoor kan uw app pushmeldingen ontvangen.

Vervolgens moet u een Berichtgevingsextensie aan de app toevoegen. Ga terug naar de tab General en selecteer het pictogram + onder aan de sectie TARGETS .

U wordt gevraagd om de sjabloon voor uw nieuwe doel te selecteren. Selecteer Notification Service Extension en selecteer vervolgens Next .

Gebruik NotificationExtension in het volgende venster als de naam van de extensie en klik op de knop Finish .

In Xcode, zorg ervoor dat het Overseinen 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
]

Voeg de MobileCore.setPushIdentifierAPI aan de func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) functie toe.

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

Deze functie haalt het apparaattoken op dat uniek is voor het apparaat waarop de toepassing is geïnstalleerd. Dan plaatst het teken voor de levering van het dupbericht gebruikend de configuratie die u opstelling hebt en die op de dienst van het Bericht van de Duw van Apple (APNs) vertrouwt.

Selecteer in de gebruikersinterface van Journey Optimizer de optie Schemas in het linkerspoor.

Selecteer Browse in de tabbalk.

Selecteer het schema, bijvoorbeeld Luma Mobile App Event Schema om het te openen.

In de Schema-editor:

1. Selecteer het veld eventType .

2. Schuif in het deelvenster Field properties omlaag om de lijst met mogelijke waarden voor het gebeurtenistype weer te geven. Selecteer Add row en voeg application.test toe als de VALUE en Test event for push notification als de DISPLAY NAME .

3. Selecteer Apply.

4. Selecteer Save.

   toe

Selecteer in de gebruikersinterface van Journey Optimizer de optie Configurations in het linkerspoor.

Selecteer in het scherm Dashboard de knop Manage in de tegel Events .

Selecteer Create Event in het Events -scherm.

In het deelvenster Edit event event1 :

1. Voer LumaTestEvent in als de Name van de gebeurtenis.

2. Geef een Description op, bijvoorbeeld Test event to trigger push notifications in Luma app .

3. Selecteer het mobiele schema van de toepassingservaring die u vroeger in creeerde een schema XDMvan de Schema lijst, bijvoorbeeld Luma Mobile App Event Schema v.1 creeerde.

4. Selecteer naast de Fields lijst.

   uit

   Controleer in het dialoogvenster Fields of de volgende velden zijn geselecteerd (boven op de standaardvelden die altijd zijn geselecteerd (_id , id en timestamp). U kunt, het gebruiken van de dropdown lijst, tussen Selected, All en Primary van een knevel voorzien of het gebied gebruiken.

   • Application Identified (id) ,
   • Event Type (eventType),
   • Primary (primary).

   uit

   Selecteer vervolgens Ok .

5. Selecteer naast het Event id condition gebied.

   1. Sleep in het dialoogvenster Add an event id condition Event Type (eventType) naar Drag and drop an element here .

   2. In popover, rol aan de bodem en selecteer application.test (dat het gebeurtenistype is u vroeger aan de lijst van gebeurtenistypen als deel van toevoegde Werk uw schema). Blader vervolgens omhoog en selecteer Ok .

   3. Selecteer Ok om de voorwaarde op te slaan.

      uit

6. Selecteer ECID (ECID) in de lijst Namespace . Het veld Profile identifier wordt automatisch gevuld met The id of the first element of the key ECID for the map identityMap .

7. Selecteer Save.

   uit

Selecteer in de gebruikersinterface van Journey Optimizer de optie Journeys in het linkerspoor.

Selecteer Create Journey.

In het deelvenster Journey Properties :

1. Voer een Name in voor de rit, bijvoorbeeld Luma - Test Push Notification Journey .

2. Voer een Description in voor de rit, bijvoorbeeld Journey for test push notifications in Luma mobile app .

3. Zorg ervoor dat Allow re-entrance is geselecteerd en stel Re-entrance wait period in op 30 Seconds .

4. Selecteer Ok.

   

Terug bij het wegcanvas, van EVENTS, sleep en laat vallen uw LumaTestEvent op het canvas waar het Select an entry event or a read audience activity toont.

• Voer in het deelvenster Events: LumaTestEvent bijvoorbeeld een Label Luma Test Event in.

Van ACTIONS dropdown, belemmering en laat vallen Push op toe die aan het recht van uw LumaTestEvent activiteit verschijnen. In het deelvenster Actions: Push :

1. Geef een Label op, bijvoorbeeld Luma Test Push Notification , geef een Description , bijvoorbeeld Test push notification for Luma mobile app , selecteer Transactional in de lijst Category en selecteer Luma in de lijst Push surface .

2. Selecteer Edit content beginnen het daadwerkelijke dupbericht uit te geven.

   

   In de Push Notification editor:

   1. Voer bijvoorbeeld een Title Luma Test Push Notification in en voer een Body in, bijvoorbeeld Test push notification for Luma mobile app .

   2. U kunt desgewenst een koppeling naar een afbeelding (.png of .jpg) invoeren in Add media . Als u dit doet, maakt de afbeelding deel uit van de pushmelding.

   3. Om de redacteur te bewaren en te verlaten, uitgezochte .

      

3. Selecteer Ok als u de definitie van de pushmelding wilt opslaan en voltooien.

Je reis moet er hieronder uitzien. Selecteer Publish om uw reis te publiceren en te activeren.

Navigeer naar Luma > Luma > Model > XDM > TestPushPayload in de Xcode-projectnavigator en inspecteer de code.

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

De code is een representatie van de volgende eenvoudige lading die u gaat verzenden om de reis van de testpushmelding te activeren

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode Project navigator en voeg de volgende code toe aan func sendTestPushEvent(applicationId: String, eventType: String) :

// Create payload and send experience event
Task {
    let testPushPayload = TestPushPayload(
        application: Application(
            id: applicationId
        ),
        eventType: eventType
    )
    // send the final experience event
    await sendExperienceEvent(
        xdm: testPushPayload.asDictionary() ?? [:]
    )
}

Met deze code wordt een instantie testPushPayload gemaakt met behulp van de parameters die aan de functie ( applicationId en eventType ) worden doorgegeven. Vervolgens wordt sendExperienceEvent aangeroepen tijdens het omzetten van de laadbewerking naar een woordenboek. In deze code wordt deze keer ook rekening gehouden met de asynchrone aspecten van het aanroepen van de Adobe Experience Platform SDK door gebruik te maken van het gelijktijdige aanroepen van Swift-model op basis van await en async .

Navigeer naar Luma > Luma > Views > General > ConfigView in de Xcode-projectnavigator. Voeg in de definitie van Knop voor pushmeldingen de volgende code toe om de lading van de testpushmelding tijdens de gebeurtenisbeleving te verzenden, zodat de rit wordt geactiveerd wanneer op die knop wordt getikt.

// Setting parameters and calling function to send push notification
Task {
    let eventType = testPushEventType
    let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found"
    await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType)
}

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

Ga naar de tab Settings .

Tik op Push Notification. De pushmelding wordt weergegeven in uw app.

{width="300"}