创建和发送推送通知

最近更新： 2025年5月5日

主题：
推送

创建对象：

初学者
中级
开发人员

了解如何使用Experience Platform Mobile SDK和Journey Optimizer为移动应用程序创建推送通知。

Journey Optimizer允许您创建历程并向目标受众发送消息。在使用Journey Optimizer发送推送通知之前，您必须确保已进行适当的配置和集成。要了解Journey Optimizer中的推送通知数据流，请参阅文档。

注意

本课程是可选的，仅适用于希望发送推送通知的Journey Optimizer用户。

先决条件

在安装和配置SDK的情况下成功构建并运行应用程序。
为Adobe Experience Platform设置应用程序。
访问Journey Optimizer和足够的权限，如此处所述。此外，您需要具有足够的权限才能使用以下Journey Optimizer功能。
- 创建推送凭据。
- 创建推送渠道配置。
- 创建旅程。
- 创建消息。
- 创建消息预设。
付费Apple开发人员帐户 具有创建证书、标识符和密钥的足够访问权限。
用于测试的物理iOS设备或模拟器。

学习目标

在本课程中，您将执行以下操作

向Apple推送通知服务(APN)注册应用程序ID。
在Journey Optimizer中创建渠道配置。
更新您的架构以包含推送消息字段。
安装和配置Journey Optimizer标记扩展。
更新您的应用程序以注册Journey Optimizer标记扩展。
验证Assurance中的设置。
从Assurance发送测试消息
在Journey Optimizer中定义您自己的推送通知事件、历程和体验。
从应用程序内发送您自己的推送通知。

设置

小贴士

如果您已将环境设置为Journey Optimizer应用程序内消息传送课程的一部分，则您可能已执行了此设置部分中的某些步骤。

向APN注册应用程序ID

以下步骤并非特定于Adobe Experience Cloud，而是旨在引导您完成APN配置。

创建私钥

在Apple开发人员门户中，导航到密钥。
要创建密钥，请选择 +。
提供 密钥名称。
选中 Apple推送通知服务 (APN) 复选框。
选择继续。
查看配置并选择注册。
下载.p8私钥。当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。
记下 密钥ID。当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。
记下 团队ID。当您配置Journey Optimizer推送凭据时，将在下一个练习中使用它。

其他文档可在此处找到。

在Journey Optimizer中添加应用程序推送凭据

接下来，您需要在Journey Optimizer中添加移动应用程序推送凭据。（在该产品的早期版本中，这些组件作为数据收集中“应用程序表面”配置的一部分添加）。

需要移动设备应用程序推送凭据注册，才能授权Adobe代表您发送推送通知。请参阅下面详述的步骤：

在Journey Optimizer界面中，打开渠道 > 推送设置 > 推送凭据 菜单。
选择 创建推送凭据。
从平台下拉列表中，选择 iOS 操作系统。
在 应用程序ID (iOS捆绑包ID)字段中输入移动应用程序捆绑包ID。例如，com.adobe.luma.tutorial.swiftui
启用 应用到所有沙盒 选项以使这些推送凭据在所有沙盒中可用。如果特定沙盒对于同一平台和应用程序ID对拥有自己的凭据，则这些特定于沙盒的凭据将优先。
拖放您在上一个练习中获得的.p8 Apple推送通知身份验证密钥 文件。
提供 密钥ID，在创建p8身份验证密钥期间分配的10字符字符串。可在Apple开发人员门户页面的 证书、标识符和配置文件 页面的密钥选项卡下找到它。（您在上一个练习中应该已经注意到。）
提供 团队ID。团队ID是一个值，可以在 成员资格 选项卡下方或Apple开发人员门户页面顶部找到。（您在上一个练习中应该已经注意到。）

Journey Optimizer中的
单击提交以创建推送凭据配置。

在Journey Optimizer中创建推送的渠道配置

创建推送凭据配置后，必须创建配置才能从Journey Optimizer发送推送通知。

在Journey Optimizer界面中，打开渠道 > 常规设置 > 渠道配置 菜单，然后选择 创建渠道配置。
输入配置的名称和说明（可选）。

注意
名称必须以字母(A-Z)开头。它只能包含字母数字字符。您还可以使用下划线 _、点 . 和连字符 - 符号。
要为配置分配自定义或核心数据使用标签，您可以选择 管理访问权限。了解有关对象级访问控制(OLAC)的更多信息。
选择推送渠道。
选择 营销操作 以使用此配置将同意策略关联到消息。所有与营销活动相关的同意政策均可利用，以尊重客户的偏好。了解有关营销操作的更多信息。
选择您的平台。
选择与上述配置的推送凭据相同的 应用程序ID。
选择提交以保存更改。

更新数据流配置

要确保将从您的移动应用程序发送到Edge Network的数据转发到Journey Optimizer，请更新您的Experience Edge配置。

在数据收集UI中，选择 数据流，然后选择您的数据流，例如 Luma Mobile App。
为 Experience Platform 选择，然后从上下文菜单中选择编辑。
在 数据流 > > Adobe Experience Platform 屏幕中：
1. 如果尚未选择，请从 配置文件数据集 中选择 AJO推送配置文件数据集。使用MobileCore.setPushIdentifier API调用（请参阅注册推送通知的设备令牌）时需要此配置文件数据集，以确保将推送通知的唯一标识符（即推送标识符）存储为用户配置文件的一部分。
2. 已选择 Adobe Journey Optimizer。有关详细信息，请参阅Adobe Experience Platform设置。
3. 要保存数据流配置，请选择保存。

安装Journey Optimizer标记扩展

要使您的应用程序能够与Journey Optimizer配合使用，必须更新标记属性。

导航到标记 > 扩展 > 目录，
打开您的属性，例如 Luma Mobile App Tutorial。
选择目录。
搜索 Adobe Journey Optimizer 扩展。
安装扩展。
在 安装扩展 对话框中
1. 选择一个环境，例如开发。
2. 从 事件数据集 列表中选择 AJO推送跟踪体验事件数据集 数据集。
3. 选择 保存到库并生成。

注意

如果您未看到 AJO推送跟踪体验事件数据集 作为一个选项，请联系客户关怀团队。

使用Assurance验证设置

查看设置说明部分以将模拟器或设备连接到Assurance。
在Assurance用户界面中，选择配置。
选择 推送调试 旁边的。
选择保存。
从左侧导航中选择 推送调试。
选择 验证设置 选项卡。
从 客户端 列表中选择您的设备。
确认您没有收到任何错误。
选择 发送测试推送 选项卡。
（可选）更改标题和正文的默认详细信息
选择 发送测试推送通知。
检查 测试结果。
您应会看到测试推送通知显示在应用程序中。

签名

发送推送通知需要对Luma应用进行签名，需要付费Apple开发人员帐户。

要更新应用程序的签名，请执行以下操作：

在Xcode中转到您的应用程序。
在项目导航器中选择 Luma。
选择 Luma 目标。
选择 签名和功能 选项卡。
配置 自动管理签名、团队和 捆绑包标识符，或者使用您的特定Apple开发配置详细信息。

重要
请确保使用_唯一_捆绑标识符并替换com.adobe.luma.tutorial.swiftui捆绑标识符，因为每个捆绑标识符必须是唯一的。通常，您使用反向DNS格式来打包的ID字符串，如com.organization.brand.uniqueidentifier。例如，本教程的完成版本使用com.adobe.luma.tutorial.swiftui。

向应用程序添加推送通知功能

重要

要在iOS应用程序中实施和测试推送通知，您必须拥有付费 Apple开发人员帐户。如果您没有付费Apple开发人员帐户，则可以跳过本课程的剩余部分。

在Xcode中，从 TARGETS 列表中选择 Luma，选择 签名和功能 选项卡，选择 +功能 按钮，然后选择 推送通知。这使您的应用程序能够接收推送通知。
接下来，您必须向应用程序添加通知扩展。返回 General 选项卡并选择目标部分底部的 + 图标。
系统将提示您为新目标选择模板。选择 通知服务扩展，然后选择 下一步。
在下一个窗口中，使用NotificationExtension作为扩展的名称，然后单击完成按钮。

现在，您应该将推送通知扩展添加到应用程序中，类似于以下屏幕。

Pusn通知扩展

在应用程序中实施Journey Optimizer

如前面的课程中所述，安装移动标记扩展仅提供配置。接下来，您必须安装并注册消息传送SDK。如果未清除这些步骤，请查看安装SDK部分。

注意

如果您已完成安装SDK部分，则表明已安装SDK，您可以跳过此步骤。

在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)的配置来设置推送通知投放令牌。

IMPORTANT

MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true])确定推送通知是使用APNs沙盒还是生产服务器来发送推送通知。在模拟器中或在设备上测试您的应用程序时，请确保messaging.useSandbox设置为true，以便您接收推送通知。在使用Apple的Testflight部署应用程序以进行生产测试时，请确保将messaging.useSandbox设置为false，否则生产应用程序将无法接收推送通知。

创建自己的推送通知

要创建自己的推送通知，您必须在Journey Optimizer中定义一个事件，以触发负责发送推送通知的历程。

更新您的架构

您即将定义一个新的事件类型，该类型还不能作为您在架构中定义的事件列表的一部分使用。您稍后在触发推送通知时使用此事件类型。

在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中的事件允许您统一触发历程以发送消息，例如推送通知。有关详细信息，请参阅关于事件。

在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. 选择保存。

您刚刚创建了一个事件配置，该配置基于您之前在本教程中创建的“移动应用程序体验事件”架构。此事件配置将使用您的特定事件类型(application.test)筛选传入的体验事件，因此，只有从该移动应用程序发起的特定类型的事件才会触发您在下一步中构建的历程。在现实场景中，您可能希望从外部服务发送推送通知，但可以应用相同的概念：从外部应用程序将体验事件发送到Experience Platform，该事件具有可用于在这些事件触发历程之前应用条件的特定字段。

创建历程

您的下一步是创建在收到相应的事件时触发推送通知发送的历程。

在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. 要保存并完成推送通知定义，请选择确定。
您的历程应如下所示。选择发布以发布并激活您的历程。

触发推送通知

您已具备发送推送通知的所有要素。剩下的问题是如何触发此推送通知。实质上，它与您之前看到的相同：只需发送具有适当有效负载的体验事件（如Events中的）。

此时，您即将发送的体验事件未构建为简单的XDM词典。您即将使用表示推送通知有效负载的struct。定义专用数据类型是如何在应用程序中实施构建体验事件有效负载的替代方法。

在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的物理设备上重建并运行应用程序。
转到设置选项卡。
点按 推送通知。您会看到推送通知显示在应用程序中。

后续步骤

现在，您应该拥有在应用程序中处理推送通知的所有工具。例如，您可以在Journey Optimizer中构建一个历程，当应用程序用户登录时，该历程会发送欢迎推送通知。或确认推送通知（当用户在该应用程序中购买产品时）。或输入位置的地理围栏（如您在位置课程中所见）。

SUCCESS

现在，您已使用适用于Experience Platform Mobile SDK的Journey Optimizer和Journey Optimizer扩展为推送通知启用应用程序。

感谢您投入时间学习Adobe Experience Platform Mobile SDK。如果您有任何疑问、希望分享一般反馈或有关于未来内容的建议，请在此Experience League社区讨论帖子上分享这些内容。

下一步： 创建并发送应用程序内消息

recommendation-more-help