Create and send push notifications

In the Apple developer portal, navigate to Keys.

To create a key, select +.

Provide a Key Name.

Select the Apple Push Notification service (APNs) checkbox.

Select Continue.

Review the configuration and select Register.

Download the .p8 private key. It is used in the App Surface configuration later in this lesson.

Make note of the Key ID. It is used in the App Surface configuration.

Make note of the Team ID. It is used in the App Surface configuration.

From the Data Collection interface, select App Surfaces in the left-hand panel.

To create a configuration, select Create App Surface.

Enter a Name for the configuration, for example Luma App Tutorial .

From Mobile Application Configuration, select Apple iOS.

Enter the mobile app Bundle Id in the App ID (iOS Bundle ID) field. For example, com.adobe.luma.tutorial.swiftui.

Switch on the Push Credentials toggle to add your credentials.

Drag and drop your .p8 Apple Push Notification Authentication Key file.

Provide the Key ID, a 10-character string assigned during the creation of p8 auth key. It can be found under the Keys tab in the Certificates, Identifiers and Profiles page of the Apple Developer portal pages. See also Create a private key.

Provide the Team ID. The Team ID is a value which can be found under the Membership tab or at the top of the Apple Developer portal page. See also Create a private key.

Select Save.

In the Data Collection UI, select Datastreams, and select your datastream, for example Luma Mobile App.

Select for Experience Platform and select Edit from the context menu.

In the Datastreams > > Adobe Experience Platform screen:

1. If not already selected, select AJO Push Profile Dataset from Profile Dataset. This profile dataset is required when using the MobileCore.setPushIdentifier API call (see Register device token for push notifications) which ensures the unique identifier for push notifications (a.k.a. push identifier) is stored as part of the profile of the user.

2. Adobe Journey Optimizer is selected. See Adobe Experience Platform settings for more information.

3. To save your datastream configuration, select Save.

Navigate to Tags > Extensions > Catalog,

Open your property, for example Luma Mobile App Tutorial.

Select Catalog.

Search for the Adobe Journey Optimizer extension.

Install the extension.

In the Install Extension dialog

1. Select an environment, for example Development.
2. Select the AJO Push Tracking Experience Event Dataset dataset from the Event Dataset list.
3. Select Save to Library and Build.
   

Review the setup instructions section to connect your simulator or device to Assurance.

In the Assurance UI, select Configure.

Select next to Push Debug.

Select Save.

Select Push Debug from the left navigation.

Select the Validate Setup tab.

Select your device from the Client list.

Confirm that you aren’t getting any errors.

Select the Send Test Push tab.

(optional) Change the default details for Title and Body

Select Send Test Push Notification.

Check the Test Results.

You should see the test push notification appear in your app.

{width="300/"}

Go to your app in Xcode.

Select Luma in the Project navigator.

Select the Luma target.

Select the Signing & Capabilities tab.

Configure Automatic manage signing, Team, and Bundle Identifier, or use your specific Apple development provisioning details.

{modal="regular"}

In Xcode, select Luma from the TARGETS list, select the Signing & Capabilities tab, select the + Capability button, then select Push Notifications. This enables your app to receive push notifications.

Next, you must add a Notification Extension to the app. Go back to the General tab and select the + icon at the bottom of the TARGETS section.

You are prompted to select the template for your new target. Select Notification Service Extension then select Next.

In the next window, use NotificationExtension as the name of the extension and click the Finish button.

In Xcode, ensure that AEP Messaging is added to the list of packages in Package Dependencies. See Swift Package Manager.

Navigate to Luma > Luma > AppDelegate in the Xcode Project navigator.

Ensure AEPMessaging is part of your list of imports.

import AEPMessaging

Ensure Messaging.self is part of the array of extensions that you are registering.

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
]

Add the MobileCore.setPushIdentifier API to the func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) function.

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

This function retrieves the device token unique to the device that the app is installed on. Then sets the token for push notification delivery using the configuration that you have set up and which relies on Apple’s Push Notification service (APNs).

In the Journey Optimizer UI, select Schemas from the left rail.

Select Browse in the tab bar.

Select your schema, for example Luma Mobile App Event Schema to open it.

In the Schema editor:

1. Select the eventType field.
2. In the Field properties pane, scroll down to see the list of possible values for event type. Select Add row, and add application.test as the VALUE and Test event for push notification as the DISPLAY NAME.
3. Select Apply.
4. Select Save.
   

In the Journey Optimizer UI, select Configurations from the left rail.

In the Dashboard screen, select the Manage button in the Events tile.

In the Events screen, select Create Event.

In the Edit event event1 pane:

1. Enter LumaTestEvent as the Name of the event.

2. Provide a Description, for example Test event to trigger push notifications in Luma app.

3. Select the mobile app experience event schema that you created earlier in Create an XDM schema from the Schema list, for example Luma Mobile App Event Schema v.1.

4. Select next to the Fields list.

   

   In the Fields dialog, ensure that the following fields are selected (on top of the default fields that are always selected (_id, id, and timestamp)). You can toggle, using the dropdown list, between Selected, All and Primary or use the field.

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

   

   Then select Ok.

5. Select next to the Event id condition field.

   1. In the Add an event id condition dialog, drag and drop Event Type (eventType) on to Drag and drop an element here.
   2. In the popover, scroll to the bottom and select application.test (which is the event type you added earlier to the list of event types as part of Update your schema). Then scroll up to the top and select Ok.
   3. Select Ok to save the condition.
      

6. Select ECID (ECID) from the Namespace list. Automatically the Profile identifier field is populated with The id of the first element of the key ECID for the map identityMap.

7. Select Save.
   

In the Journey Optimizer UI, select Journeys from the left rail.

Select Create Journey.

In the Journey Properties panel:

1. Enter a Name for the journey, for example Luma - Test Push Notification Journey.
2. Enter a Description for the journey, for example Journey for test push notifications in Luma mobile app.
3. Ensure Allow re-entrance is selected and set Re-entrance wait period to 30 Seconds.
4. Select Ok.
   

Back at the journey canvas, from the EVENTS, drag and drop your LumaTestEvent on the canvas where it shows Select an entry event or a read audience activity.

• In the Events: LumaTestEvent panel, enter a Label, for example Luma Test Event.

From the ACTIONS dropdown, drag and drop Push on the appearing to the right of your LumaTestEvent activity. In the Actions: Push pane:

1. Provide a Label, for example Luma Test Push Notification, provide a Description, for example Test push notification for Luma mobile app, select Transactional from the Category list and select Luma from the Push surface.

2. Select Edit content to start editing the actual push notification.
   

   In the Push Notification editor:

   1. Enter a Title, for example Luma Test Push Notification and enter a Body, for example Test push notification for Luma mobile app.
   2. Optionally, you can enter a link to an image (.png or .jpg) in Add media. If you do so, the image will be part of the push notification.
   3. To save and leave the editor, select .
      

3. To save and finish the push notification definition, select Ok.

Your journey should look like below. Select Publish to publish and activate your journey.

Navigate to Luma > Luma > Model > XDM > TestPushPayload in the Xcode Project navigator and inspect the code.

import Foundation

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

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

The code is a representation of the following simple payload that you are going to send to trigger your test push notification journey

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

Navigate to Luma > Luma > Utils > MobileSDK in the Xcode Project navigator and add the following code to 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() ?? [:]
    )
}

This code creates a testPushPayload instance using the parameters provided to the function (applicationId and eventType) and then calls sendExperienceEvent while converting the payload to a dictionary. This code, this time, also takes the asynchronous aspects of calling the Adobe Experience Platform SDK into account by using Swift’s concurrency model based on await and async.

Navigate to Luma > Luma > Views > General > ConfigView in the Xcode Project navigator. In the Push Notification Button definition, add the following code to send the test push notification experience event payload to trigger your journey whenever that button is tapped.

// 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 and run the app in the simulator or on a physical device from Xcode, using .

Go to the Settings tab.

Tap Push Notification. You see the push notification appear in your app.

{width="300/"}