Show Menu
화제×

PhoneGap 플러그인 메서드

iOS 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 참조). 이렇게 하면 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
    푸시 알림용 장치 토큰을 설정합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      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;}); 
      
      
  • keepLifecycleSessionAlive
    구성 파일의 라이프사이클 세션 시간 제한 값과 상관없이 다음 번에 백그라운드에서 세션이 다시 시작할 때 새 세션이 시작하지 않아야 함을 SDK에 표시합니다.
    중요: 이 메서드는 앱이 백그라운드에 있을 때 알림을 등록하는 앱에 사용하도록 만들었으며 앱이 백그라운드에 있을 때 실행하는 코드에서만 호출되어야 합니다.
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.keepLifecycleSessionAlive();
      
      
  • collectLifecycleData
    SDK의 솔루션 전체에서 사용하기 위해 라이프사이클 데이터를 수집해야 함을 SDK에 표시합니다. 자세한 내용은 라이프사이클 지표 를 참조하십시오.
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.collectLifecycleData(); 
      
      

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');}); 
      
      
  • trackPushMessageClickthrough
    푸시 메시지 클릭스루를 추적합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackPushMessageClickthrough(userInfo,success,fail); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackPushMessageClickthrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • trackLocalNotificationClickThrough
    로컬 알림 메시지의 클릭스루를 추적합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackLocalNotificationClickThrough(userInfo,success,fail); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackLocalNotificationClickThrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • trackState
    선택적 컨텍스트 데이터로 앱 상태를 추적합니다. 상태는 home dashboard , app settings , cart 등과 같이 앱에서 사용할 수 있는 보기입니다. 이 상태는 웹 사이트의 페이지와 유사하며 trackState 호출은 페이지 보기를 증가시킵니다. cData는 컨텍스트 데이터로 전송할 키-값 쌍이 있는 JSON 개체입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackState(stringstateName[,JSONcData]); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackState("loginpage");
      
      
        ADB.trackState("loginpage",{"user":"john","remember":"true"});
      
      
  • trackAction
    앱의 작업을 추적합니다. 작업은 logins , banner taps , feed subscriptions 및 기타 지표 등 앱에서 발생하여 측정하려는 것입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackAction(stringaction[,JSONcData]);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackAction("login");
      
      
      ADB.trackAction("login",{"user":"john","remember":"true"})
      
      
  • trackActionFromBackground
    백그라운드에서 발생된 작업을 추적합니다. 특정 시나리오에서 라이프사이클 이벤트의 시작을 억제합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackActionFromBackground(stringaction[,JSONcData]); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackActionFromBackground("login");
      
      
      ADB.trackActionFromBackground("login",{"user":"john","remember":"true"});
      
      
  • trackLocation
    현재 x와 y 좌표를 보냅니다. 또한 ADBMobileConfig.json 파일에서 정의된 관심 영역을 사용하여 매개 변수로 제공된 위치가 POI 내에 있는지 파악합니다. 현재 좌표가 정의된 POI 내에 있을 경우 컨텍스트 데이터 변수를 채워 trackLocation 호출로 보냅니다.
    • 다음은 이 메서드에 대한 구문입니다.
       ADB.trackLocation(x,y[,JSONcData]);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackLocation('40.431596','-111.893713');
      
      
  • trackLifetimeValueIncrease
    사용자의 라이프타임 값에 amount 를 추가합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackLifetimeValueIncrease(amount[,JSONcData]);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackLifetimeValueIncrease('10.01');
      
      
  • trackTimedActionStart
    action 이름으로 시간 작업을 시작합니다.. 이미 시작한 작업에 대해 이 메서드를 호출하는 경우 이전 시간 제한 작업을 덮어씁니다.
    이 호출은 히트를 전송하지 않습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackTimedActionStart(action[,JSONcData]);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackTimedActionStart("cartToCheckout"); 
      
      
  • trackTimedActionUpdate
    cData 를 전달하여 제공된 action 과 연관된 컨텍스트 데이터를 업데이트합니다. 전달한 cData 는 지정된 작업의 기존 데이터에 추가되며 action 에 대해 동일한 키가 이미 정의된 경우 데이터를 덮어씁니다.
    이 호출은 히트를 전송하지 않습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackTimedActionUpdate(Stringaction[,JSONcData]);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackTimedActionUpdate("cartToCheckout",{'SampleContextDataKey3':'SampleContextDataVal3','SampleContextDataKey4':'SampleContextDataVal4'}); 
      
      
  • trackTimedActionEnd
    시간 제한 작업을 종료합니다.
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.trackTimedActionEnd("cartToCheckout");
      
      
  • trackingTimedActionExists
    시간 제한 작업이 진행 중인지 여부를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.trackingTimedActionExists(function(value){myTempVal = value;},function(){myTempVal = null;});
      
      

타겟 메서드

  • 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
    공유 쿠키 저장소에서 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
    Target 서버가 이 방문자에 대해 반환한 PcID 쿠키의 값을 가져옵니다.
    • 다음은 이 메서드에 대한 구문입니다.
      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
    사용자가 링크를 클릭한 것처럼 개발자가 앱 획득 캠페인을 시작할 수 있도록 해줍니다. 이 메서드는 SKStoreView 를 사용하여 작업하는 경우처럼, 획득 링크를 수동으로 만들고 직접 앱스토어 리디렉션을 처리하는 데 유용합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.acquisitionCampaignStartForApp(appId,data,success,fail); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.acquisitionCampaignStartForApp('0652024f-adcd-49f9-9bd7-2552a4564d2f',{'extraDataKey':'extraDataValue'},success,fail); 
      
      

광고 식별자

Cordova에서 생성한 AppDelegate 에서 application:didFinishLaunchingWithOptions: 위임 메서드의 [ADBMobile setAdvertisingIdentifier:] 를 호출합니다. 자세한 내용은 구성 메서드 를 참조하십시오.

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
    동기화된 모든 visitorIDs 를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      ADB.visitorGetIDs(success,fail)
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADB.visitorGetIDs(function(value){alert(value);},function(value){alert('fail');});