文档CampaignCampaign v8 文档

[有限发布版]{class="badge informative"}

已修订推送通知配置 push-notifications-config

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 中级
  • 开发人员

Campaign v8.5引入了我们最新的推送通知服务，该服务由基于现代尖端技术构建的强大框架提供支持。 此服务旨在解锁更高级别的可扩展性，确保您的通知能够以无缝效率接触到更多受众。 通过我们增强的基础架构和优化的流程，您可以期待更高的扩展性和可靠性，使您能够以前所未有的方式吸引移动应用程序用户并与之建立联系。

AVAILABILITY
从Campaign v8.5开始，新客户可专门访问此功能，并会逐步向一组选定的客户推出。 如果您的环境是在2023年6月之前配置的，则此页面不适用于您，您必须遵循此页面🔗中详述的步骤。

在此更新的实施中，要在Adobe Campaign中发送推送通知，请执行以下步骤：

  1. 在Adobe Experience Platform数据收集中创建应用程序表面

  2. 在Adobe Campaign中配置应用程序设置

  3. 在Adobe Experience Platform数据收集中创建并配置移动资产

  4. 添加AdobeAdobe Experience Platform保证扩展（推荐）

  5. 将Campaign Classic添加到移动应用程序

  6. 为iOS和Android创建投放

NOTE
数据收集不支持旧版FCM和APNS p12。

在Adobe Experience Platform数据收集中创建应用程序表面 create-app-surface

您需要在Adobe Experience Platform Data Collection中添加移动应用程序推送凭据。

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

  1. 从Adobe Experience Platform Data Collection中，选择左侧面板中的​ App Surfaces ​选项卡。

  2. 单击​ Create App Surface ​以创建新配置。

  3. 输入配置的​ Name。

  4. 从​ Mobile Application Configuration ​中，选择操作系统：

    • 用于iOS的​ ​

      1. 在​ App ID (iOS Bundle ID) ​字段中输入移动应用​ 捆绑包ID。

        在Apple开发人员帐户的​ XCode ​中的主目标的​ 常规 ​选项卡中可以找到应用程序捆绑包ID。

      2. 打开​ Push Credentials ​以添加凭据。

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

        此密钥可从您的Apple开发人员帐户的​ 证书、标识符 ​和​ 配置文件 ​页面获取。

      4. 提供​ 密钥ID。 这是在创建p8身份验证密钥期间分配的10字符串。

        可在Apple开发人员帐户的​ 证书、标识符 ​和​ 配置文件 ​页中的​ 密钥 ​选项卡下找到它。

      5. 提供​ 团队ID。 这是可在​ 成员资格 ​选项卡下找到的字符串值。

    • 用于Android的​ ​

      1. 提供​ App ID (Android package name)。 通常，包名称是build.gradle文件中的应用程序ID。

      2. 切换​ Push Credentials ​以添加凭据。

      3. 拖放FCM推送凭据。 有关如何获取推送凭据的详细信息，请参阅Google文档。

  5. 单击​ Save ​以创建您的应用程序配置。

在Adobe Campaign中配置应用程序设置 push-config-campaign

创建服务 create-service

在发送推送通知之前，必须在Adobe Campaign中定义iOS和Android应用程序设置。

推送通知通过专用服务发送给您的应用程序用户。 用户安装您的应用程序后，会订阅此服务：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 ​图标定义使用此服务的移动应用程序。

创建移动应用程序 create-sapp

创建服务后，您现在需要定义将使用此服务的移动应用程序。

iOS

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

  1. 从您的服务中，单击​ Add，然后选择​ Create an iOS application。 单击 Next。

  2. 从​ Launch app configurations list ​窗口中，选择之前在此部分中创建的应用程序表面。 单击 Next。

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

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

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

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

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

  7. Integration key ​特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign，并将在配置Campaign扩展时使用。

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

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

    note note
    NOTE
    Integration key ​可使用字符串值完全自定义，但需要与SDK中指定的值完全相同。
    您不能对应用程序的开发版本（沙盒）和生产版本使用相同的证书。

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

  9. 单击​ Next ​开始配置生产应用程序，并遵循上面详述的相同步骤。 请注意，您不能对应用程序的开发版本（沙盒）和生产版本使用相同的​ Integration key。

  10. 单击 Finish。

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

Android

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

  1. 从您的服务中，单击​ Add，然后选择​ Create an Android application。 单击 Next。

  2. 从​ Launch app configurations list ​窗口中，选择在此部分中创建的应用程序表面，然后单击​ Next。

  3. 集成键特定于每个应用程序。 它将移动应用程序链接到Adobe Campaign，并将在配置Campaign扩展时使用。

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

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

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

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

  5. （可选）如果需要，您可以使用大约​ Application variables ​扩充推送消息内容。 这些都是完全可自定义的，并且是发送到移动设备的消息有效负载的一部分。

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

  7. 单击 Finish，然后单击 Save。

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

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

消息类型
可配置消息元素（FCM有效负荷名称）
可配置选项（FCM有效负荷名称）
数据消息
N/A
validate_only
通知消息
title，正文， android_channel_id，图标，声音，标记，颜色，点击操作，图像，滚动条，粘性，可见性，通知优先级，通知计数
validate_only

在Adobe Experience Platform数据收集中配置移动资产 create-mobile-property

  1. 在数据收集主页中，访问标记菜单。

  2. 单击 New Property。

  3. 键入属性的名称并选择​ Mobile ​作为平台。

  4. 单击​ Save ​以创建移动属性。

  5. 访问新创建的移动资产。

  6. 从您的移动属性仪表板中，访问​ Extensions ​菜单，然后访问​ Catalog ​选项卡。

  7. 安装​ Adobe Campaign Classic ​扩展。 了解有关Campaign扩展的更多信息

  8. 填写实例详细信息：

    • 在Campaign的​ Tools > Advanced > Deployment wizard ​菜单中可以找到​ Registration endpoint ​或​ Tracking endpoint ​个URL。
    • 在此部分中配置的移动应用中，可以找到​ Integration keys。

  9. 单击 Save。

  10. 您现在需要从​ Publishing flow ​菜单发布配置。 了解详情

您的移动资产现在将自动与​ Adobe Experience Platform Data Collection ​技术工作流同步。 了解详情

将Campaign Classic添加到移动应用程序 campaign-mobile-app

Adobe Experience Platform Mobile SDK 有助于在移动设备应用程序中支持 Adobe 的 Experience Cloud 解决方案和服务。 SDK配置通过数据收集UI进行管理，以实现灵活配置和基于规则的可扩展集成。

在Adobe Developer文档中了解详情。

创建推送通知 push-create

在数据收集中成功配置移动应用程序后，您现在可以在Adobe Campaign中创建并发送推送通知。

有关特定于iOS和Android通知交付的详细元素，请参阅此页面。

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