了解推送通知有效载荷结构 push-payload
通过Adobe Campaign，您可以在iOS和Android移动设备上向移动应用程序（移动应用程序）发送个性化的分段推送通知。
在移动应用程序上收到的每个推送通知都会携带一些信息，在发送警报推送通知时，应用程序会使用这些信息显示推送通知，并且很可能还会进行一些进一步计算，尤其是在发送静默推送通知时。
移动设备应用程序代码会在事件处理程序中接收此信息，以指示已收到推送通知。 从Adobe Campaign Standard发送推送通知时，在移动应用程序中接收的信息也可能包含特定Campaign Standard的信息，这些信息可用于利用Campaign Standard提供的某些功能。 此外，有效负载可以包含可由移动设备应用程序使用的自定义数据。
本文档介绍了当推送通知成功从Adobe Campaign Standard发送到应用程序时，在移动应用程序中接收的有效负载的结构。
推送有效负荷结构 push-payload-structure
此部分详细介绍适用于各种移动平台的示例有效载荷的结构，并描述其中包含的主要属性。 这是事件处理程序中的移动设备应用程序代码中接收的有效负荷的结构，指示已收到推送通知。
有效负载属性及其值将因推送通知高级选项中提供的配置而异。 此部分还提供了Campaign StandardUI中的这些配置与有效负载中的属性之间的映射，以阐明在Campaign Standard中配置选项时有效负载会发生什么变化。
适用于iOS移动设备应用程序的 payload-structure-ios
从Adobe Campaign发送到iOS应用程序的 示例有效负载：
{
"aps":{
"alert":{
"body":"This is the content of my push notification",
"title":"Push Notification Title"
},
"content-available":1,
"category":"NEW_MESSAGE_CATEGORY",
"badge":2,
"mutable-content":1,
"sound":"default"
},
"custom_field1":"custom_value1",
"custom_field2":"custom_value2",
"media-attachment-url":"https://2.img-dpreview.com/files/p/articles/9440145363/Creative_Cloud.jpeg",
"uri":"https://mydeeplinkurl.com",
"_dId":"56c4",
"_mId":"h138a"}
要与iOS APNS Tester一起使用的 JSON示例有效负载
{
"aps": {
"alert": {
"title": "Push Notification Title",
"body": "body of push"
},
"badge": 33,
"sound": "default"
},
"custom_field1": "custom_value1",
"uri": "https://mydeeplinkurl.com"
}
有效负载中最重要的部分是aps词典，它包含Apple定义的键，用于确定接收通知的系统应如何提醒用户（如果有的话）。 此部分包含移动应用程序用来制定推送通知行为的预定义键。
可以在Apple开发人员文档中找到aps中属性的深入详细信息：创建远程通知有效负载。
适用于Android应用程序的 payload-structure-android
从Adobe Campaign向Android应用程序发送有效负载示例
{
"collapseKey": "1476005",
"priority": "high",
"data": {
"_dId": "d57fd6",
"_mId": "h1685a5",
"body": "adobe body 123",
"category": "adobe category 123",
"custom key 1": "value 1",
"custom key 2": "test value 2",
"custom key 3": "foo bar android",
"media-attachment-url": "http://adobegiphy.com?test=123",
"sound": "http://testcampaign.instance.com/r/?id=s1685a5,d57fd6,d57ff5",
"title": "adobe title 123",
"uri": "http://testcampaign.instance.com/r/?id=d1685a5,d57fd6,d57ff6",
"badge": 1817
}
}
使用Google FCM测试器的JSON示例有效负载
{
"to": "<==========ENTER your device token==============>",
"collapseKey": "1476005",
"priority": "high",
"data": {
"_dId": "d57fd6",
"_mId": "h1685a5",
"title": "adobe title 123",
"body": "adobe body 123",
"category": "adobe category 123",
"custom key 1": "value 1",
"custom key 2": "test value 2",
"custom key 3": "foo bar android",
"media-attachment-url": "http://adobegiphy.com?test=123",
"sound": "http://testcampaign.instance.com/r/?id=s1685a5,d57fd6,d57ff5",
"uri": "http://testcampaign.instance.com/r/?id=d1685a5,d57fd6,d57ff6",
"badge": 1817
}
}
有效负载包含数据消息，其中包含所有推送通知投放内容，包括自定义键/值对，如果需要，客户端应用程序必须处理该消息以构建和显示推送通知，否则必须添加任何其他业务逻辑。
要了解Android有效负载的各个方面，请参阅消息传送概念和选项(fcm)。
Campaign Standard配置和有效负载属性之间的映射 mapping-payload
消息正文
警报→正文
正文
标题和正文键提供警报的内容。
类别键可帮助系统将此类别的操作显示为警报界面中的按钮。
(仅适用于iOS 10或更高版本)
在为此URL提供值时，可变内容标志将自动发送到有效负载中。
(仅适用于iOS 10或更高版本)
(仅适用于iOS 10或更高版本)
(仅适用于iOS 10或更高版本)
（仅适用于Android）
_dId
_dId
如果您的应用程序希望调用跟踪回发以跟踪何时单击/打开推送通知，则需要这些属性。 此信息由应用服务器在内部计算和发送，无需用户干预。
回发信息可在此页面中找到。
如何在移动应用程序代码中检索有效负荷信息 payload-information
应用程序服务器发送的有效负载信息由移动设备应用程序代码在事件处理程序中接收，该事件处理程序指示已收到推送通知。 此事件会因正在处理的移动设备平台以及应用程序是在前台还是后台运行而有所不同。 以下文档可帮助您根据用例识别要处理的事件处理程序。
- iOS应用程序： 正在处理远程通知中的远程通知 节。
- Android应用程序：在Android客户端应用程序上接收消息
iOS移动应用的 示例
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo {
NSDictionary *apsDict = [userInfo objectForKey:@"aps"];
NSDictionary *alertDict = [apsDict objectForKey:@"alert"];
NSString *title = [alertDict objectForKey:@"title"];
NSString *body = [alertDict objectForKey:@"body"];
NSString *category = [apsDict objectForKey:@"category"];
NSString *deliveryId = userInfo[@"_dId"];
NSString *broadlogId = userInfo[@"_mId"];
NSString *mediaAttachmentURL = userInfo[@"media-attachment-url"];
NSString *deeplinkURL = userInfo[@"uri"];
NSString *customValue1 = userInfo[@"custom_field1"];
}
Android Mobile FCM应用程序的 示例
public void onMessageReceived(RemoteMessage message) {
Map<String, String> dataMap = message.getData();
String title = dataMap.get("title");
String body = dataMap.get("body");
String category = dataMap.get("category");
String deliveryId = dataMap.get("_dId");
String broadlogId = dataMap.get("_mId");
String mediaAttachmentURL = dataMap.get("media-attachment-url");
String deeplinkURL = dataMap.get("uri");
String customValue1 = dataMap.get("custom_field1");
}