v7
仅适用于 Campaign Classic v7

Android 配置步骤

安装包后,您可以在Adobe Campaign Classic中定义Android应用程序设置。

关键步骤包括:

然后,您将能够 创建Android富通知.

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

配置Android外部帐户 configuring-external-account-android

对于Android,提供了两个连接器:

  • V1连接器,允许每个MTA子级有一个连接。
  • V2连接器允许同时连接到FCM服务器以提高吞吐量。

要选择要使用的连接器,请执行以下步骤:

  1. 转到 Administration > Platform > External accounts.

  2. 选择 Android routing 外部帐户。

  3. Connector 选项卡,填写 JavaScript used in the connector 字段:

    对于Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    note note
    NOTE
    您也可以按照https://localhost:8080/nms/jsp/androidPushConnector.js进行配置,但我们建议您使用连接器版本2。

  4. 对于Android V2,Adobe服务器配置文件(serverConf.xml)中还提供另一个参数:

    • maxGCMConnectPerChild:每个子服务器向FCM发出的并行HTTP请求的最大限制(默认为8个)。

配置Android服务 configuring-android-service

了解如何在视频中配置Android服务.

  1. 转到 Profiles and Targets > Services and subscriptions 节点并单击 New.

  2. 定义 LabelInternal name.

  3. 转到 Type 字段并选择 Mobile application.

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

  4. 然后单击 Add 按钮选择应用程序类型。

  5. 创建Android应用程序。 如需详细信息,请参阅此小节

创建Android移动应用程序 creating-android-app

创建服务后,您现在需要创建Android应用程序:

  1. 在新创建的服务中,单击 Add 按钮选择应用程序类型。

  2. 选择 Create an Android application 并输入 Label.

  3. 确保相同 Integration key 在Adobe Campaign中以及通过SDK在应用程序代码中定义。 如需详细信息,请参阅此小节

    note note
    NOTE
    Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。
  4. 选择 API version:HTTP v1或HTTP(旧版)。 有关这些配置的详情,请参见 本节

  5. 填写 Firebase Cloud Messaging the Android connection settings 字段。

  6. 单击 FinishSave. 您的Android应用程序现在已准备好用于Campaign Classic。

默认情况下,Adobe Campaign会在 User identifier (@userKey)字段 Subscriber applications (nms:appSubscriptionRcp) 表格。 利用此密钥,可将订阅链接到收件人。 要收集其他数据(如复杂的协调密钥),您需要应用以下配置:

配置API版本 select-api-version

IMPORTANT
Android Firebase Cloud Messaging (FCM)服务的一些重要更改将于2024年发布,可能会影响Adobe Campaign实施。 作为Google持续努力改进其服务的一部分,旧版FCM API将在以下日期停用 2024年6月20日. 在本节中了解详情 Adobe Campaign v8技术说明.

在创建服务和新的移动应用程序后,您需要配置移动应用程序。 此 HTTP(旧版) 不应选择API,因为Google已弃用API。

要配置HTTP v1 API版本,请执行以下步骤:

  1. 在您的 Mobile application creation wizard 窗口,选择 HTTPV1API version 下拉菜单。

  2. 单击 Load project json file to extract project details… 直接加载JSON密钥文件。 有关如何提取JSON文件的更多信息,请参阅 此页面.

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

    • Project Id
    • Private Key
    • Client Email

  3. 单击 Test the connection 以检查您的配置是否正确,以及营销服务器是否有权访问FCM。

    note caution
    CAUTION
    对于中间源部署, Test connection 按钮不会检查MID服务器是否有权访问FCM服务器。

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

  5. 单击 FinishSave. 您的Android应用程序现在已准备好用于Campaign Classic。

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

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

扩展appsubscriptionRcp架构 extend-subscription-schema

在视频中了解如何扩展appsubscriptionRcp架构

您需要扩展 appsubscriptionRcp 定义新的附加字段,以将来自应用程序的参数存储在Campaign数据库中。 例如,这些字段用于个性化。 操作步骤:

  1. 创建 Subscriber applications (nms:appsubscriptionRcp) 架构并定义新字段。 在中了解有关模式扩展的更多信息 此页面

  2. 在中定义映射 Subscription parameters 选项卡。

    note caution
    CAUTION
    请确保 Subscription parameters 选项卡与移动应用程序代码中的选项卡相同。 请参阅此小节
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1