Android 配置步骤

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

注意

要了解如何为iOS配置应用程序以及如何为iOS创建投放,请参阅此部分

关键步骤包括:

  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有效负荷名称,以进一步个性化您的推送通知:

消息类型 可配置消息元素(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​窗口中,选择​API version​下拉列表中的​HTTP (legacy)

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

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

    在以下示例中,我们添加​titleimageURL​和​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​选项卡中定义映射。

    注意

    确保​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设备上收到图像和网页时,应在推送通知中显示。

创建通知消息

注意

通知消息的其他选项仅在HTTP v1 API配置中可用。 有关更多信息,请参阅此](/docs/campaign-classic/using/sending-messages/sending-push-notifications/configure-the-mobile-app/configuring-the-mobile-application-android.html?lang=zh-Hans#android-service-httpv1)章节[。

了解如何在视频中创建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设备上收到图像和网页时,应在推送通知中显示。

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free