PhoneGap 插件方法

您可以使用 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; }); 
```

PII 方法

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&amp;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(); 
```

Target 方法

targetLoadRequest

向您配置的 Target 服务器发送请求，并返回选件的字符串值。

以下是此方法的语法：

ADB.targetLoadRequest(success, fail, name, defaultContent, parameters);

以下是此方法的代码示例：

ADB.targetLoadRequest(function&nbsp;(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()。有关更多信息，请参阅配置方法。

Audience Manager 方法

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();
```

ID 服务方法

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') ;});

adobe.com 上的资源

Behavioral Targeting Multivariate Testing Automated Onboarding Content Intelligence Responsive Forms Second Party Data

PhoneGap 插件方法

配置方法

PII 方法

跟踪方法

信标方法

Target 方法

客户获取方法

广告标识符

Audience Manager 方法

ID 服务方法

adobe.com 上的资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe