创建和发送推送通知

在Apple开发人员门户中，导航到 键.

要创建键，请选择 +.

提供 密钥名称.

选择 Apple推送通知服务 (APNs) 复选框。

选择​ 继续。

查看配置并选择 注册.

下载 .p8 私钥。 在本课程的后面部分，它将在“应用程序表面”配置中使用。

记下 密钥ID. 它用在应用程序表面配置中。

记下 团队编号. 它用在应用程序表面配置中。

从 数据收集界面，选择 应用程序表面 在左侧面板中。

要创建配置，请选择 创建应用程序表面.

输入 名称 例如，对于配置 Luma App Tutorial .

从 移动应用程序配置，选择 Apple iOS.

在中输入移动应用程序捆绑包ID 应用程序ID(iOS捆绑包ID) 字段。 例如， com.adobe.luma.tutorial.swiftui.

打开 推送凭据 切换以添加您的凭据。

拖放 .p8 Apple推送通知身份验证密钥 文件。

提供 密钥ID，在创建期间分配的10个字符的字符串 p8 身份验证密钥。 它可以在以下位置找到 键 选项卡 证书、标识符和配置文件 Apple开发人员门户页面的页面。 另请参阅 创建私钥.

提供 团队编号. “团队ID”是一个值，该值可在下找到 会员资格 选项卡或Apple开发人员门户页面顶部的。 另请参阅 创建私钥.

选择​ 保存。

在数据收集UI中，选择 数据流，并选择您的数据流，例如 Luma Mobile App.

选择 对象 Experience Platform 并选择 编辑 从上下文菜单中。

在 数据流 > > Adobe Experience Platform 屏幕：

1. 如果尚未选择，请选择 AJO推送配置文件数据集 从 配置文件数据集. 使用时需要此用户档案数据集 MobileCore.setPushIdentifier API调用(请参阅 注册推送通知的设备令牌)确保将推送通知的唯一标识符（即推送标识符）存储为用户配置文件的一部分。

2. Adobe Journey Optimizer 已选中。 请参阅 Adobe Experience Platform设置 以了解更多信息。

3. 要保存数据流配置，请选择 保存.

导航到 标记 > 扩展 > 目录，

打开您的资产，例如 Luma Mobile App Tutorial.

选择 目录.

搜索 Adobe Journey Optimizer 扩展。

安装扩展。

在 安装扩展 对话框

1. 选择环境，例如 开发.

2. 选择 AJO推送跟踪体验事件数据集 来自的数据集 事件数据集 列表。

3. 选择 保存到库并生成.

   

查看 设置说明 部分以将模拟器或设备连接到Assurance。

在Assurance UI中，选择 配置.

选择 旁边 推送调试.

选择​ 保存。

选择 推送调试 从左侧导航栏中。

选择 验证设置 选项卡。

从中选择设备 客户端 列表。

确认您没有收到任何错误。

选择 发送测试推送 选项卡。

（可选）更改的默认详细信息 标题 和 正文

选择 发送测试推送通知.

查看 测试结果.

您应会看到测试推送通知显示在应用程序中。

{width="300"}

在Xcode中转到您的应用程序。

选择 Luma 在项目导航器中。

选择 Luma 目标。

选择 签名和功能 选项卡。

配置 自动管理签名， 团队、和 捆绑标识符，或使用您的特定Apple开发配置详细信息。

{modal="regular"}

在Xcode中，选择 Luma 从 目标 列表，选择 签名和功能 选项卡，选择 +功能 按钮，然后选择 推送通知. 这使您的应用程序能够接收推送通知。

接下来，您必须向应用程序添加通知扩展。 返回 General 选项卡，然后选择 + 图标底部的 目标 部分。

系统将提示您为新目标选择模板。 选择 通知服务扩展 然后选择 下一个.

在下一个窗口中，使用 NotificationExtension 作为扩展的名称，然后单击 完成 按钮。

在Xcode中，确保 AEP消息 会添加到包依赖关系中的包列表中。 请参阅 Swift包管理器.

导航到 Luma > Luma > AppDelegate 在Xcode项目导航器中。

确保 AEPMessaging 是导入列表的一部分。

import AEPMessaging

确保 Messaging.self 是您注册的扩展数组的一部分。

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
]

添加 MobileCore.setPushIdentifier 的API func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) 函数。

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

此函数检索与安装应用程序的设备特有的设备令牌。 然后，使用您设置的依赖于Apple推送通知服务(APN)的配置来设置推送通知投放令牌。

在Journey Optimizer UI中，选择 架构 从左边栏开始。

选择 浏览 在选项卡栏中。

选择您的架构，例如 Luma Mobile App Event Schema 打开它。

在架构编辑器中：

1. 选择 事件类型 字段。

2. 在 字段属性 窗格，向下滚动以查看事件类型可能值的列表。 选择 添加行，并添加 application.test 作为 值 和 Test event for push notification 作为 DISPLAY NAME.

3. 选择​ 应用。

4. 选择​ 保存。

   

在Journey Optimizer UI中，选择 配置 从左边栏开始。

在 仪表板 屏幕上，选择 管理 中的按钮 活动 磁贴。

在 活动 屏幕，选择 创建事件.

在 编辑事件event1 窗格：

1. 输入 LumaTestEvent 作为 名称 事件的。

2. 提供 描述 ​例如 Test event to trigger push notifications in Luma app.

3. 选择您之前在中创建的移动应用程序体验事件架构 创建XDM架构 从 架构 列表，例如 Luma Mobile App Event Schema v.1.

4. 选择 旁边的 字段 列表。

   

   在 字段 对话框，请确保选择以下字段(位于始终选择的默认字段之上(_id， id、和 时间戳)。 您可以使用下拉列表在 已选择， 全部 和 主要 或使用 字段。

   • 已识别应用程序(ID)，
   • 事件类型(eventType)，
   • 主要（主要）.

   

   然后选择 确定.

5. 选择 旁边的 事件ID条件 字段。

   1. 在 添加事件ID条件 对话框，拖放 事件类型(eventType) 到 将元素拖放到此处.

   2. 在弹出窗口中，滚动到底部并选择 application.test （这是您之前作为的一部分添加到事件类型列表中的事件类型） 更新您的架构)。 然后向上滚动到顶部并选择 确定.

   3. 选择 确定 以保存条件。

      

6. 选择 ECID (ECID) 从 命名空间 列表。 自动 配置文件标识符 字段填充有 映射identityMap的键ECID的第一个元素的id.

7. 选择​ 保存。

   

在Journey Optimizer UI中，选择 历程 从左边栏开始。

选择 创建历程.

在 历程属性 面板：

1. 输入 名称 例如，对于历程 Luma - Test Push Notification Journey.

2. 输入 描述 例如，对于历程 Journey for test push notifications in Luma mobile app.

3. 确保 允许重新进入 已选定并设置 重新进入等待期 到 30 秒.

4. 选择 确定.

   

返回历程画布，从 活动，拖放 LumaTestEvent 在画布上显示 选择进入事件或读取受众活动.

• 在 事件：LumaTestEvent 面板，输入 标签 ​例如 Luma Test Event.

从 操作 下拉列表，拖放 推送 在 出现在您的右侧 LumaTestEvent 活动。 在 操作：推送 窗格：

1. 提供 标签 ​例如 Luma Test Push Notification，提供 描述 ​例如 Test push notification for Luma mobile app，选择 事务性 从 类别 列出并选择 Luma 从 推送表面.

2. 选择 编辑内容 以开始编辑实际的推送通知。

   

   在 推送通知 编辑者：

   1. 输入 标题 ​例如 Luma Test Push Notification 并输入 正文 ​例如 Test push notification for Luma mobile app.

   2. 或者，您也可以在中输入指向图像(.png或.jpg)的链接 添加媒体. 如果这样做，图像将成为推送通知的一部分。

   3. 要保存并退出编辑器，请选择 .

      

3. 要保存并完成推送通知定义，请选择 确定.

您的历程应如下所示。 选择 Publish 发布并激活您的历程。

导航到 Luma > Luma > 模型 > XDM > TestPushPayload 在Xcode项目导航器中检查代码。

import Foundation

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

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

该代码表示您要发送的用于触发测试推送通知历程的以下简单有效负载

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

导航到 Luma > Luma > Utils > MobileSDK 在Xcode项目导航器中，将以下代码添加到 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() ?? [:]
    )
}

此代码将创建 testPushPayload 实例来使用提供给函数的参数(applicationId 和 eventType)，然后调用 sendExperienceEvent 将有效负载转换为词典时。 Adobe Experience Platform这一次，该代码还通过使用基于 await 和 async.

导航到 Luma > Luma > Views > General > 配置视图 在Xcode项目导航器中。 在推送通知按钮定义中，添加以下代码以发送测试推送通知体验事件有效负载，以便在点击该按钮时触发您的历程。

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

在模拟器中或在Xcode的物理设备上重建并运行应用程序，使用 .

转到 设置 选项卡。

点按 推送通知. 您会看到推送通知显示在应用程序中。

{width="300"}