您可以使用 Android PhoneGap 插件方法完成多种任务。
在要使用跟踪的 html
文件中,将以下内容添加到 <head>
标记内:
<script type="text/javascript" charset="utf-8" src="ADB_Helper.js"></script>
getPrivacyStatus
返回当前用户的隐私状态。
以下是可用的状态:
ADB.optedIn
:将会立即发送点击。
ADB.optedOut
:将会丢弃点击。
ADB.optUnknown
:如果您的报表包启用了时间戳,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果您的报表包未启用时间戳,则将丢弃点击,直到隐私状态更改为选择启用。
默认值在 ADBMobileConfig.json
文件中设置。
以下是此方法的代码示例:
getPrivacyStatus(function (value) { myTempVal = value; }, function () {myTempVal = null;});
setPrivacyStatus
将当前用户的隐私状态设置为 status
。
您可以设置以下状态之一:
ADB.optedIn
:将会立即发送点击。
ADB.optedOut
:将会丢弃点击。
ADB.optUnknown
:如果您的报表包启用了时间戳,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果您的报表包未启用时间戳,则将丢弃点击,直到隐私状态更改为选择启用。
以下是此方法的代码示例:
ADB.setPrivacyStatus('ADB.optedIn');
getLifetimeValue
返回当前用户的生命周期值。默认值为 0。
以下是此方法的代码示例:
ADB.getLifetimeValue(function (value) { myTempVal = value }, function () { myTempVal = null; });
setDebugLogging
启用 (true
) 或禁用 (false
) 查看调试信息。默认情况下,此变量为 false
。
以下是此方法的代码示例:
ADB.setDebugLogging(true);
getVersion
获取库版本。
以下是此方法的代码示例:
ADB.getVersion(function (value) { versionNum = value }, function () { versionNum = 1.0;});
trackingIdentifier
返回自动生成的访客标识符。
这是在初始启动应用程序时生成的特定于应用程序的唯一访客 ID,并从那时起被保存和使用。这个 ID 在应用程序升级期间仍会保留,并在应用程序卸载后删除。
如果您的应用程序从 Experience Cloud 3.x SDK 升级到 4.x SDK,则会检索之前的访客 ID(自定义或自动生成)并将其存储为自定义用户标识符。有关更多信息,请参阅下面的 getUserIdentifier
。此 ID 用于在 SDK 升级期间保留访客数据。
对于 4.x SDK 上的新安装,用户标识符为 null
,并且将使用跟踪标识符。
以下是此方法的代码示例:
ADB.trackingIdentifier(function (value) { myTempVal = value; }, function () { myTempVal = null; });
getUserIdentifier
如果已设置客户的用户标识符,则会返回该标识符;如果未设置该标识符,则会返回 null
。默认值为 null
。
以下是此方法的代码示例:
getUserIdentifier(function(value) { myTempVal = value; }, function () { myTempVal = null; });
setUserIdentifier
将用户标识符设置为 identifier
。
以下是此方法的代码示例:
ADB.setUserIdentifier('testUser');
setPushIdentifier
设置推送通知的设备令牌。
getUserIdentifier(function (value) { myTempVal = value; }, function () { myTempVal = null; });
以下是此方法的语法:
ADB.setPushIdentifier(pushIdentifier, success, fail);
以下是此方法的代码示例:
ADB.setPushIdentifier('test_push_identifier',function (value) { alert('success'); },function (value) { alert('fail'); });
keepLifecycleSessionAlive
设置使生命周期会话保持活动状态的首选项。
调用 keepLifecycleSessionAlive
会阻止您的应用程序在下次从后台恢复时启动新会话。仅当您的应用程序在后台注册通知时,才应使用此方法。
以下是此方法的代码示例:
ADB.keepLifecycleSessionAlive();
trackingSendQueuedHits
无论当前使用何种批量处理选项,都强制库发送所有排队的点击。
以下是此方法的代码示例:
ADB.trackingSendQueuedHits();
trackingGetQueueSize
获取或设置离线队列中存储的跟踪调用的数量。
以下是此方法的代码示例:
ADB.trackingGetQueueSize(function (value) { myTempVal = value;}, function () { myTempVal = null;});
trackingClearQueue
删除离线队列中存储的所有跟踪调用。
手动清除队列时请务必谨慎,因为此操作无法还原。
以下是此方法的代码示例:
ADB.trackingClearQueue(function (value) { myTempVal = value; }, function () { myTempVal = null; });
collectPII
提交 PII 收集请求。
ADB.collectPII(piiData,success, fail);
以下是此方法的代码示例:
ADB.collectPII({'k1':'v1','k2':'v2','k3':'v3'}, function (value) { alert('success') },function (value) { alert('fail') ;});
trackAdobeDeepLink
跟踪 Adobe 深层链接点进。
如果生命周期调用是启动事件,将附加 Adobe 链接数据,否则,将发送一个额外调用。
以下是此方法的语法:
ADB.trackAdobeDeepLink(deeplinkURL, success, fail);
以下是此方法的代码示例:
ADB.trackAdobeDeepLink('xyz-deeplink-url',function (value) { alert('success'); },function (value) { alert('fail') });
trackState
通过可选的上下文数据跟踪应用程序状态。状态是您的应用程序中可用的一些视图,例如 home dashboard
、app settings
、cart
等等。这些状态与网站中的页面类似,而且 trackState
调用会使页面查看次数递增。
cData
:在上下文数据中发送的具有键值对的 JSON 对象。
以下是此方法的语法:
ADB.trackState(string stateName[,JSON cData]);
以下是此方法的代码示例:
ADB.trackState("login&nbsp;page");
ADB.trackState("login page", {"user":"john","remember":"true"});
trackAction
跟踪您的应用程序中的操作。这些操作包括您的应用程序中发生的要测量的操作,例如 logins
、banner taps
、feed subscriptions
以及其他量度。
以下是此方法的语法:
ADB.trackAction(string action[,JSON cData]);
以下是此方法的代码示例:
ADB.trackAction("login");
ADB.trackAction("login", {"user":"john","remember":"true"});
trackLocation
发送当前的 x y 坐标。此方法还使用 ADBMobileConfig.json
文件中定义的目标点来确定作为参数提供的位置是否位于您的任何 POI 内。如果当前坐标位于定义的 POI 内,则会填充上下文数据变量,并随 trackLocation
调用发送该变量。
以下是此方法的语法:
ADB.trackLocation(x, y[,JSON cData]);
以下是此方法的代码示例:
ADB.trackLocation('40.431596', '-111.893713');
trackLifetimeValueIncrease
向用户的生命周期值中添加 amount
。
以下是此方法的语法:
ADB.trackLifetimeValueIncrease(amount[,JSON cData]);
以下是此方法的代码示例:
ADB.trackLifetimeValueIncrease('10.01');
trackTimedActionStart
启动名为 action
的定时操作。
如果对已启动的操作调用此方法,则将覆盖上一个定时操作。
这个调用不发送点击。
以下是此方法的语法:
ADB.trackTimedActionStart(action[,JSON cData]);
以下是此方法的代码示例:
ADB.trackTimedActionStart("cartToCheckout");
trackTimedActionUpdate
传入 cData
,以更新与 action
关联的上下文数据。
传入的 cData
将附加到操作的现有数据中,如果已经为 action
定义相同的键,则会覆盖数据。
以下是此方法的语法:
ADB.trackTimedActionUpdate(String action[,JSON cData]);
以下是此方法的代码示例:
ADB.trackTimedActionUpdate("cartToCheckout",{'SampleContextDataKey3':'SampleContextDataVal3','SampleContextDataKey4':'SampleContextDataVal4'});
trackTimedActionEnd
结束定时操作。
以下是此方法的代码示例:
ADB.trackTimedActionEnd("cartToCheckout");
trackingTimedActionExists
返回定时操作是否正在进行中。
以下是此方法的语法:
ADB.trackingTimedActionExists(function (value) { myTempVal = value }, function () { myTempVal = null; });
trackBeacon
跟踪用户接近信标的时间。
以下是此方法的语法:
ADB.trackBeacon(uuid, major, minor, proximity, cData)
以下是此方法的代码示例:
ADB.trackBeacon('2F234454-CF6D-4A0F-ADF2-F4911BA9FFA6', 1, 2,
ADB.beaconUnknown, {'hp':'hp_val','hp.company':'adobe'}
clearCurrentBeacon
在用户远离信标后清除信标数据。
以下是此方法的语法:
ADB.clearCurrentBeacon(success, fail)
以下是此方法的代码示例:
ADB.clearCurrentBeacon();
targetLoadRequest
向您配置的 Target
服务器发送请求,并返回选件的字符串值。
以下是此方法的语法:
ADB.targetLoadRequest(success, fail, name, defaultContent, parameters);
以下是此方法的代码示例:
ADB.targetLoadRequest(function (value)
{myTempVal = value }, function () { myTempVal = null;},'bannerOffer', 'none', {'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'});
targetLoadOrderConfirmRequest
向您配置的 Target
服务器发送请求。
以下是此方法的语法:
ADB.targetLoadOrderConfirmRequest(success, fail name orderId, orderTotal, productPurchaseId, parameters);
以下是此方法的语法:
ADB.targetLoadRequest(function (value) { myTempVal = value }
, function ()
{ myTempVal = null; }
, 'name' 'orderId' 'total', 'purchaseId',
{'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'}
);
targetClearCookies
从共享的 Cookie 存储中清除 Target
Cookie。
以下是此方法的代码示例:
ADB.targetClearCookies();
targetLoadRequestWithNameWithLocationParameters
处理 Target
服务请求。
以下是此方法的语法:
ADB.targetLoadRequestWithNameWithLocationParameters(
success, fail, name, defaultContent, profileParameters, orderParameters, mboxParameters requestLocationParameters
);
以下是此方法的代码示例:
ADB.targetLoadRequestWithNameWithLocationParameters (function () { alert('success'); }, function () { alert('fail'); }, ;'bannerOffer', 'none', {'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'}, {'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe', 'hp.val2':'hp_val2'});
targetLoadRequestWithName
处理 Target
服务请求。
以下是此方法的语法:
ADB.targetLoadRequestWithRequestName(success, fail, name, defaultContent, profileParameters, orderParameters, mboxParameters);
以下是此方法的代码示例:
ADB.targetLoadRequestWithName(
function (value){ // handle target success} ,
function() { // handle target failure },
"mboxName",
"defaultContent",
{"profileParameters":"profileParametervalues"}
{"orderId" : "32FGJ4XK" , "orderTotal" : "123.33" , "purchasedProductIds":"[46,34]" }
{"mboxParameters":"mboxParametersvalues"}
);
targetSessionID
获取 Target 服务器为此访客返回的 SessionID
Cookie 值。
以下是此方法的语法:
ADB.targetSessionID (success, fail);
以下是此方法的代码示例:
ADB.targetSessionID(function (value) { alert(value) },function (value){ alert('fail'); });
targetPcID
获取 PcID
服务器为此访客返回的 Target
Cookie 值。
以下是此方法的语法:
ADB.targetPcID (success, fail);
以下是此方法的代码示例:
ADB.targetPcID(function (value) { alert(value) },function (value) { alert('fail'); });
targetSetThirdPartyID
为 Target 设置自定义访客 ID。
以下是此方法的语法:
ADB.targetSetThirdPartyID(thirdPartyID, success, fail);
以下是此方法的代码示例:
ADB.targetSetThirdPartyID('test-third-party-id' function (value) { alert('success'); },function (value) { alert('fail'); });
targetThirdPartyID
获取 Target 的自定义访客 ID。
以下是此方法的语法:
ADB.targetThirdPartyID(success, fail);
以下是此方法的代码示例:
ADB.targetThirdPartyID(function (value) { alert(value); },function (value) { alert('fail')__;});
acquisitionCampaignStartForApp
向您配置的 Target 服务器发送请求,并返回选件的字符串值。
以下是此方法的语法:
ADB.acquisitionCampaignStartForApp(appId, data, success, fail);
以下是此方法的代码示例:
ADB.acquisitionCampaignStartForApp("appId", {‘key’:‘value’}, function() {…}, function() {…}));
ADB.acquisitionCampaignStartForApp("appId", {‘key’:‘value’});
在 Cordova 生成的主活动的 onResume()
方法中,调用 Config.submitAdvertisingIdentifierTask()
。有关更多信息,请参阅配置方法。
audienceGetVisitorProfile
获取访客资料。
以下是此方法的语法:
ADB.audienceGetVisitorProfile();
以下是此方法的代码示例:
ADB.audienceGetVisitorProfile(function(value) { profile = value;}, function() { profile = null; });
audienceGetDpuuid
返回 DPUUID。
以下是此方法的语法:
ADB.audienceGetDpuuid(success fail);
以下是此方法的代码示例:
ADB.audienceGetDpuuid(function(value) { dpuuid = value;}, function(){dpuuid = null; });
audienceGetDpid
返回 DPID。
以下是此方法的语法:
ADB.audienceGetDpid(success, fail);
以下是此方法的代码示例:
ADB.audienceGetDpid(function(value){dpid = value;}, function() {dpid = null;});
audienceSetDpidAndDpuuid
设置 DPID 和 DPUUID。
以下是此方法的语法:
ADB.audienceSetDpidAndDpuuid(dpid, dpuuid, success, fail);
以下是此方法的代码示例:
ADB.audienceSetDpidAndDpuuid(‘dpid’, ‘dpuuid’, function() {…}, function(){…};
ADB.audienceSetDpidAndDpuuid(‘dpid’, ‘dpuuid’);
audienceSignalWithData
处理 Audience Manager 服务请求。
以下是此方法的语法:
ADB.audienceSignalWithData(success, fail, data);
以下是此方法的代码示例:
ADB.audienceSignalWithData(function() {}, function() {} {‘key1’: ’value1’ ‘key2’: ‘value2’});
ADB.audienceSignalWithData({‘key1’: ’value1’, ‘key2’:‘value2’});
audienceReset
重置 Audience Manager UUID 并清除当前访客资料。
以下是此方法的代码示例:
ADB.audienceReset();
visitorGetMarketingCloudId
从 ID 服务返回 Experience Cloud ID。
以下是此方法的语法:
ADB.visitorGetMarketingCloudId(success, fail);
以下是此方法的代码示例:
ADB.visitorGetMarketingCloudId(function (value) { mcid = value;},function (){ mcid = null;});
visitorSyncIdentifiers
将提供的标识符与 ID 服务同步。
以下是此方法的语法:
ADB.visitorSyncIdentifiers(identifiers, success, fail);
以下是此方法的代码示例:
ADB.visitorSyncIdentifiers({‘key_id_1’:’value_id_1’}, function() {…}, function() {…}));
ADB.visitorSyncIdentifiers({‘key_id_1’: ‘value_id_1’});
visitorSyncIdentifiersWithAuthenticationState
将提供的标识符同步到 ID 服务。
以下是此方法的语法:
ADB.visitorSyncIdentifiersWithAuthenticationState
(identifiers, authenticationState, success, fail);
以下是此方法的代码示例:
ADB.visitorSyncIdentifiersWithAuthenticationState({'k1':'v1','k2':'v2','k3':'v3'}, ADB.mobileVisitorAuthenticationStateAuthenticated, function (value) { alert('success'); },function (value) { alert('fail'); });
visitorSyncIdentifierWithType
将提供的标识符同步到 ID 服务。
以下是此方法的语法:
ADB.visitorSyncIdentifierWithType(identifierType, identifier authenticationState, success, fail);
以下是此方法的代码示例:
ADB.visitorSyncIdentifierWithType('test-identifier-type', 'test-identifier', ADB.mobileVisitorAuthenticationStateAuthenticated, function (value) { alert('success') },function (value) { alert('fail'); });
visitorAppendToURL
将访客标识符附加到给定 URL。
以下是此方法的语法:
ADB.visitorAppendToURL(urlToAppend, success, fail);
以下是此方法的代码示例:
ADB.visitorAppendToURL('test_visitor_url', function (value) alert(value);},'');
visitorGetIDs
返回已同步的所有 visitorID
。
以下是此方法的语法:
ADB.visitorGetIDs (success, fail);
以下是此方法的代码示例:
ADB.visitorGetIDs(function (value) { alert(value); },function (value) { alert('fail') ;});