Skapa och skicka push-meddelanden

Gå till Keys på Apple utvecklarportal.

Välj + om du vill skapa en nyckel.

Ange en Key Name.

Markera kryssrutan Apple Push Notification service (APN:er).

Välj Continue.

Granska konfigurationen och välj Register.

Hämta den privata nyckeln .p8. Den används senare i konfigurationen för appytan i den här lektionen.

Notera Key ID. Den används i appytskonfigurationen.

Notera Team ID. Den används i appytskonfigurationen.

I gränssnittet för datainsamling väljer du App Surfaces i den vänstra panelen.

Välj Create App Surface om du vill skapa en konfiguration.

Ange Name som konfiguration, till exempel Luma App Tutorial.

Välj Apple iOS från Mobile Application Configuration.

Ange ID för mobilappspaket i fältet App ID (iOS Bundle ID). Exempel: com.adobe.luma.tutorial.swiftui.

Aktivera Push Credentials för att lägga till dina autentiseringsuppgifter.

Dra och släpp .p8 Apple Push Notification Authentication Key-filen.

Ange Key ID, en sträng med 10 tecken som tilldelats när autentiseringsnyckeln p8 skapades. Den finns på fliken Keys på sidan Certifikat, Identifierare och profiler på sidorna på Apple Developer Portal. Se även Skapa en privat nyckel.

Ange Team ID. Team-ID är ett värde som finns på fliken Medlemskap eller högst upp på sidan Apple Developer Portal. Se även Skapa en privat nyckel.

Välj Save.

I användargränssnittet för datainsamling väljer du Datastreams och markerar ditt datastream, till exempel Luma Mobile App.

Välj för Experience Platform och välj Edit på snabbmenyn.

På skärmen Datastreams > > Adobe Experience Platform:

1. Om det inte redan är markerat väljer du AJO Push Profile Dataset från Profile Dataset. Den här profildatauppsättningen krävs när du använder API-anropet MobileCore.setPushIdentifier (se Registrera enhetstoken för push-meddelanden) som ser till att den unika identifieraren för push-meddelanden (t.ex. push-identifierare) lagras som en del av användarens profil.

2. Adobe Journey Optimizer har valts. Mer information finns i Adobe Experience Platform-inställningar.

3. Välj Save om du vill spara dataströmskonfigurationen.

Navigera till Tags > Extensions > Catalog,

Öppna din egenskap, till exempel Luma Mobile App Tutorial.

Välj Catalog.

Sök efter tillägget Adobe Journey Optimizer.

Installera tillägget.

I dialogrutan Install Extension

1. Välj en miljö, till exempel Development.

2. Välj datauppsättningen AJO Push Tracking Experience Event Dataset i listan Event Dataset.

3. Välj Save to Library and Build.

   

Granska avsnittet Installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.

Välj Configure i försäkringsgränssnittet.

Välj bredvid Push Debug.

Välj Save.

Välj Push Debug i den vänstra navigeringen.

Klicka på fliken Validate Setup.

Välj din enhet i listan Client.

Bekräfta att inga fel visas.

Klicka på fliken Send Test Push.

(valfritt) Ändra standardinformationen för Title och Body

Välj Send Test Push Notification.

Kontrollera Test Results.

Du bör se push-meddelandet för testningen visas i din app.

{width="300"}

Gå till appen i Xcode.

Välj Luma i projektnavigatorn.

Välj målet Luma.

Välj fliken Signering och funktioner.

Konfigurera Automatic manage signing, Team och Bundle Identifier, eller använd din specifika information om etablering av Apple-utveckling.

{modal="regular"}

I Xcode väljer du Luma i listan TARGETS, väljer fliken Signing & Capabilities, klickar på knappen + Capability och väljer sedan Push Notifications. Detta gör att din app kan ta emot push-meddelanden.

Sedan måste du lägga till ett meddelandetillägg i programmet. Gå tillbaka till fliken General och välj ikonen + längst ned i avsnittet TARGETS.

Du uppmanas att välja en mall för det nya målet. Välj Notification Service Extension och sedan Next.

I nästa fönster använder du NotificationExtension som namn på tillägget och klickar på knappen Finish.

Kontrollera att AEP Messaging har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.

Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

Se till att AEPMessaging ingår i din lista över importer.

import AEPMessaging

Kontrollera att Messaging.self är en del av den array med tillägg som du registrerar.

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
]

Lägg till API:t MobileCore.setPushIdentifier i funktionen func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

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

Den här funktionen hämtar enhetstoken som är unik för den enhet som appen är installerad på. Ställer sedan in token för leverans av push-meddelanden med den konfiguration som du har konfigurerat och som är beroende av Apple Push Notification-tjänst (APN:er).

I Journey Optimizer-gränssnittet väljer du Schemas i den vänstra listen.

Välj Browse i flikfältet.

Välj ditt schema, till exempel Luma Mobile App Event Schema, för att öppna det.

I schemaredigeraren:

1. Markera fältet eventType.

2. I rutan Field properties rullar du nedåt för att se en lista över möjliga värden för händelsetypen. Välj Add row och lägg till application.test som VALUE och Test event for push notification som DISPLAY NAME.

3. Välj Apply.

4. Välj Save.

   

I Journey Optimizer-gränssnittet väljer du Configurations i den vänstra listen.

På skärmen Dashboard väljer du knappen Manage i rutan Events.

Välj Create Event på skärmen Events.

I rutan Edit event event1:

1. Ange LumaTestEvent som Name för händelsen.

2. Ange en Description, till exempel Test event to trigger push notifications in Luma app.

3. Välj det händelseschema för mobilappsupplevelse som du skapade tidigare i Skapa ett XDM-schema från listan Schema, till exempel Luma Mobile App Event Schema v.1.

4. Välj bredvid listan Fields.

   

   I dialogrutan Fields ser du till att följande fält är markerade (ovanpå de standardfält som alltid är markerade (_id, id och timestamp)). Du kan växla mellan Selected, All och Primary i listrutan eller använda fältet .

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

   

   Välj sedan Ok.

5. Välj bredvid fältet Event id condition.

   1. Dra och släpp Event Type (eventType) i dialogrutan Add an event id condition till Drag and drop an element here.

   2. Bläddra längst ned i povern och välj application.test (som är den händelsetyp som du lade till tidigare i listan över händelsetyper som en del av Uppdatera ditt schema). Bläddra sedan uppåt till toppen och välj Ok.

   3. Välj Ok om du vill spara villkoret.

      

6. Välj ECID (ECID) i listan Namespace. Fältet Profile identifier fylls i automatiskt med The id of the first element of the key ECID for the map identityMap.

7. Välj Save.

   

I Journey Optimizer-gränssnittet väljer du Journeys i den vänstra listen.

Välj Create Journey.

På panelen Journey Properties:

1. Ange en Name för resan, till exempel Luma - Test Push Notification Journey.

2. Ange en Description för resan, till exempel Journey for test push notifications in Luma mobile app.

3. Kontrollera att Allow re-entrance är markerat och ange Re-entrance wait period till 30 Seconds.

4. Välj Ok.

   

Tillbaka på arbetsytan på resan, från EVENTS, dra och släpp LumaTestEvent på arbetsytan där den visas Select an entry event or a read audience activity.

• Ange Label, till exempel Luma Test Event, på panelen Events: LumaTestEvent.

I listrutan ACTIONS drar och släpper du Push på som visas till höger om din LumaTestEvent-aktivitet. I rutan Actions: Push:

1. Ange en Label, till exempel Luma Test Push Notification, ge en Description, till exempel Test push notification for Luma mobile app, välj Transactional i listan Category och välj Luma i listan Push surface.

2. Välj Edit content om du vill börja redigera det faktiska push-meddelandet.

   

   I Push Notification-redigeraren:

   1. Ange en Title, till exempel Luma Test Push Notification, och ange en Body, till exempel Test push notification for Luma mobile app.

   2. Du kan också ange en länk till en bild (.png eller .jpg) i Add media. Om du gör det blir bilden en del av push-meddelandet.

   3. Om du vill spara och lämna redigeraren väljer du .

      

3. Om du vill spara och slutföra definitionen av push-meddelanden väljer du Ok.

Resan ska se ut så här nedan. Välj Publish om du vill publicera och aktivera din resa.

Navigera till Luma > Luma > Model > XDM > TestPushPayload i Xcode Project-navigatorn och kontrollera koden.

import Foundation

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

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

Koden är en representation av följande enkla nyttolast som du ska skicka för att utlösa testresan för push-meddelanden

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

Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project-navigatorn och lägg till följande kod i 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() ?? [:]
    )
}

Den här koden skapar en testPushPayload-instans med de parametrar som har angetts för funktionen (applicationId och eventType) och anropar sedan sendExperienceEvent när nyttolasten konverteras till ett lexikon. Den här koden, den här gången, tar även hänsyn till asynkrona aspekter av att anropa Adobe Experience Platform SDK genom att använda Swift-samtidighetsmodellen som baseras på await och async.

Navigera till Luma > Luma > Views > General > ConfigView i Xcode Project-navigatorn. I definitionen för knappen Push Notification (Push-meddelande) lägger du till följande kod för att skicka händelsenyttolasten för testpush-meddelanden för att utlösa din resa när användaren trycker på knappen.

// 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)
}

Återskapa och kör appen i simulatorn eller på en fysisk enhet från Xcode med .

Gå till fliken Settings.

Tryck på Push Notification. Push-meddelandet visas i din app.

{width="300"}