配置推送通知渠道 push-notification-configuration

要使用Adobe Campaign发送推送通知,您必须首先配置环境和应用程序,如本页所述。 在Adobe Campaign中,发送推送通知的渠道是移动设备应用程序渠道。

CAUTION
Android Firebase Cloud Messaging (FCM) 服务的一些重要更改将于 2024 年发布,并将影响您的 Adobe Campaign 实施。您可能需要更新 Android 推送消息的订阅服务配置,才能支持此更改。您已经可以检查并执行操作。 了解详情

在开始使用Adobe Campaign发送推送通知之前,您需要确保移动应用程序和Adobe Experience Platform中的标记已具有配置和集成。 Adobe Experience Platform Mobile SDK通过与Android和iOS兼容的SDK,为您的移动设备提供客户端集成API。

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

  1. 检查先决条件
  2. 在Adobe Experience Platform数据收集中设置移动标记属性
  3. 在此页面🔗中获取详细的Adobe Experience Platform Mobile SDK 。
  4. (可选)启用日志记录和生命周期量度,如本页🔗中的详细所示。
  5. (可选)将Adobe Experience Platform保障添加到应用程序以验证您的实施。 在此页面🔗中了解如何实施Adobe Experience Platform保障扩展。
  6. 在Adobe Campaign中配置iOS和Android Mobile Services,如本页所述。
  7. 在移动资产中安装和配置Adobe Campaign扩展
  8. 按照Adobe Experience Platform Mobile SDK文档中的说明在您的应用程序中设置Adobe Experience Platform Mobile SDK。

先决条件 before-starting

设置权限 setup-permissions

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

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

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

  1. 访问​ Admin Console

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

  3. 选择现有​ Product Profile ​或使用​ New profile ​按钮创建新按钮。 在Admin Console文档中了解如何创建新的​ New profile

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

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

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

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

  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

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

配置您的应用程序 configure-app

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

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

  • 对于​ Apple iOS:请参阅Apple文档以了解如何使用APN注册您的应用程序
  • 对于​ Google Android:请参阅Google文档以了解如何在Android上设置Firebase Cloud Messaging客户端应用程序

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

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

Adobe Experience Platform文档中了解有关Adobe Experience Platform Data Collection标记的更多信息。

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

  1. 在左侧导航中浏览到​ 发布流 ​并选择​ 添加库
  2. 输入库名称并选择环境。
  3. 选择​ 添加所有更改的资源 ​和​ 保存并生成到开发
  4. 最后,通过​ 选择工作库 ​按钮将此库设置为工作库。

在Campaign中配置移动服务 push-service

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

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

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

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

    {width="800"}

  2. 输入​ Label ​和​ Internal name,然后选择​ Mobile application ​类型。

    note note
    NOTE
    默认​ Subscriber applications (nms:appSubscriptionRcp) ​目标映射已链接到收件人表。 如果要使用其他目标映射,则需要创建一个新的目标映射,并在服务的​ Target mapping ​字段中输入该映射。 在此页面中了解有关目标映射的详细信息。
  3. 然后,使用右侧的​ Add ​图标定义使用此服务的移动应用程序。

iOS

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

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

    {width="600"}

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

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

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

    {width="600"}

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

  5. 浏览到​ Sounds ​选项卡以定义要播放的声音。 单击​ Add ​并填写​ Internal name ​字段,该字段必须包含嵌入在应用程序中的文件的名称或系统声音的名称。

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

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

    确保通过SDK在Adobe Campaign和应用程序代码中定义相同的​ Integration key

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

    note note
    NOTE
    Integration key ​可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。
    您不能对应用程序的开发版本(沙盒)和生产版本使用相同的证书。
  8. 从​ Application icon ​字段中选择图标以个性化服务中的移动应用程序。

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

    • (推荐) Token-based authentication:填写APNs连接设置​ Key IdTeam Id ​和​ Bundle Id,然后单击​ Enter the private key… ​选择您的p8证书。 有关​ Token-based authentication ​的详细信息,请参阅Apple文档

    • Certificate-based authentication:单击​ Enter the certificate…,然后选择p12密钥并输入移动应用程序开发人员提供的密码。 请注意,此证书附带到期日期,必须每年续订。 为避免用户的服务中断,请在证书过期前更新证书。 证书的有效期为一年,您必须对其进行更新才能继续与APN进行通信。

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

  11. 单击​ Next ​开始配置生产应用程序,并遵循上面详述的相同步骤。

  12. 单击 Finish

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

Android

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

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

    {width="600"}

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

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

    确保通过SDK在Adobe Campaign和应用程序代码中定义相同的​ Integration key

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

    note note
    NOTE
    Integration key ​可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。
  4. 从​ Application icon ​字段中选择图标以个性化服务中的移动应用程序。

  5. 在​ API version ​下拉列表中选择​ HTTP v1

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

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

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

    note caution
    CAUTION
    Test connection ​按钮不检查MID服务器是否有权访问FCM服务器。
  8. (可选)如果需要,您可以使用大约​ Application variables ​扩充推送消息内容。 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。

  9. 单击​ 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,已在您的环境中预安装,必须进行配置。 要为移动标记资产配置扩展,请执行以下步骤:

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

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

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b