Show Menu
화제×

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에서 4.x SDK로 업그레이드할 경우 이전 방문자 ID는 사용자 지정 또는 자동 생성 여부에 상관없이 검색 후 사용자 지정 사용자 식별자로 저장됩니다. 자세한 내용은 아래 getUserIdentifier 을 참조하십시오. 이 ID는 SDK 업그레이드 시에도 방문자 데이터를 보존합니다.
    4.x SDK에 새로 설치하는 경우 사용자 식별자는 null 이며 추적 식별자가 사용됩니다.
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackingIdentifier(function (value) { myTempVal = value; }, function () { myTempVal = null; }); 
      
      
  • getUserIdentifier
    고객 사용자 ID가 설정된 경우 이 식별자를 반환하고 ID가 설정되지 않은 경우 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 Link 데이터가 추가되고, 그렇지 않으면 추가 호출이 전송됩니다.
    • 다음은 이 메서드에 대한 구문입니다.
      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
    현재 xy 좌표를 보냅니다. 또한 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&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
    공유 쿠키 저장소에서 Target 쿠키를 지웁니다.
    • 다음은 이 메서드의 코드 샘플입니다.
      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 쿠키의 값을 가져옵니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.targetSessionID (success, fail); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.targetSessionID(function (value) { alert(value) },function (value){ alert('fail'); });  
      
      
  • targetPcID
    PcID 서버가 이 방문자에 대해 반환한 Target 쿠키의 값을 가져옵니다.
    • 다음은 이 메서드에 대한 구문입니다.
      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') ;});