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应用程序。 有关更多信息,请参阅此🔗章节。

创建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配置中可用。 有关更多信息,请参阅此🔗章节。

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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now