创建和发送推送通知

在Apple开发人员门户中，导航到​ 密钥。

要创建密钥，请选择​ +。

提供​ 密钥名称。

选中​ Apple推送通知服务 (APN) ​复选框。

选择​ 继续。

查看配置并选择​ 注册。

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

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

记下​ 团队ID。 它用在应用程序表面配置中。

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

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

输入配置的​ 名称，例如Luma App Tutorial。

从​ 移动设备应用程序配置 ​中，选择​ Apple iOS。

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

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

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

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

提供​ 团队ID。 团队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中，从​ TARGETS ​列表中选择​ Luma，选择​ 签名和功能 ​选项卡，选择​ +功能 ​按钮，然后选择​ 推送通知。 这使您的应用程序能够接收推送通知。

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

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

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

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

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

确保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. 选择​ eventType ​字段。

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

3. 选择​ 应用。

4. 选择​ 保存。

   

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

在​ 仪表板 ​屏幕中，选择​ 事件 ​拼贴中的​ 管理 ​按钮。

在​ 事件 ​屏幕中，选择​ 创建事件。

在​ 编辑事件event1 ​窗格中：

1. 输入LumaTestEvent作为事件的​ Name。

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

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

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

   

   在​ 字段 ​对话框中，确保选择以下字段(位于始终选择的默认字段之上（_id、id ​和​ 时间戳）。 您可以使用下拉列表在​ Selected、All ​和​ Primary ​之间切换，或者使用 字段。

   • 已识别应用程序(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. 选择​ 确定。

   

返回历程画布，从​ EVENTS，将 LumaTestEvent ​拖放到画布上，其中显示​ 选择一个进入事件或读取受众活动。

• 在​ Events： LumaTestEvent ​面板中，输入​ 标签，例如Luma Test Event。

从​ ACTIONS ​下拉列表中，将 推送 ​拖放到显示于​ 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 ​以发布并激活您的历程。

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

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
   ]
}

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

此代码使用提供给函数（applicationId和eventType）的参数创建一个testPushPayload实例，然后在将有效负载转换为字典时调用sendExperienceEvent。 此代码，这次还通过使用基于await和async的Swift并发模型，考虑到调用Adobe Experience Platform SDK的异步方面。

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

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