配置推送通知渠道 push-notification-configuration
要使用Adobe Campaign发送推送通知,您必须首先配置环境和应用程序,如本页所述。 在Adobe Campaign中,发送推送通知的渠道是移动设备应用程序渠道。
在开始使用Adobe Campaign发送推送通知之前,您需要确保移动应用程序和Adobe Experience Platform中的标记已具有配置和集成。 Adobe Experience Platform Mobile SDK通过与Android和iOS兼容的SDK,为您的移动设备提供客户端集成API。
要使用Adobe Experience Platform Mobile SDK设置应用程序,请执行以下步骤:
- 检查先决条件。
- 在Adobe Experience Platform数据收集中设置移动标记属性。
- 在此页面🔗中获取详细的Adobe Experience Platform Mobile SDK 。
- (可选)启用日志记录和生命周期量度,如本页🔗中的详细所示。
- (可选)将Adobe Experience Platform保障添加到应用程序以验证您的实施。 在此页面🔗中了解如何实施Adobe Experience Platform保障扩展。
- 在Adobe Campaign中配置iOS和Android Mobile Services,如本页所述。
- 在移动资产中安装和配置Adobe Campaign扩展。
- 按照Adobe Experience Platform Mobile SDK文档中的说明在您的应用程序中设置Adobe Experience Platform Mobile SDK。
先决条件 before-starting
设置权限 setup-permissions
在创建移动应用程序之前,您首先需要确保拥有或分配适用于Adobe Experience Platform中的标记的正确用户权限。 Adobe Experience Platform中标记的用户权限通过Adobe Admin Console分配给用户。 请参阅标记文档以了解详情。
要分配 属性 和 公司 权限,请执行以下步骤:
-
访问 Admin Console。
-
从 Products 选项卡中,选择 Adobe Experience Platform Data Collection 卡片。
-
选择现有 Product Profile 或使用 New profile 按钮创建新按钮。 在Admin Console文档中了解如何创建新的 New profile。
-
在 Permissions 选项卡中,选择 Property Rights。
-
单击 Add all。这会将以下权限添加到您的产品配置文件:
- Approve
- Develop
- Edit Property
- Manage Environments
- Manage Extensions
- Publish
在 Adobe Experience Platform Mobile SDK 中安装和发布Adobe Campaign扩展以及发布应用程序属性时需要这些权限。
-
然后,在左侧菜单中选择 Company rights。
-
添加以下权限:
- Manage App Configurations
- Manage Properties
移动设备应用程序开发人员需要这些权限才能在 Adobe Experience Platform数据收集 中设置推送凭据。
-
单击 Save。
要将此 Product profile 分配给用户,请执行以下步骤:
-
访问 Admin Console。
-
从 Products 选项卡中,选择 Adobe Experience Platform Data Collection 卡片。
-
选择您之前配置的 Product profile。
-
在选项卡 Users 中,单击 Add user。
-
键入用户名或电子邮件地址,然后选择用户。 然后,单击 Save。
note note NOTE 如果以前未在Admin Console中创建过该用户,请参阅添加用户文档。
配置您的应用程序 configure-app
技术设置涉及应用程序开发人员和业务管理员之间的密切合作。 在使用Adobe Campaign开始发送推送通知之前,您需要在Adobe Experience Platform Data Collection中定义设置,并将移动应用程序与Adobe Experience Platform Mobile SDK集成。
请按照以下链接中详述的实施步骤操作:
在Adobe Experience Platform数据收集中设置移动标记属性 launch-property
设置移动资产可允许移动应用程序开发人员或营销人员配置移动SDK。 通常,您将为要管理的每个移动应用程序创建一个移动资产。 请参阅Adobe Experience Platform Mobile SDK文档以了解如何创建和配置移动属性。
在Adobe Experience Platform文档中了解有关Adobe Experience Platform Data Collection标记的更多信息。
创建后,打开新的标记属性并创建库。 操作步骤:
- 在左侧导航中浏览到 发布流 并选择 添加库。
- 输入库名称并选择环境。
- 选择 添加所有更改的资源 和 保存并生成到开发。
- 最后,通过 选择工作库 按钮将此库设置为工作库。
在Campaign中配置移动服务 push-service
在Adobe Experience Platform Data Collection中设置您的移动应用后,您需要创建两个服务(一个用于iOS设备,一个用于Android设备)才能从 Adobe Campaign 发送推送通知。
推送通知通过专用服务发送给您的应用程序用户。 用户安装您的应用程序后,会订阅此服务:Adobe Campaign依赖此服务仅定向应用程序的订阅者。 在此服务中,您需要添加要在iOS和Android设备上发送的iOS和Android应用程序。
要创建服务以发送推送通知,请执行以下步骤:
-
浏览到 Profiles and Targets > Services and Subscriptions 选项卡,然后单击 Create。
{width="800"}
-
输入 Label 和 Internal name,然后选择 Mobile application 类型。
note note NOTE 默认 Subscriber applications (nms:appSubscriptionRcp) 目标映射已链接到收件人表。 如果要使用其他目标映射,则需要创建一个新的目标映射,并在服务的 Target mapping 字段中输入该映射。 在此页面中了解有关目标映射的详细信息。 -
然后,使用右侧的 Add 图标定义使用此服务的移动应用程序。
要为iOS设备创建应用程序,请执行以下步骤:
-
选择 Create an iOS application 并单击 Next。
{width="600"}
-
在 Label 字段中输入应用程序的名称。
-
(可选)您可以使用大约 Application variables 扩充推送消息内容。 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。
在以下示例中,添加 mediaURl 和 mediaExt 变量以创建富推送通知,然后为应用程序提供要在通知中显示的图像。
{width="600"}
-
浏览到 Subscription parameters 选项卡以定义扩展为 Subscriber applications (nms:appsubscriptionRcp) 架构的映射。
-
浏览到 Sounds 选项卡以定义要播放的声音。 单击 Add 并填写 Internal name 字段,该字段必须包含嵌入在应用程序中的文件的名称或系统声音的名称。
-
单击 Next 开始配置开发应用程序。
-
集成键特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign。
确保通过SDK在Adobe Campaign和应用程序代码中定义相同的 Integration key。
请参阅开发人员文档以了解详情
note note NOTE Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。 您不能对应用程序的开发版本(沙盒)和生产版本使用相同的证书。 -
从 Application icon 字段中选择图标以个性化服务中的移动应用程序。
-
选择 Authentication mode。提供了两种模式:
-
(推荐) Token-based authentication:填写APNs连接设置 Key Id、Team Id 和 Bundle Id,然后单击 Enter the private key… 选择您的p8证书。 有关 Token-based authentication 的详细信息,请参阅Apple文档。
-
Certificate-based authentication:单击 Enter the certificate…,然后选择p12密钥并输入移动应用程序开发人员提供的密码。 请注意,此证书附带到期日期,必须每年续订。 为避免用户的服务中断,请在证书过期前更新证书。 证书的有效期为一年,您必须对其进行更新才能继续与APN进行通信。
-
-
使用 Test the connection 按钮验证您的配置。
-
单击 Next 开始配置生产应用程序,并遵循上面详述的相同步骤。
-
单击 Finish。
您的iOS应用程序现在已准备好在Campaign中使用。
要为Android设备创建应用程序,请执行以下步骤:
-
选择 Create an Android application 并单击 Next。
{width="600"}
-
在 Label 字段中输入应用程序的名称。
-
集成键特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign。
确保通过SDK在Adobe Campaign和应用程序代码中定义相同的 Integration key。
请参阅开发人员文档以了解详情
note note NOTE Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。 -
从 Application icon 字段中选择图标以个性化服务中的移动应用程序。
-
在 API version 下拉列表中选择 HTTP v1。
-
单击 Load project json file to extract project details… 链接以加载您的JSON密钥文件。 有关如何提取JSON文件的更多信息,请参阅Google Firebase文档。
您还可以手动输入以下详细信息:
- Project Id
- Private Key
- Client Email
-
使用 Test the connection 按钮验证您的配置。
note caution CAUTION Test connection 按钮不检查MID服务器是否有权访问FCM服务器。 -
(可选)如果需要,您可以使用大约 Application variables 扩充推送消息内容。 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。
-
单击 Finish,然后单击 Save。 您的Android应用程序现在已准备好在Campaign中使用。
以下是FCM有效负荷名称,用于进一步个性化您的推送通知:
table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center | ||
---|---|---|
消息类型 | 可配置消息元素(FCM有效负荷名称) | 可配置选项(FCM有效负荷名称) |
数据消息 | N/A | validate_only |
通知消息 | title,正文, android_channel_id,图标,声音,标记,颜色,点击操作,图像,滚动条,粘性,可见性,通知优先级,通知计数 | validate_only |
在移动资产中配置Adobe Campaign扩展 configure-extension
适用于Adobe Experience Platform Mobile SDK的 Adobe Campaign Classic扩展 可为您的移动应用程序提供推送通知,并帮助您收集用户推送令牌和管理与Adobe Experience Platform服务的交互测量。
此扩展同时适用于Campaign Classicv7和Campaign v8,已在您的环境中预安装,必须进行配置。 要为移动标记资产配置扩展,请执行以下步骤:
- 打开您之前创建的标记属性。
- 从左侧导航中,浏览到 扩展,然后打开 目录 选项卡。 使用搜索字段查找 Adobe Campaign Classic 扩展。
- 从Campaign Classic卡中,单击 安装 按钮。
- 按照Adobe Experience Platform Mobile SDK文档中的说明输入设置。
您现在可以将Campaign添加到您的应用程序,如Adobe Experience Platform Mobile SDK文档中所述。