Android 配置步骤

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

关键步骤包括：

1. 配置Android外部帐户
2. 配置Android服务
3. 在活动中创建移动应用程序
4. 使用其他数据扩展应用程序模式

然后，您将能够创建Android富通知。

配置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

   注意

   您也可以按照以下方式配置它：https://localhost:8080/nms/jsp/androidPushConnector.js，但我们建议您使用连接器的版本2。

   

4. 对于Android V2,Adobe服务器配置文件(serverConf.xml)中还有一个可用参数：

   • maxGCMConnectPerChild:每个子服务器启动的对FCM的并行HTTP请求的最大限制（默认为8）。

配置Android服务

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

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

   

2. 定义​Label​和​Internal name。

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

   注意

   默认​Subscriber applications (nms:appSubscriptionRcp)​目标映射链接到收件人表。 如果要使用其他目标映射，则需要创建新目标映射，并在服务的​Target mapping​字段中输入它。 有关创建目标映射的详细信息，请参阅配置指南。

   

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

   

5. 创建Android应用程序。 有关更多信息，请参阅此](…/…/delivery/using/configuring-the-mobile-application-android.md#creating-android-app)章节[。

创建Android移动应用程序

创建服务后，您现在需要创建Android应用程序：

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

   

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

   

3. 确保通过SDK在Adobe Campaign和应用程序代码中定义相同的​Integration key。 有关详细信息，请参阅：将活动 SDK集成到移动应用程序中。

   注意

   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版本

创建服务和新的移动应用程序后，您需要根据所选的API版本配置移动应用程序。

• 本节 详细介绍HTTP v1 配置。
• HTTP（旧版）配 置在本节中有详细 介绍。

配置HTTP v1 API

要配置HTTP v1 API版本，请执行以下步骤：

1. 在​Mobile application creation wizard​窗口中，选择​API version​下拉列表中的​HTTPV1。

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

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

   • Project Id
   • Private Key
   • Client Email

   

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

   注意

   对于中间源部署，Test connection​按钮将不检查MID服务器是否有权访问FCM服务器。

   

4. 作为一种选项，您可以根据需要使用某些​Application variables​来丰富推送消息内容。 这些是完全可自定义的，并且是发送到移动设备的消息有效负荷的一部分。

5. 单击 Finish，然后单击 Save。您的Android应用程序现已准备好用于Campaign Classic。

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

配置HTTP（旧版）API

要配置HTTP（旧版）API版本，请执行以下步骤：

1. 在​Mobile application creation wizard​窗口中，选择​API version​下拉列表中的​HTTP (legacy)。

2. 输入由移动应用程序开发人员提供的​Project key。

3. 作为一种选项，您可以根据需要使用某些​Application variables​来丰富推送消息内容。 这些是完全可自定义的，并且是发送到移动设备的消息有效负荷的一部分。

   在以下示例中，我们添加​title、imageURL​和​iconURL​以创建富推送通知，然后为应用程序提供要在通知中显示的图像、标题和图标。

   

4. 单击 Finish，然后单击 Save。您的Android应用程序现已准备好用于Campaign Classic。

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

扩展appsubscriptionRcp模式

了解如何在视频中扩展appsubscriptionRcp模式

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

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

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

   注意

   确保​Subscription parameters​选项卡中的配置名称与移动应用程序代码中的配置名称相同。 请参阅将活动 SDK集成到移动应用程序部分。

创建Android富通知

通过Firebase Cloud Messaging，您可以在两种类型的消息之间进行选择：

• Data message，由客户端应用程序处理。
  
  消息将直接发送到手机应用程序，该应用程序将生成android通知并向设备显示。数据消息仅包含自定义应用程序变量。

• Notification message，由FCM SDK自动处理。
  
  FCM会代表客户端应用程序在用户设备上自动显示消息。通知消息包含预定义的一组参数和选项，但仍然可以通过自定义应用程序变量进一步个性化。

有关Firebase Cloud Messaging消息类型的详细信息，请参阅 FCM文档。

创建数据消息

1. 转到​Campaign management > Deliveries。

2. 单击 New.

   

3. 在​Delivery template​下拉列表中选择​Deliver on Android (android)。 将​Label​添加到投放。

4. 单击​To​定义要目标的人口。 默认情况下，应用​Subscriber application​目标映射。 单击​Add​以选择您的服务。

   

5. 在​Target type​窗口中，选择​Subscribers of an Android mobile application​并单击​Next。

6. 在​Service​下拉列表中，选择之前创建的服务，然后选择应用程序，然后单击​Finish。
   根据在配置步骤中添加的内容，会自动添加​Application variables。

   

7. 选择​data message​作为​Message Type。

8. 编辑您的富通知。

   

9. 如果需要，您可以在之前配置的​Application variables​中添加信息。 Application variables 需要在Android服务中进行配置，并且是发送到移动设备的消息有效负荷的一部分。

10. 单击​Save​并发送投放。

当在用户的移动Android设备上收到图像和网页时，应在推送通知中显示。

创建通知消息

了解如何在视频中创建Android推送通知

1. 转到​Campaign management > Deliveries。

2. 单击 New.

   

3. 在​Delivery template​下拉列表中选择​Deliver on Android (android)。 将​Label​添加到投放。

4. 单击​To​定义要目标的人口。 默认情况下，应用​Subscriber application​目标映射。 单击​Add​以选择您的服务。

   

5. 在​Target type​窗口中，选择​Subscribers of an Android mobile application​并单击​Next。

6. 在​Service​下拉列表中，选择之前创建的服务，然后选择应用程序，然后单击​Finish。

   

7. 选择​notification message​作为​Message Type。

8. 添加标题并编辑您的消息。 使用​Notification options​个性化您的推送通知：

   • Channel ID:设置通知的渠道ID。在收到任何具有此渠道ID的通知之前，应用程序必须使用此渠道ID创建渠道。
   • Sound:设置设备收到通知时要播放的声音。
   • Color:设置通知的图标颜色。
   • Icon:设置通知图标以在用户档案设备上显示。
   • Tag:设置用于替换通知抽屉中现有通知的标识符。
   • Click action:设置与用户单击您的通知相关联的操作。

   有关​Notification options​和如何填写这些字段的详细信息，请参阅FCM文档。

   

9. 如果您的应用程序已配置HTTP v1 API协议，则可以使用以下​HTTPV1 additional options​进一步个性化您的推送通知：

   • Ticker:设置通知的滚动文本。仅适用于设置为Android 5.0 Lollipop的设备。
   • Image:设置要在通知中显示的图像URL。
   • Notification Count:设置要直接在应用程序图标上显示的新未读信息的数量。
   • Sticky:设置为true或false。如果设置为false，则当用户单击通知时，通知将自动消失。 如果设置为true，则即使用户单击通知，也仍会显示通知。
   • Notification Priority:将通知的优先级设置为默认、最小、低或高。有关详细信息，请参阅FCM文档。
   • Visibility:将通知的可见性级别设置为公共、私人或机密。有关详细信息，请参阅FCM文档。

   有关​HTTP v1 additional options​和如何填写这些字段的详细信息，请参阅FCM文档。

   

10. 如果需要，您可以在之前配置的​Application variables​中添加信息。 Application variables 需要在Android服务中进行配置，并且是发送到移动设备的消息有效负荷的一部分。

11. 单击​Save​并发送投放。

当在用户的移动Android设备上收到图像和网页时，应在推送通知中显示。