此信息可帮助您使用 ADBMobile.json
配置文件。
同一配置文件可用于多个平台上的应用程序:
在 iOS 中,可将 ADBMobileConfig.json
文件置于包内的任何可访问位置。
acquisition
启用移动设备应用程序客户获取。
如果缺少此部分,请启用移动设备应用程序客户获取并再次下载 SDK 配置文件。有关更多信息,请参阅下面的 referrerTimeout。
server
- 首次启动时在其中检查客户获取反向链接的客户获取服务器。appid
- 客户获取服务器上生成的唯一标识此应用程序的 ID。analyticsForwardingEnabled
audienceManager
对象中的属性。如果配置了 Audience Manager
,并且将 analyticsForwardingEnabled
设置为 true
,则所有 Analytics 流量也将转发至 Audience Manager。默认值为 false
。
backdateSessionInfo
启用/禁用 Adobe SDK 回溯会话信息点击量的功能。
会话信息点击量当前由崩溃次数和会话时长组成,可以启用或禁用。
如果将该值设置为 false
,则禁用点击量。
SDK 将返回到 4.1 版本之前的行为,即,将上一个会话的会话信息与后续会话的第一次点击进行归并。Adobe SDK 还会将会话信息附加到当前生命周期中,以避免造成访问次数夸大。由于访问次数不会再夸大,访问计数会立即下降。
如果不提供值,则默认值为 true
,并启用点击量。
启用点击量后,Adobe SDK 会将会话信息点击量对应的时间回溯到上一个会话中最后一次点击后的 1 秒。这意味着崩溃数据和会话数据将与正确的日期(即崩溃和会话发生的日期)相关联。但同时存在一个副作用,即 SDK 可能会为回溯的点击创建一次访问。每次新启动应用程序时都会有一个回溯的点击。
最低 SDK 版本:4.6
回溯的会话点击信息是在会话信息服务器调用中发送的,其他服务器调用也可能适用。
batchLimit
在连续调用中发送的点击量的阈值。例如,如果将 batchLimit
设置为 10,则第 10 次点击之前的每次点击都将存储在队列中。当第 10 次点击进入时,将连续发送所有 10 次点击。
0
,这表示不启用批量处理。offlineEnabled = true
。charset
定义将用于发送到 Analytics 的数据的字符集。charset 用于将传入的数据转换为 UTF-8 以便进行存储和报告。有关更多信息,请参阅 charSet 变量。
clientCode
分配给您的客户端代码。
这是 Target 的必需变量。
coopUnsafe
对于要求将该值设置为 true
的设备协作成员,您需要与相应的协作团队合作,以申请关于您的设备协作帐户上的阻止列表标记。不存在启用这些标记的自助途径。
请牢记以下信息:
coopUnsafe
设置为 true
,则会始终将 coop_unsafe=1
附加到 Audience Manager 和访客 ID 点击中。coop_unsafe=1
。以下是一些附加信息:
marketingCloud
对象的布尔属性,将该属性设置为 true
后,会导致设备退出 Experience Cloud 设备协作。false
。environmentId
您需要使用的环境的 ID。您可以指定有效的 ID (environmentId=8
),如果没有指定 environmentId
,则会使用默认的生产环境。
lifecycleTimeout
默认值为 300 秒。
指定从应用程序启动到将该启动视为新会话之前必须经过的时间(以秒为单位)。此超时也适用于应用程序被发送到后台后又重新启用的情况。应用程序在后台所用的时间不包括在会话时长中。
messages
由 Adobe Mobile Services 自动生成,用于定义应用程序内消息传递的设置。有关更多信息,请参阅下面的消息描述部分。
offlineEnabled
启用后,点击将在设备处于离线状态时排入队列,之后当设备处于在线状态时再进行发送。报表包必须启用时间戳才能使用离线跟踪。默认值为 false
。
以下是一些重要信息:
如果报表包已启用时间戳,则 offlineEnabled
配置属性必须为 true。
如果报表包未启用时间戳,则 offlineEnabled
配置属性必须为 false。
如果未正确配置,数据将丢失。如果您不确定报表包是否启用了时间戳,请与客户关怀团队联系或从 Adobe Mobile Services 下载配置文件。如果您当前向某个报表包报告 AppMeasurement 数据,而该报表包也从 JavaScript 收集数据,则您可能需要为移动数据设置一个单独的报表包,或在使用 s.timestamp
变量的所有 JavaScript 点击中包含自定义时间戳。
最低 SDK 版本:4.0
org
指定 Adobe Experience Platform Identity Service 的 Experience Cloud 组织 ID。
poi
每个 POI 数组均保存目标点区域的 POI 名称、纬度、经度和半径(以米为单位)。POI 名称可以是任何字符串。在发送 trackLocation
调用时,如果当前坐标位于定义的 POI 内,则会填充上下文数据变量,并随 trackLocation
调用发送该变量。
"poi" [
["sanfrancisco",37.757144,-122.44812,7000]
["santacruz",36.972935,-122.01725,600]
]
从版本 4.2 开始,POI 可在 Adobe Mobile 界面中定义并动态同步到应用程序配置文件。此同步需要 analytics.poi
设置:
"analytics.poi": "`https://assets.adobedtm.com/…/yourfile.json`",
如果未配置此设置,必须更新 ADBMobile.json
文件以包含此行。要下载更新的配置文件,请参阅开始之前。
postback
“回调”消息模板的定义如下所示:
"payload":{
"templateurl":"",//required- will be token-expanded prior to being sent
"templatebody":"", //optional-if this length > 0 POST will be used as transport method. This is a base-64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"", //optional-if this is length > 0 and POST type is selected, this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout": 0 //optional-number of seconds to wait before timingout.Defaultis2.}
代码中的 payload
对象是用于消息定义的有效负荷示例,将会进入 ADBMobileConfig.json
文件中。有关更多信息,请参阅回发。
privacyDefault
如果为 optedin
,将会立即发送点击。
如果为 optedout
,将会丢弃点击。
如果为 optunknown
,当您的报表包启用了时间戳时,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。
如果您的报表包未启用时间戳,则将丢弃点击,直到隐私状态更改为选择启用。
这仅设置初始值。如果在代码中设置或更改了此值,则会使用新值,直到再次进行更改或者卸载并重新安装应用程序为止。默认值为 optedin
。
最低 SDK 版本:4.0
referrerTimeout
首次启动时 SDK 等待客户获取反向链接数据直到超时的时间(以秒为单位)。如果您要使用客户获取,我们建议设置 5 秒的超时。
这是客户获取的必需变量。如果将该变量设置为 0
或未包含该变量,SDK 将不会等待客户获取数据,而且也不会跟踪客户获取量度。
remotes
自动配置并定义动态配置文件的 Adobe 托管端点。每次启动时会针对当前版本检查每个配置文件的最近更新时间,并且会下载并保存所做的更新。
analytics.poi
是托管的 POI 配置的端点。
messages
是托管的应用程序内消息配置的端点。
最低 SDK 版本:4.2
rsids
一个或多个用于接收 Analytics 数据的报表包。多个报表包 ID 应以逗号分隔,且中间不应有空格。
"rsids": "rsid"
"rsids" : "rsid1,rsid2"
这是 Analytics 的必需变量。
server
基于父节点的 Analytics 或受众管理服务器。
应当使用不含 https://
或 https://
协议前缀的服务器域填充此变量。此前缀基于 ssl
变量,将由库自动处理。
如果 ssl
为 true
,则对此服务器进行安全连接。如果 ssl
为 false
,则对此服务器进行非安全连接。
这是 Analytics 和/或受众管理的必需变量。
ssl
从版本 4.10.0 开始,如果未设置标记,则 SSL 默认为 true。
启用 (true
) 或禁用 (false
) 使用 SSL (HTTPS) 发送测量数据的功能。
“回调”消息模板的定义如下所示:
"payload":{
"templateurl":"",//required-will be token-expanded prior to being sent
"templatebody":"",//optional-if this length > 0, POST will be used as transport method. This is a base64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"",//optional-if this is length > 0 and POST type is selected this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout":0//optional-numberofsecondstowaitbeforetimingout.Defaultis2.}
代码中的 payload
对象是用于消息定义的有效负荷示例,将会进入 ADBMobileConfig.json
文件中。有关更多信息,请参阅回发。
timeout
确定 Target 等待响应的时间。
ADBMobileConfig.json
示例文件 以下是一个 ADBMobileConfig.json
示例文件:
{
"version": "2014-08-05T19:18:28.169Z",
"marketingCloud" : {
"org": "016D5C175213CCA80A490D05@AdobeOrg",
"coopUnsafe": false
},
"target": {
"clientCode": "",
"timeout": 5,
"environmentId": 8
},
"audienceManager": {
"server": "",
"analyticsForwardingEnabled": false
},
"acquisition": {
"server": "c00.adobe.com",
"appid": "10a77a60192fbb628376e1b1daeeb65debf934e2c807e067ceb2963a41b165ee"
},
"analytics": {
"rsids": "coolApp",
"server": "my.CoolApp.com",
"ssl": true,
"offlineEnabled": true,
"charset": "UTF-8",
"lifecycleTimeout": 300,
"privacyDefault": "optedin",
"batchLimit": 0,
"referrerTimeout": 5,
"poi": [
["san francisco",37.757144,-122.44812,7000],
["santa cruz",36.972935,-122.01725,600]
]
},
"messages": [
{
"messageId": "cb426565-a563-497a-a889-9dbeb451f8ae",
"template": "fullscreen",
"payload": {
"html": "<!DOCTYPE html><html><head><meta charset=\"utf-8\" /><title></title><style></style></head><body><iframe src=\"https://www.adobe.com/\" frameborder=\"0\"></iframe></body></html>"
},
"showOffline": false,
"showRule": "always",
"endDate": 2524730400,
"startDate": 0,
"audiences": [],
"triggers": [
{
"key": "pev2",
"matches": "eq",
"values": [
"AMACTION:custom"
]
}
]
}
],
"remotes": {
"analytics.poi": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0faadc2f9ed92bc00003b.json",
"messages": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0f9e2c2f9ed92bc000032.json"
}
}
消息节点由 Adobe Mobile Services 自动生成,且通常不需要手动更改。下面提供了相应描述,以供进行故障排除:
"messageId"
"template"
"payload"
"html"
"image"
"altImage"
仅限全屏,可选
在
image
中指定的 url 不可访问时要使用的捆绑图像的名称
"title"
"content"
"confirm"
"cancel"
"url"
"wait"
"showOffline"
"showRule"
"endDate"
"startDate"
"audiences"
一个用来定义消息显示方式的对象数组:
"key"
要在点击中查找的变量名称,它是必需的。
"matches"
进行比较时使用的匹配程序类型:
"values"
一个用来匹配以下命名的变量值的值数组:
"triggers"
与受众相同,不过,这里是操作而非受众: