此信息可帮助您了解 ADBMobile.json 配置文件中的变量。
ADBMobileConfig.json
配置文件引用同一配置文件可用于多个平台上的应用程序:
在 Android 中,必须将 ADBMobileConfig.json
文件放置在 assets
文件夹中。
以下是 JSON 文件中的变量列表,以及每个变量所需的最低 SDK 版本:
acquisition
server
,首次启动时在其中检查客户获取反向链接的客户获取服务器。appid
,客户获取服务器上生成的唯一标识此应用程序的 ID。如果缺少此部分,请启用移动设备应用程序客户获取并再次下载 SDK 配置文件。有关更多信息,请参阅此变量列表中的 referrerTimeout。
analyticsForwardingEnabled
最低 SDK 版本:4.8.0。
默认值为 false
。
audienceManager
对象中的属性。如果配置了 Audience Manager,并且将 analyticsForwardingEnabled
设置为 true
,则所有 Analytics 流量也将转发至 Audience Manager。
backdateSessionInfo
最低 SDK 版本:4.6。
启用/禁用 Adobe SDK 回溯会话信息点击量的功能。
会话信息点击量当前由崩溃次数和会话时长组成,可以启用或禁用。
启用或禁用点击
如果将该值设置为 false
,则禁用点击量。SDK 将返回到 4.1 版本之前的行为,即,将上一个会话的会话信息与后续会话的第一次点击进行归并。Adobe SDK 还会将会话信息附加到当前生命周期中,以避免造成访问次数夸大。由于访问次数不会再夸大,访问计数会立即下降。
如果不提供值,则默认值为 true
,并启用点击量。启用点击量后,Adobe SDK 会将会话信息点击量对应的时间回溯到上一个会话中最后一次点击后的 1 秒。这意味着崩溃数据和会话数据将与正确的日期(即崩溃和会话发生的日期)相关联。但同时存在一个副作用,即 SDK 可能会为回溯的点击创建一次访问。每次新启动应用程序时都会有一个回溯的点击。
回溯的会话点击信息是在会话信息服务器调用中发送的,其他服务器调用也可能适用。
batchLimit
最低 SDK 版本:4.1
在连续调用中发送的点击量的阈值。
例如,如果将 batchLimit
设置为 10,则第 10 次点击之前的每次点击都将存储在队列中。当第 10 次点击进入时,将连续发送所有 10 次点击。
请牢记以下信息:
0
,这表示不启用批量处理。offlineEnabled = true
。charset
最低 SDK 版本:4.0
定义将用于发送到 Analytics 的数据的字符集。
charset 用于将传入的数据转换为 UTF-8 以便进行存储和报告。
clientCode
最低 SDK 版本:4.0
分配给您的客户端代码。
这是 Target 的必需变量。
coopUnsafe
marketingCloud
对象的布尔属性,将该属性设置为 true
后,会导致设备退出 Experience Cloud 设备协作。false
。对于要求将该值设置为 true
的设备协作成员,您需要与相应的协作团队合作,以申请关于您的设备协作帐户上的阻止列表标记。不存在启用这些标记的自助途径。
请牢记以下信息:
coopUnsafe
设置为 true
,则会始终将 coop_unsafe=1
附加到 Audience Manager 和访客 ID 点击中。coop_unsafe=1
。environmentId
最低 SDK 版本:4.14
您需要使用的环境的 ID。
您可以指定有效的 ID (environmentId=8
),如果没有指定 environmentId
,则会使用默认的生产环境。
lifecycleTimeout
最低 SDK 版本:4.0
默认值为 300 秒。
指定从应用程序启动到将该启动视为新会话之前必须经过的时间(以秒为单位)。此超时也适用于应用程序被发送到后台后又重新启用的情况。
应用程序在后台所用的时间不包括在会话时长中。
messages
offlineEnabled
最低 SDK 版本:4.0
启用后,点击将在设备处于离线状态时排入队列,之后当设备处于在线状态时再进行发送。
报表包必须启用时间戳才能使用离线跟踪。
默认值为 false
。
如果报表包已启用时间戳,则 offlineEnabled
配置属性必须为 true。如果报表包未启用时间戳,则 offlineEnabled
配置属性必须为 false。
如果未正确配置,数据将丢失。如果您不确定报表包是否启用了时间戳,请与客户关怀团队联系或从 Adobe Mobile Services 下载配置文件。
如果您当前向某个报表包报告 AppMeasurement 数据,而该报表包也从 JavaScript 收集数据,则您可能需要为移动数据设置一个单独的报表包,或在使用 s.timestamp
变量的所有 JavaScript 点击中包含自定义时间戳。
org
poi
最低 SDK 版本:4.0
每个目标点 (POI) 数组均保存目标点区域的 POI 名称、纬度、经度和半径(以米为单位)。
POI 名称可以是任何字符串。在发送 trackLocation
调用时,如果当前坐标位于定义的 POI 内,则会填充上下文数据变量,并随 trackLocation
调用发送该变量。
"poi": [
["san francisco",37.757144,-122.44812,7000]
["santa cruz",36.972935,-122.01725,600]
]
从版本 4.2 开始,POI 可在 Adobe Mobile 界面中定义并动态同步到应用程序配置文件。此同步需要 analytics.poi
设置:
“analytics.poi“: `https://assets.adobedtm.com/`
…/yourfile.json”`,
如果未配置此设置,必须更新 ADBMobile.json
文件以包含此行。要下载更新的配置文件,请参阅开始之前。
postback
最低 SDK 版本:4.6
以下是有关“回调”消息模板的定义:
"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-Type header. 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 timing out. Default is 2.}
代码中的 payload
对象是用于消息定义的有效负荷示例,将会进入 ADBMobileConfig.json
文件中。有关更多信息,请参阅回发。
privacyDefault
最低 SDK 版本:4.0
默认值为 optedin
。
optedin
,将会立即发送点击。optedout
,将会丢弃点击。optunknown
,当您的报表包启用了时间戳时,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果您的报表包未启用时间戳,则将丢弃点击,直到隐私状态更改为 optedin
。这仅设置初始值。如果在代码中设置或更改了此值,则会使用新值,直到再次进行更改或者卸载并重新安装应用程序为止。
referrerTimeout
最低 SDK 版本:4.1
首次启动时 SDK 等待客户获取反向链接数据直到超时的时间(以秒为单位)。如果您要使用客户获取,我们建议设置 5 秒的超时。
这是客户获取的必需变量。如果将该变量设置为 0
或未包含该变量,SDK 将不会等待客户获取数据,而且也不会跟踪客户获取量度。
remotes
最低 SDK 版本:4.2
自动配置并定义动态配置文件的 Adobe 托管端点。
每次启动时会针对当前版本检查每个配置文件的最近更新时间,并且会下载并保存所做的更新。
analytics.poi
是托管的 POI 配置的端点。messages
是托管的应用程序内消息配置的端点。rsids
最低 SDK 版本:4.0
一个或多个用于接收 Analytics 数据的报表包。多个报表包 ID 应以逗号分隔,且中间不应有空格。
"rsids" "rsid"
"rsids" "rsid1,rsid2"
这是 Analytics 的必需变量。
server
https://
或 https://
协议前缀的服务器域填充此变量。此前缀基于 ssl
变量,将由库自动处理。如果 ssl
为 true
,则对此服务器进行安全连接。如果 ssl
为 false
,则对此服务器进行非安全连接。ssl
最低 SDK 版本:4.0
默认值为 false
。
启用 (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 POST type is selected this will be set as the Content-Type header. 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 timing& out. Default is 2.}
timeout
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"
生成的 ID,必需
"template"
"showOffline"
"showRule"
"endDate"
"startDate"
"payload"
"audiences"
"matches"
"values"
"triggers"