AD BMobile.cs 메서드

구성 메서드

  • CollectLifecycleData

    SDK의 솔루션 전체에서 사용하기 위해 라이프사이클 데이터를 수집해야 함을 SDK에 표시합니다. 자세한 내용은 라이프사이클 지표를 참조하십시오.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void CollectLifecycleData();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.CollectLifecycleData();
      
  • EnableLocalNotifications(iOS만 해당)

    앱에서 로컬 알림을 활성화합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void EnableLocalNotifications();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.EnableLocalNotifications();
      
  • GetDebugLogging

    현재 디버그 로깅 기본 설정을 반환합니다. 기본값은 false입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static bool GetDebugLogging();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var debugEnabled = ADBMobile.GetDebugLogging();
      
  • GetLifetimeValue

    현재 사용자의 수명 값을 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static double GetLifetimeValue();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var lifetimeValuea = ADBMobile.GetLifetimeValue();
      
  • GetPrivacyStatus

    현재 사용자에 대한 개인 정보 상태의 열거 표현을 반환합니다.

    • MOBILE_PRIVACY_STATUS_OPT_IN: 히트가 즉시 전송됩니다.

    • MOBILE_PRIVACY_STATUS_OPT_OUT: 히트가 삭제됩니다.

    • MOBILE_PRIVACY_STATUS_UNKNOWN: 오프라인 추적이 활성화되면 개인 정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다.

      오프라인 추적이 비활성화되면 개인 정보 상태가 옵트인으로 변경될 때까지 히트가 무시됩니다. 기본값은 ADBMobileConfig.json 파일.

    • 다음은 이 메서드에 대한 구문입니다.

      public static ADBPrivacyStatus GetPrivacyStatus();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var privacyStatus = ADBMobile.GetPrivacyStatus();
      
  • GetUserIdentifier

    사용자 지정 식별자가 설정된 경우 사용자 지정 사용자 식별자를 반환합니다. 사용자 지정 식별자가 설정되지 않은 경우 null을 반환합니다. 기본값은 null입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static string GetUserIdentifier();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var userId = ADBMobile.GetUserIdentifier();
      
  • GetVersion

    라이브러리 버전을 가져옵니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static string GetVersion();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var version = ADBMobile.GetVersion();
      
  • KeepLifecycleSessionAlive(iOS만 해당)

    구성 파일의 라이프사이클 세션 시간 제한 값과 상관없이 다음 번에 백그라운드에서 세션이 다시 시작할 때 새 세션이 시작하지 않아야 함을 SDK에 표시합니다.

    이 메서드는 앱이 백그라운드에 있을 때 알림을 등록하는 앱에 사용하기 위한 것으로, 앱이 백그라운드에 있을 때 실행하는 코드에서만 호출되어야 합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void KeepLifecycleSessionAlive();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.KeepLifecycleSessionAlive();
      
  • PauseCollectingLifecycleData(Android만 해당)

    라이프사이클 지표를 정확히 계산하기 위해 앱이 일시 중지되었음을 SDK에 표시합니다. 예를 들어 일시 중지 시 타임스탬프를 수집하여 이전 세션 길이를 파악합니다. 플래그를 설정하여 앱이 충돌하지 않았음을 라이프사이클에서 올바르게 알도록 할 수도 있습니다. 자세한 내용은 라이프사이클 지표를 참조하십시오.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void PauseCollectingLifecycleData();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.PauseCollectingLifecycleData();
      
  • SetContext(Android만 해당)

    UnityPlayer의 현재 활동에서 애플리케이션 컨텍스트를 설정해야 함을 SDK에 표시합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void SetContext();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.SetContext();
      
  • SetDebugLogging

    디버그 로깅 기본 설정을 enabled로 설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void SetDebugLogging (bool enabled);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.SetDebugLogging(true);
      
  • SetPrivacyStatus

    현재 사용자의 개인 정보 상태를 상태로 설정합니다. 다음 값 중 하나를 설정합니다.

    • MOBILE_PRIVACY_STATUS_OPT_IN: 히트가 즉시 전송됩니다.

    • MOBILE_PRIVACY_STATUS_OPT_OUT: 히트가 삭제됩니다.

    • MOBILE_PRIVACY_STATUS_UNKNOWN: 오프라인 추적이 활성화되면 개인 정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다. 오프라인 추적이 비활성화되면 개인 정보 상태가 옵트인으로 변경될 때까지 히트가 무시됩니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void SetPrivacyStatus(ADBPrivacyStatusstatus);
      
    • 다음은 이 구문에 대한 코드 샘플입니다.

      ADBMobile.SetPrivacyStatus(ADBMobile.ADBPrivacyStatus.MOBILE_PRIVACY_STATUS_OPT_IN);
      
  • SetUserIdentifier

    사용자 식별자를 userId로 설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void SetUserIdentifier(string userId);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.SetUserIdentifier("myCustomUserId");
      

Analytics 메서드

  • GetTrackingIdentifier

    분석 추적 식별자를 검색합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static string GetTrackingIdentifier();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var trackingId = ADBMobile.GetTrackingIdentifier();
      
  • TrackState

    선택적 컨텍스트 데이터로 앱 상태를 추적합니다. 상태는 "title screen", "level 1", "pause" 등과 같이 앱에서 사용할 수 있는 보기입니다. 이 상태는 웹 사이트의 페이지와 유사하며 TrackState 호출은 페이지 보기를 증가시킵니다.

    상태가 비어 있으면 다음과 같이 표시됩니다 app name app version (build) 참조하십시오. 보고서에 이 값이 표시되면 각각의 보고서에서 상태를 설정해야 합니다 TrackState 호출.

    페이지 보기 횟수를 늘리는 유일한 추적 호출입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackState(string state, Dictionary<string, object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var contextData = new Dictionary<string, object>);
      contextData.Add ("user", "jim");
      ADBMobile.TrackState("title screen", contextData);
      
  • TrackAction

    앱의 작업을 추적합니다. 작업은 "죽음", "획득한 수준", "피드 구독" 및 기타 지표 등 앱에서 발생하여 측정하려는 것입니다.

    백그라운드에 앱이 있을 때 실행할 수 있는 코드가 있는 경우(예: 백그라운드 데이터 검색) trackActionFromBackground를 대신 사용합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackAction(string action, Dictionary<string, object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackAction("level gained", null);
      
  • TrackActionFromBackground(iOS만 해당)

    백그라운드에서 발생한 작업을 추적합니다. 특정 시나리오에서 라이프사이클 이벤트가 실행되지 않습니다.

    이 메서드는 백그라운드에 앱이 있을 때 실행되는 코드에서만 호출해야 합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackActionFromBackground(string action, Dictionary<string,object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackActionFromBackground("majorLocationChange", null);
      
  • TrackLocation

    현재 위도 및 경도 좌표를 보냅니다. 또한 ADBMobileConfig.json 파일에서 정의된 관심 영역을 사용하여 매개변수로 제공된 위치가 POI 내에 있는지 파악합니다. 현재 좌표가 정의된 POI 내에 있을 경우 컨텍스트 데이터 변수를 채워 TrackLocation 호출로 보냅니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackLocation(float latValue, float lonValue, Dictionary<string, object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackLocation(28.418649, -81.581324, null);
      
  • TrackBeacon

    사용자가 비콘 근접 위치에 들어오면 추적합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackBeacon(int major, int minor, string uuid, ADBBeaconProximity proximity, Dictionary<string, object> cdata);
      
  • TrackingClearCurrentBeacon

    사용자가 비콘 근접 위치를 떠난 후 비콘 데이터를 지웁니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackingClearCurrentBeacon();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackingClearCurrentBeacon();
      
  • TrackLifetimeValueIncrease

    사용자의 라이프타임 값에 양을 추가합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackLifetimeValueIncrease(double amount, Dictionary<string, object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackLifetimeValueIncrease(5, null);
      
  • TrackTimedActionStart

    이름 작업으로 시간 제한 작업을 시작합니다. 이미 시작한 작업에 대해 이 메서드를 호출하는 경우 이전 시간 제한 작업을 덮어씁니다.

    이 호출은 히트를 전송하지 않습니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackTimedActionStart(string action, Dictionary<string,object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackTimedActionStart("level2", null);
      
  • TrackTimedActionUpdate

    데이터를 전달하여 지정된 작업과 관련된 컨텍스트 데이터를 업데이트합니다. 전달된 데이터는 기존 작업 데이터에 추가되며 동일한 키가 작업에 이미 정의되어 있으면 데이터를 덮어씁니다.

    이 호출은 히트를 전송하지 않습니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackTimedActionUpdate(string action, Dictionary<string, object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var contextData = new Dictionary<string, object>;
      contextData.Add("checkpoint", "1:32");
         ADBMobile.TrackTimedActionUpdate("level2", contextData);
      
  • TrackTimedActionEnd

    시간 제한 작업을 종료합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackTimedActionEnd(string action);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackTimedActionEnd("level2");
      
  • TrackingTimedActionExists

    시간 제한 작업이 진행 중인지 여부를 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static bool TrackingTimedActionExists(string action);
      
    • 다음은 이 메서드의 코드 샘플입니다.

       var level2InProgress = ADBMobile.TrackingTimedActionExists("level2");
      
  • TrackingSendQueuedHits

    현재 큐에 올라가 있는 히트 개수와 상관없이 라이브러리에서 오프라인 큐의 모든 히트를 강제로 보냅니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackingSendQueuedHits();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackingSendQueuedHits();
      
  • TrackingClearQueue

    오프라인 큐에서 모든 히트를 지웁니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void TrackingClearQueue();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile.TrackingClearQueue();
      
  • TrackingGetQueueSize

    현재 오프라인 큐에 올라가 있는 히트 수를 검색합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static int TrackingGetQueueSize();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var queueSize = ADBMobile.TrackingGetQueueSize();
      

Experience Cloud ID 메서드

  • GetMarketingCloudID

    ID 서비스에서 Experience Cloud ID를 검색합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static string GetMarketingCloudID();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var mcid = ADBMobile.GetMarketingCloudID();
      
  • VisitorSyncIdentifiers

    Experience Cloud ID를 사용하면 각 방문자와 연결할 추가 고객 ID를 설정할 수 있습니다. 방문자 API는 여러 다른 고객 ID의 범위를 구분하기 위해 동일한 방문자의 여러 고객 ID와 고객 유형 식별자를 수락합니다. 이 메서드는 JavaScript 라이브러리의 setCustomerID에 해당합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void VisitorSyncIdentifiers(Dictionary<string, object> identifiers);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var ids = new Dictionary<string, object> ();
      ids.Add ("player1", "jimbob");
      ADBMobile.VisitorSyncIdentifiers(ids);
      

획득 메서드

  • ProcessGooglePlayInstallReferrerUrl (Android만 해당)

    Google Play Install Referrer API 호출에서 반환된 레퍼러 URL을 이 메서드에 전달합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void ProcessGooglePlayInstallReferrerUrl(string referrerUrl);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      // in actual implementation, the referrer url should be retrieved
      // from the Google Play Install Referrer API.
      var myReferrer = "utm_source=unityTestSource&utm_content=unityTestContent&utm_campaign=unityTestCampaign";
      ADBMobile.ProcessGooglePlayInstallReferrerUrl(myReferrer);
      

이 페이지에서는