Android 配置步骤

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

关键步骤包括：

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

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

配置Android外部帐户

对于Android，有两个连接器可用：

• V1连接器，允许每个MTA子项连接一个。
• V2连接器允许与FCM服务器同时连接以提高吞吐量。

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

1. 转到 Administration > Platform > External accounts。

2. Select the Android routing external account.

3. 在选项卡 Connector 中，填写以下字 JavaScript used in the connector 段：

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

   NOTE

   您也可以按照以下方式配置它：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. Define a Label and an Internal name.

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

   NOTE

   默认 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 Integration key 在Adobe Campaign和应用程序代码中定义相同的内容。 有关此内容的详细信息，请参阅： 将活动SDK集成到移动应用程序中。

   NOTE

   它 Integration key 可以使用字符串值完全自定义，但必须与SDK中指定的值完全相同。

4. 选择 API version:HTTP v1或HTTP（传统）。 本节详细介绍了 这些配置

5. Fill in the Firebase Cloud Messaging the Android connection settings fields.

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

默认情况下，Adobe Campaign在表的( User identifier @userKey)字段中保存一 Subscriber applications (nms:appSubscriptionRcp) 个键。 此键允许您将订阅链接到收件人。 要收集其他合并关键项（如复杂数据），您需要应用以下配置：

选择API版本

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

• HTTP v1配置 在本节中有详细 介绍。
• HTTP(旧版 )配置详见本 节。

配置HTTP v1 API

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

1. 在窗 Mobile application creation wizard 口中， HTTPV1 从下 API version 拉菜单中选择。

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

   您还可以人工输入以下详细信息：

   • Project Id
   • Private Key
   • Client Email

   

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

   CAUTION

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

   

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

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

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

消息类型	可配置消息元素（FCM有效负荷名称）	可配置选项（FCM有效负荷名称）
数据消息	N/A	validate_only
通知消息	title, body, android_渠道id，图标，声音，标记，颜色，click_action，图像，ticker，粘性，可见性，notification_priority,notification_count	validate_only

配置HTTP（传统）API

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

1. 在窗 Mobile application creation wizard 口中， HTTP (legacy) 从下 API version 拉菜单中选择。

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

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

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

   

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

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

消息类型	可配置消息元素（FCM有效负荷名称）	可配置选项（FCM有效负荷名称）
数据消息	N/A	dryRun
通知消息	title, body, android_渠道id，图标，声音，标记，颜色， click_action	dryRun

扩展appsubscriptionRcp模式

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

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

1. 创建模式的扩 Subscriber applications (nms:appsubscriptionRcp) 展并定义新字段。 在本页中进一步了解模式 扩展

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

   CAUTION

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

创建Android富通知

通过Firebase Cloud Messaging，您可以选择两种类型的消息：

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

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

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

创建数据消息

1. 转到 Campaign management > Deliveries。

2. 单击 New.

   

3. 在 Deliver on Android (android) 下拉 Delivery template 框中选择。 添加 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. 在 Deliver on Android (android) 下拉 Delivery template 框中选择。 添加 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:将通知的优先级设置为默认、最小、低或高。 For more on this, refer to FCM documentation.
   • Visibility:将通知的可见性级别设置为公共、私有或机密。 For more on this, refer to FCM documentation.

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

   

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

11. 单击 Save 并发送投放。

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