Skapa och skicka push-meddelanden

Gå till Apple utvecklarportal Tangenter.

Om du vill skapa en nyckel väljer du +.

Ange en Nyckelnamn.

Välj Tjänsten Apple Push Notification (APN) kryssrutan.

Välj Fortsätt.

Granska konfigurationen och välj Registrera.

Ladda ned .p8 privat nyckel. Den används senare i konfigurationen för appytan i den här lektionen.

Anteckna Nyckel-ID. Den används i appytskonfigurationen.

Anteckna Team-ID. Den används i appytskonfigurationen.

Från Gränssnitt för datainsamling, markera Appytor till vänster.

Om du vill skapa en konfiguration väljer du Skapa appyta.

Ange en Namn för konfigurationen, till exempel Luma App Tutorial .

Från Konfiguration av mobilprogram, markera Apple iOS.

Ange programpaket-ID för mobilappen i Program-ID (iOS Bundle-ID) fält. Till exempel: com.adobe.luma.tutorial.swiftui.

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

Dra och släpp .p8 Autentiseringsnyckel för push-meddelanden i Apple -fil.

Ange Nyckel-ID, en sträng med 10 tecken som tilldelas när p8 auth key. Den finns under Tangenter i Certifikat, identifierare och profiler på Apple Developer Portal. Se även Skapa en privat nyckel.

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

Välj Spara.

I gränssnittet för datainsamling väljer du Datastreams och välj till exempel din datastream Luma Mobile App.

Välj for Experience Platform och markera Redigera på snabbmenyn.

I Datastreams > > Adobe Experience Platform skärm:

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

2. Adobe Journey Optimizer är markerat. Se Adobe Experience Platform-inställningar för mer information.

3. Om du vill spara din datastream-konfiguration väljer du Spara.

Navigera till Taggar > Tillägg > Katalog,

Öppna egenskapen, till exempel Luma Mobile App Tutorial.

Välj Katalog.

Sök efter Adobe Journey Optimizer tillägg.

Installera tillägget.

I Installera tillägg dialog

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

2. Välj AJO Push Tracking Experience, händelsedatauppsättning datauppsättning från Händelsedatauppsättning lista.

3. Välj Spara i bibliotek och bygge.

   

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

Välj Konfigurera.

Välj nästa Push-felsökning.

Välj Spara.

Välj Push-felsökning från vänster navigering.

Välj Validera inställningar -fliken.

Välj din enhet från Klient lista.

Bekräfta att inga fel visas.

Välj Skicka testöverföring -fliken.

(valfritt) Ändra standardinformationen för Titel och Brödtext

Välj Skicka meddelande om testpush.

Kontrollera Testresultat.

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 Luma mål.

Välj Signering och funktioner -fliken.

Konfigurera Hantera signering automatiskt, Team och Paketidentifierare eller använd dina specifika Apple-utvecklingskonfigurationer.

{modal="regular"}

Välj Luma från MÅLGRUPPER väljer du Signering och funktioner väljer du + Funktioner knapp och sedan markera Push-meddelanden. 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 General och väljer + ikonen längst ned i MÅLGRUPPER -avsnitt.

Du uppmanas att välja en mall för det nya målet. Välj Meddelandetjänsttillägg välj Nästa.

I nästa fönster använder du NotificationExtension som tilläggets namn och klicka på Slutför -knappen.

I Xcode kontrollerar du att AEP Messaging läggs till i listan över paket i paketberoenden. Se Swift Package Manager.

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

Säkerställ AEPMessaging är en del av din lista över importer.

import AEPMessaging

Säkerställ 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 MobileCore.setPushIdentifier API till func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) funktion.

// 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 användargränssnittet för Journey Optimizer väljer du Scheman från den vänstra listen.

Välj Bläddra i tabbfältet.

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

I schemaredigeraren:

1. Välj eventType fält.

2. I Fältegenskaper bläddra nedåt för att se en lista över möjliga värden för händelsetypen. Välj Lägg till rad och lägga till application.test som VÄRDE och Test event for push notification som DISPLAY NAME.

3. Välj Använd.

4. Välj Spara.

   

I användargränssnittet för Journey Optimizer väljer du Konfigurationer från den vänstra listen.

I Kontrollpanel väljer du Hantera knappen i Händelser platta.

I Händelser skärm, välja Skapa händelse.

I Redigera händelse1 ruta:

1. Retur LumaTestEvent som Namn av händelsen.

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

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

4. Välj bredvid Fält lista.

   

   I Fält kontrollerar du att följande fält är markerade (ovanpå de standardfält som alltid är markerade (_id, id och tidsstämpel). Du kan växla mellan Markerad, Alla och Primär eller använder fält.

   • Identifierat program (id),
   • Händelsetyp (eventType),
   • Primär (primär).

   

   Välj sedan OK.

5. Välj bredvid Händelse-id-villkor fält.

   1. I Lägg till ett händelse-id-villkor dialogruta, dra och släppa Händelsetyp (eventType) till Dra och släpp ett element här.

   2. Bläddra nedåt i poverteraren 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 och uppåt och välj OK.

   3. Välj OK för att spara villkoret.

      

6. Välj ECID (ECID) från Namnutrymme lista. Automatiskt Profilidentifierare fältet är ifyllt med ID för det första elementet i nyckel-ECID för map identityMap.

7. Välj Spara.

   

I användargränssnittet för Journey Optimizer väljer du Resor från den vänstra listen.

Välj Skapa resa.

I Reseegenskaper panel:

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

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

3. Säkerställ Tillåt återinträde är markerad och inställd Vänteperiod för återinträde till 30 Sekunder.

4. Välj OK.

   

Tillbaka på arbetsytan, från HÄNDELSER, dra och släpp LumaTestEvent på arbetsytan där den visas Välj en anmälningshändelse eller läsmålgruppsaktivitet.

• I Händelser: LumaTestEvent panel, ange en Etikett, till exempel Luma Test Event.

Från ÅTGÄRDER listruta, dra och släppa Push på till höger om LumaTestEvent aktivitet. I Åtgärder: Skjut ruta:

1. Ange en Etikett, till exempel Luma Test Push Notification, tillhandahåller Beskrivning, till exempel Test push notification for Luma mobile app, markera Transactional från Kategori lista och markera Luma från Penselyta.

2. Välj Redigera innehåll för att börja redigera det faktiska push-meddelandet.

   

   I Push-meddelande redigerare:

   1. Ange en Titel, till exempel Luma Test Push Notification och ange Brödtext, till exempel Test push notification for Luma mobile app.

   2. Du kan också ange en länk till en bild (.png eller .jpg) i Lägg till 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 för push-meddelanden väljer du OK.

Resan ska se ut så här nedan. Välj Publicera för att publicera och aktivera din resa.

Navigera till Luma > Luma > Modell > XML > TestPushPayload i Xcode Project navigator 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 navigator 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 sedan anrop sendExperienceEvent när nyttolasten konverteras till ett lexikon. Den här koden, som nu även tar hänsyn till asynkrona aspekter av att anropa Adobe Experience Platform SDK genom att använda Swift-modellen för samtidighet baserat 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 Inställningar -fliken.

Tryck Push-meddelande. Push-meddelandet visas i din app.

{width="300"}