配置推送通知渠道

上次更新: 2023-11-02
  • 主题:
  • Push
    查看有关此主题的更多信息
  • 创建对象:
  • Intermediate
    Admin
    Developer

在开始使用Adobe Campaign发送推送通知之前,您需要确保移动应用程序和Adobe Experience Platform中的标记已具有配置和集成。

Adobe Experience Platform Mobile SDK通过与Android和iOS兼容的SDK为您的移动设备提供客户端集成API。

要使用Adobe Experience Platform Mobile SDK设置应用程序,请执行以下步骤:

  1. Check 先决条件.
  2. 设置 移动标记属性 在Adobe Experience Platform数据收集中。
  3. 获取详细的Adobe Experience Platform Mobile SDK 本页内容.
  4. (可选)启用日志记录和生命周期量度(如详述) 本页内容.
  5. (可选)添加 应用程序的Adobe Experience Platform保证 to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. 在Adobe Campaign中配置iOS和Android Mobile Services(如详细信息) 本页内容.
  7. 安装和配置 Adobe Campaign扩展 (在移动资产中)。
  8. 关注 Adobe Experience Platform移动SDK文档 ,以在您的应用程序中设置Adobe Experience Platform Mobile SDK。

先决条件

设置权限

在创建移动应用程序之前,您首先需要确保拥有或分配适用于Adobe Experience Platform中的标记的正确用户权限。 Adobe Experience Platform中标记的用户权限通过Adobe Admin Console分配给用户。 了解详情,请参阅 标记文档.

注意

推送配置必须由专家用户执行。 根据您的实施模型和此实施中涉及的角色,您可能需要将整套权限分配给单个产品配置文件,或在应用程序开发人员与 Adobe Campaign 管理员。

要分配 属性公司 权限,请执行以下步骤:

  1. 访问 Admin Console.

  2. Products 选项卡,选择 Adobe Experience Platform Data Collection 卡片。

  3. 选择现有 Product Profile 或使用 New profile 按钮。 了解如何新建 New profileAdmin console文档.

  4. Permissions 选项卡中,选择 Property Rights

  5. 单击 Add all。这会将以下权限添加到您的产品配置文件:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    安装和发布Adobe Campaign扩展以及在中发布应用程序属性需要这些权限 Adobe Experience Platform移动SDK.

  6. 然后,选择 Company rights 在左侧菜单中。

  7. 添加以下权限:

    • Manage App Configurations
    • Manage Properties

    移动设备应用程序开发人员需要这些权限才能在中设置推送凭据 Adobe Experience Platform数据收集.

  8. 单击 Save

要分配此 Product profile 对于用户,请执行以下步骤:

  1. 访问 Admin Console.

  2. Products 选项卡,选择 Adobe Experience Platform Data Collection 卡片。

  3. 选择您之前配置的 Product profile

  4. 在选项卡 Users 中,单击 Add user

  5. 键入用户名或电子邮件地址,然后选择用户。 然后,单击 Save.

    注意

    如果以前未在Admin Console中创建过该用户,请参阅 添加用户文档.

配置您的应用程序

技术设置涉及应用程序开发人员和业务管理员之间的密切合作。 开始发送推送通知之前 Adobe Campaign,您需要定义中的设置 Adobe Experience Platform Data Collection 并将您的移动应用程序与Adobe Experience Platform Mobile SDK集成。

请按照以下链接中详述的实施步骤操作:

  • 对象 Apple iOS:了解如何在中使用APN注册应用程序 Apple文档
  • 对象 Google Android:了解如何在Android上设置Firebase Cloud Messaging客户端应用程序 Google文档

在Adobe Experience Platform数据收集中设置移动标记属性

设置移动资产可允许移动应用程序开发人员或营销人员配置移动SDK。 通常,您将为要管理的每个移动应用程序创建一个移动资产。 了解如何在中创建和配置移动资产 Adobe Experience Platform移动SDK文档.

了解有关 Adobe Experience Platform Data Collection 中的标记 Adobe Experience Platform文档.

创建后,打开新的标记属性并创建库。 操作步骤:

  1. 浏览至 发布流 在左侧导航栏中选择 添加库.
  2. 输入库名称并选择环境。
  3. 选择 添加所有已更改资源、和 保存并生成以进行开发.
  4. 最后,从以下位置将此库设置为您的工作库: 选择工作库 按钮。

在Campaign中配置移动服务

在中设置您的移动设备应用程序后 Adobe Experience Platform Data Collection,您需要创建两个服务(一个用于iOS设备,一个用于Android设备)才能从中发送推送通知 Adobe Campaign.

推送通知通过专用服务发送给您的应用程序用户。 用户安装您的应用程序后,会订阅此服务:Adobe Campaign依赖此服务仅定向应用程序的订阅者。 在此服务中,您需要添加要在iOS和Android设备上发送的iOS和Android应用程序。

要创建服务以发送推送通知,请执行以下步骤:

  1. 浏览至 Profiles and Targets > Services and Subscriptions 选项卡,然后单击 Create.

  2. 输入 LabelInternal name,并选择 Mobile application 类型。

    注意

    默认 Subscriber applications (nms:appSubscriptionRcp) 目标映射已链接到收件人表。 如果要使用其他目标映射,则需要创建一个新的目标映射,并在 Target mapping 服务的字段。 要了解有关目标映射的更多信息,请参阅 此页面.

  3. 然后使用 Add 图标,以定义使用此服务的移动设备应用程序。

要为iOS设备创建应用程序,请执行以下步骤:

  1. 选择 Create an iOS application 并单击 Next

  2. 在中输入应用程序的名称 Label 字段。

  3. (可选)您可以使用某些变量扩充推送消息内容 Application variables. 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。

    在以下示例中, mediaURlmediaExt 添加变量以创建富推送通知,然后为应用程序提供要在通知中显示的图像。

  4. 浏览至 Subscription parameters 选项卡定义扩展为的映射 Subscriber applications (nms:appsubscriptionRcp) 架构。

  5. 浏览至 Sounds 制表符以定义要播放的声音。 单击 Add 和填充 Internal name 字段,其中必须包含嵌入在应用程序中的文件的名称或系统声音的名称。

  6. 单击 Next 以开始配置开发应用程序。

  7. 集成键特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign。

    确保相同 Integration key 在Adobe Campaign中以及通过SDK在应用程序代码中定义。

    了解详情,请参阅 开发人员文档

    注意

    Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。

    您不能对应用程序的开发版本(沙盒)和生产版本使用相同的证书。

  8. 从中选择图标 Application icon 字段,用于将服务中的移动应用程序个性化。

  9. 选择 Authentication mode。提供了两种模式:

    • (推荐) Token-based authentication:填写APN连接设置 Key IdTeam IdBundle Id 然后,通过单击 Enter the private key…. 有关更多详细信息 Token-based authentication,请参阅 Apple文档.

    • Certificate-based authentication:单击 Enter the certificate… 然后选择您的p12密钥并输入由移动应用程序开发人员提供的密码。

    您稍后可以在中更改您的身份验证模式 Certificate 选项卡中。

  10. 使用 Test the connection 按钮以验证您的配置。

  11. 单击 Next 以开始配置生产应用程序,并按照上面详述的相同步骤操作。

  12. 单击 Finish

您的iOS应用程序现在已准备好在Campaign中使用。

要为Android设备创建应用程序,请执行以下步骤:

  1. 选择 Create an Android application 并单击 Next

  2. 在中输入应用程序的名称 Label 字段。

  3. 集成键特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign。

    确保相同 Integration key 在Adobe Campaign中以及通过SDK在应用程序代码中定义。

    了解详情,请参阅 开发人员文档

    注意

    Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。

  4. 从中选择图标 Application icon 字段,用于将服务中的移动应用程序个性化。

  5. 选择 HTTP v1API version 下拉列表。

  6. 单击 Load project json file to extract project details… 用于加载JSON密钥文件的链接。 有关如何提取JSON文件的更多信息,请参阅 Google Firebase文档.

    您还可以手动输入以下详细信息:

    • Project Id
    • Private Key
    • Client Email
  7. 使用 Test the connection 按钮以验证您的配置。

    注意

    Test connection 按钮不检查MID服务器是否有权访问FCM服务器。

  8. (可选)您可以使用某些变量扩充推送消息内容 Application variables 如果需要。 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。

  9. 单击 Finish,然后单击 Save。您的Android应用程序现在已准备好在Campaign中使用。

以下是FCM有效负荷名称,用于进一步个性化您的推送通知:

消息类型 可配置消息元素(FCM有效负荷名称) 可配置选项(FCM有效负荷名称)
数据消息 N/A validate_only
通知消息 title,标题,正文, android_channel_id,图标,声音,标记,颜色, click_action,图像,滚动条,粘性,可见性, notification_priority,通知优先级, notification_count
validate_only

在移动资产中配置Adobe Campaign扩展

Adobe Campaign Classic扩展 for Adobe Experience Platform Mobile SDK支持移动应用程序的推送通知,并帮助您收集用户推送令牌并管理与Adobe Experience Platform服务的交互测量。

此扩展同时适用于Campaign Classicv7和Campaign v8,已在您的环境中预安装,必须进行配置。 要为移动标记资产配置扩展,请执行以下步骤:

  1. 打开您之前创建的标记属性。
  2. 从左侧导航中,浏览到 扩展,然后打开 目录 选项卡。 使用搜索字段查找 Adobe Campaign Classic 扩展。
  3. 在Campaign Classic卡中,单击 安装 按钮。
  4. 按照中的说明输入设置 Adobe Experience Platform移动SDK文档.

您现在可以将Campaign添加到应用程序,如中所述 Adobe Experience Platform移动SDK文档.

在此页面上