Android 配置步骤
安装包后,您可以在Adobe Campaign Classic中定义Android应用程序设置。
关键步骤包括:
然后,您就可以创建Android富通知。
配置Android外部帐户 configuring-external-account-android
对于Android,提供了两个连接器:
- V1连接器,允许每个MTA子级有一个连接。
- V2连接器允许同时连接到FCM服务器以提高吞吐量。
要选择要使用的连接器,请执行以下步骤:
-
转到 Administration > Platform > External accounts。
-
选择 Android routing 外部帐户。
-
在 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。 -
对于Android V2,Adobe服务器配置文件(serverConf.xml)中还提供另一个参数:
- maxGCMConnectPerChild:每个子服务器向FCM发出的并行HTTP请求的最大限制(默认为8)。
配置Android服务 configuring-android-service
-
转到 Profiles and Targets > Services and subscriptions 节点并单击 New。
-
定义 Label 和 Internal name。
-
转到 Type 字段并选择 Mobile application。
note note NOTE 默认 Subscriber applications (nms:appSubscriptionRcp) 目标映射已链接到收件人表。 如果要使用其他目标映射,则需要创建一个新的目标映射,并在服务的 Target mapping 字段中输入该映射。 有关创建目标映射的详细信息,请参阅此部分。 -
然后单击 Add 按钮选择应用程序类型。
-
创建您的Android应用程序。 如需详细信息,请参阅此小节。
创建Android移动应用程序 creating-android-app
创建服务后,您现在需要创建Android应用程序:
-
在新创建的服务中,单击 Add 按钮以选择应用程序类型。
-
选择 Create an Android application 并输入 Label。
-
确保通过SDK在Adobe Campaign和应用程序代码中定义了相同的 Integration key。
note note NOTE Integration key 可使用字符串值完全自定义,但需要与SDK中指定的值完全相同。 -
选择 API version: HTTP v1或HTTP(旧版)。 此部分中详细介绍了这些配置
-
填写 Firebase Cloud Messaging the Android connection settings 字段。
-
单击 Finish,然后单击 Save。 您的Android应用程序现在已准备好用于Campaign Classic。
默认情况下,Adobe Campaign会在 Subscriber applications (nms:appSubscriptionRcp) 表的 User identifier (@userKey)字段中保存一个键。 利用此密钥,可将订阅链接到收件人。 要收集其他数据(如复杂的协调密钥),您需要应用以下配置:
配置API版本 select-api-version
在创建服务和新的移动应用程序后,您需要配置移动应用程序。 不应选择 HTTP(旧版) API,因为它已被Google弃用。
要配置HTTP v1 API版本,请执行以下步骤:
-
在您的 Mobile application creation wizard 窗口中,从 API version 下拉菜单中选择 HTTPV1。
-
单击 Load project json file to extract project details… 直接加载您的JSON密钥文件。 有关如何提取JSON文件的详细信息,请参阅此页面。
您还可以手动输入以下详细信息:
- Project Id
- Private Key
- Client Email
-
单击 Test the connection 以检查您的配置是否正确,以及营销服务器是否有权访问FCM。
note caution CAUTION 对于中间源部署,Test connection 按钮将不会检查MID服务器是否有权访问FCM服务器。 -
作为一个选项,您可以根据需要使用大约 Application variables 扩充推送消息内容。 这些都是完全可自定义的,并且是发送到移动设备的消息有效负载的一部分。
-
单击 Finish,然后单击 Save。 您的Android应用程序现在已准备好用于Campaign Classic。
以下是FCM有效负荷名称,用于进一步个性化您的推送通知:
扩展appsubscriptionRcp架构 extend-subscription-schema
了解如何在视频中扩展appsubscriptionRcp架构
您需要扩展 appsubscriptionRcp,以定义新的附加字段来将应用程序中的参数存储在Campaign数据库中。 例如,这些字段用于个性化。 操作步骤:
-
创建 Subscriber applications (nms:appsubscriptionRcp) 架构的扩展并定义新字段。 在此页面中了解有关架构扩展的更多信息
-
在 Subscription parameters 选项卡中定义映射。
note caution CAUTION 确保 Subscription parameters 选项卡中的配置名称与移动应用程序代码中的配置名称相同。