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. 定义​ Label ​和​ Internal 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. 确保通过SDK在Adobe Campaign和应用程序代码中定义了相同的​ Integration key

    note note
    NOTE
    Integration key ​可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。
  4. 选择​ API version: HTTP v1或HTTP(旧版)。 此部分中详细介绍了这些配置

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

  6. 单击​ Finish,然后单击​ Save。 您的Android应用程序现在已准备好用于Campaign Classic。

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

配置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弃用。

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

  1. 在您的​ Mobile application creation wizard ​窗口中,从​ API version ​下拉菜单中选择​ HTTPV1

  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. 单击​ Finish,然后单击​ Save。 您的Android应用程序现在已准备好用于Campaign Classic。

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

消息类型
可配置消息元素(FCM有效负荷名称)
可配置选项(FCM有效负荷名称)
数据消息
N/A
validate_only
通知消息
title,正文, android_channel_id,图标,声音,标记,颜色,点击操作,图像,滚动条,粘性,可见性,通知优先级,通知计数
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