Android 메서드

Experience Cloud 솔루션 4.x SDK용 Xamarin 구성 요소에 대한 Android 메서드입니다.

구성 메서드

  • DebugLogging

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

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

      public static Boolean DebugLogging;
      
    • 다음은 이 메서드의 코드 샘플입니다.

      getter: var debuglog = Config.DebugLogging;
      setter: Config.DebugLogging = (Java.Lang.Boolean)true;
      
  • 라이프타임 값

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

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

      public static BigDecimal LifetimeValue;
      
    • 다음은 이 메서드의 코드 샘플입니다.

       var lifetimeValue = Config.LifetimeValue;
      
  • PrivacyStatus

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

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

    기본값은 ADBMobileConfig.json 파일.

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

      public static MobilePrivacyStatus PrivacyStatus;
      
    • 다음은 이 메서드의 코드 샘플입니다.

      getter: var privacyStatus = Config.PrivacyStatus;
      setter: Config.PrivacyStatus = MobilePrivacyStatus.MobilePrivacyStatusUnknown;
      
  • UserIdentifier

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

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

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

      getter: var userId = Config.UserIdentifier;
      setter: Config.UserIdentifier = "imBatman";
      
  • 버전

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

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

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

      var version = ADBMobile.Version;
      
  • PauseCollectingLifecycleData

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

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

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

      Config.PauseCollectingLifecycleData();
      
  • CollectLifecycleData (Activity activity)

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

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

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

      Config.CollectLifecycleData (this);
      
  • CollectLifecycleData (Activity activity)

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

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

      public static void collectLifecycleData(Activity activity, IDictionary<string, Object> context));
      
    • 다음은 이 메서드의 코드 샘플입니다.

      IDictionary<string, Java.Lang.Object> context = new Dictionary<string,
      Java.Lang.Object> ();
      context.Add ("key", "value");
      Config.CollectLifecycleData (this, context);
      
  • OverrideConfigStream

    (4.2 이상) 다른 ADBMobile JSON 애플리케이션이 시작될 때 파일을 구성합니다. 애플리케이션이 닫힐 때까지 다른 구성을 사용합니다.

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

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

      Stream st1 = Assets.Open ("ADBMobileConfig-2.json");
      Config.OverrideConfigStream (st1);
      
  • SetLargeIconResourceId(int resourceId)

    (4.2 이상) SDK에서 만든 알림에 사용되는 큰 아이콘을 설정합니다. 이 아이콘이 사용자가 알림 센터에서 전체 알림을 볼 때 표시되는 기본 이미지입니다.

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

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

      Config.SetLargeIconResourceId(R.drawable.appIcon);
      
  • SetSmallIconResourceId(int resourceId)

    (4.2 이상) SDK에서 만든 알림에 사용되는 작은 아이콘을 설정합니다. 이 아이콘은 상태 표시줄에 표시되며, 사용자가 알림 센터에서 전체 알림을 볼 때 표시되는 보조 이미지입니다.

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

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

       Config.SetSmallIconResourceId(R.drawable.appIcon);
      

Analytics 메서드

  • TrackingIdentifier

    Analytics에 대해 자동으로 생성된 ID를 반환합니다. 이 ID는 앱별 고유 ID이며 처음 실행 시 생성되어 저장되고 이후에 계속 사용됩니다. 이 ID는 앱 업그레이드 사이에 유지되며 설치 제거 시 제거됩니다.

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

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

      Var trackingId = Analytics.TrackingIdentifier
      
  • TrackState

    선택적 컨텍스트 데이터로 앱 상태를 추적합니다. States "제목 화면", "수준 1", "일시 중지" 등과 같이 앱에서 사용할 수 있는 보기입니다. 이 상태는 웹 사이트의 페이지와 유사하며 TrackState 호출은 페이지 보기를 증가시킵니다. 상태가 비어 있으면 보고서에 "앱 이름 앱 버전(빌드)으로 표시됩니다. 보고서에 이 값이 표시되면 각각의 보고서에서 상태를 설정해야 합니다 TrackState 호출.

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

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

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

      var cdata = new Dictionary<string, Java.Lang.Object>();
      cdata.Add ("key", (Java.Lang.Object)"value");
      Analytics.TrackState ("stateName", (IDictionary<string,
      Java.Lang.Object>)cdata);
      
  • TrackAction

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

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

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

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

      var cdata = new Dictionary<string, Java.Lang.Object> ();
      cdata.Add ("key", (Java.Lang.Object)"value");
      Analytics.TrackAction ("actionName", (IDictionary<string,
      Java.Lang.Object>)cdata);
      
  • TrackLocation

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

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

      public static void TrackLocation(Location location, IDictionary<string, Object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

       Location loc = new Location(LocationManager.GpsProvider);;
       loc.Latitude = 111;
       loc.Longitude = 44;
       loc.Accuracy = 5;
       Analytics.TrackLocation (loc, null);
      
  • TrackBeacon

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

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

      public static void TrackBeacon (string uuid, string major, string minor,  Analytics.BEACON_PROXIMITY prox, IDictionary<string, Object> cdata);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Analytics.TrackBeacon ("UUID", "1", "2",
      Analytics.BEACON_PROXIMITY.ProximityImmediate, null);
      
  • ClearBeacon

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

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

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

      Analytics.ClearBeacon();
      
  • TrackLifetimeValueIncrease

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

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

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

      Analytics.TrackLifetimeValueIncrease(5,null);
      
  • TrackTimedActionStart

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

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

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

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

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

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

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

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

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

      var updatedData = new Dictionary<string, Java.Lang.Object> ();
      cdata.Add ("key", (Java.Lang.Object)"value");
      Analytics.TrackTimedActionUpdate("level2", updatedData);
      
  • TrackTimedActionEnd

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

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

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

      Analytics.TrackTimedActionEnd ("level2", new TimedActionBlock());
           class TimedActionBlock: Java.Lang.Object,
      Analytics.ITimedActionBlock{
           public Java.Lang.Object Call (long inAppDuration, long
      totalDuration IDictionary<string, Java.Lang.Object> contextData){
           return Java.Lang.Boolean.True;
        }
      }
      
  • TrackingTimedActionExists

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

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

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

      var level2InProgress = Analytics.TrackingTimedActionExists("level2");
      
  • SendQueuedHits

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

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

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

      Analytics.SendQueuedHits();
      
  • ClearQueue

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

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

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

      Analytics.ClearQueue();
      
  • 큐 크기

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

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

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

      var queueSize = Analytics.QueueSize();
      

Experience Cloud ID 메서드

  • MarketingCloudId

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

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

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

      var mcid = Visitor.MarketingCloudId;
      
  • SyncIdentifiers

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

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

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

      IDictionary<string,string> ids = new Dictionary<string, string> ();
      ids.Add ("pushID", ;"value2");
      Visitor.SyncIdentifiers (ids);
      

Target 메서드

  • LoadRequest

    구성된 Target 서버에 요청을 보내고 Action<NSDictionary> 콜백입니다.

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

      public static void LoadRequest (TargetLocationRequest request, Target.ITargetCallback callback);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      class TargetBlock: Java.Lang.Object, Target.ITargetCallback{
          public void Call (Java.Lang.Object content)
         {
          Console.WriteLine (content.ToString());
         }
      }
      var req = Target.CreateRequest ("AndroidTest", "defGal", parameters);
           Target.LoadRequest (req, new TargetBlock());
      
  • CreateRequest

    편의 생성자를 사용하여 ADBTargetLocationRequest 지정된 매개 변수와 함께 개체를 작성합니다.

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

      public static TargetLocationRequest TargetCreateRequest(string name,string defaultContent,IDictionary<string,string> parameters);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      IDictionary<string, Java.Lang.Object> parameters = new Dictionary> string, Java.Lang.Object> ();
          parameters.Add ("key1", "value2");
      var req = Target.CreateRequest ("AndroidTest", "defGal", parameters);
      
  • CreateOrderConfirmRequest

    ADBTargetLocationRequest를 생성합니다.

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

      public static TargetLocationRequest TargetCreateRequest (string name, string defaultContent, IDictionary<;string, string> parameters);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      var orderConfirm = Target.CreateOrderConfirmRequest ("myOrder", "12345", "29.41", "cool stuff", null);
      
  • ClearCookies

    앱에서 Target 쿠키를 지웁니다.

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

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

      Target.ClearCookies ();
      

Audience Manager

  • VisitorProfile

    가장 최근 획득한 방문자 프로필을 반환합니다. 아직 어떤 신호도 전송되지 않은 경우 nil을 반환합니다. 방문자 프로필은 앱이 여러 번 시작되는 경우에도 쉽게 액세스할 수 있도록 NSUserDefaults에 저장됩니다.

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

      public static IDictionary<string, Object> VisitorProfile;
      
    • 다음은 이 메서드의 코드 샘플입니다.

      NSDictionary profile = AudienceManager.VisitorProfile;
      
  • Dpid

    현재 반환 DPID.

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

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

      string currentDpid = AudienceManager.Dpid;
      
  • Dpuuid

    현재 반환 DPUUID.

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

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

      string currentDpuuid = AudienceManager.Dpuuid;
      
  • AudienceSetDpidAndDpuuid

    를 설정합니다. dpiddpuuid. If dpiddpuuid 가 설정되면 각 신호와 함께 전송됩니다.

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

      public static void AudienceSetDpidAndDpuuid (string Dpid, String Dpuuid);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      AudienceManager.SetDpidAndDpuuid ("testDpid", "testDpuuid");
      
  • SignalWithData

    트레이트가 있는 신호를 고객 관리에 보내고 Action<NSDictionary> 콜백입니다.

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

      public static void SignalWithData (IDictionary<string, Object> audienceData, AudienceManager.IAudienceManagerCallback callback);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      class AudienceManagerCallback: Java.Lang.Object,
       AudienceManager.IAudienceManagerCallback{
         public void Call (Java.Lang.Object content)
        {
          Console.WriteLine (content.ToString());
        }
      }
      IDictionary<string, Java.Lang.Object> traits = new Dictionary<string,
      Java.Lang.Object> ();
         traits.Add ("trait", "b");
      AudienceManager.SignalWithData (traits, new AudienceManagerCallback());
      
  • 재설정

    Audience Manager 재설정 UUID 및 은 현재 방문자 프로필을 삭제합니다.

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

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

       AudienceManager.Reset ();
      

비디오

Video Analytics에 대한 자세한 내용은 Video Analytics.

  • MediaSettings

    지정된 매개 변수와 함께 MediaSettings 개체를 반환합니다.

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

      public static MediaSettings SettingsWith (string name, double length, string playerName, string playerID);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      MediaSettings settings = Media.SettingsWith("name1", 10, "playerName1", "playerID1");
      
  • AdSettingsWith

    광고 비디오 추적에 사용할 MediaSettings 개체를 반환합니다.

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

      public static MediaSettings AdSettingsWith ( string name, double length,
        string playerName, string parentName, string parentPod,
      double parentPodPosition, string CPM);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      MediaSettings adSettings = Media.AdSettingsWith ("adName1", 2, "playerName1", "name1", "podName1", 4, "CPM1");
      
  • 열기

    추적을 위해 ADBMediaSettings 개체를 엽니다.

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

      public static void Open (MediaSettings settings, Media.IMediaCallback callback);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      MediaSettings settings = Media.SettingsWith ("name1", 10, "playerName1", "playerID1");
         Media.Open (settings, new MediaCallback());
         class MediaCallback: Java.Lang.Object, Media.IMediaCallback{
      public void Call (Java.Lang.Object content)
      {
      }
      }
      
  • 닫기

    이름이 name인 미디어 항목을 닫습니다.

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

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

      Media.Close (settings.Name);
      
  • 재생

    제공된 offset(초)에서 이름이 name인 미디어 항목을 재생합니다.

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

      public static void Play ( string name, double offset);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Media.Play (settings.Name, 0);
      
  • 완료

    제공된 오프셋(초)에서 완료된 미디어 항목을 수동으로 표시합니다.

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

      public static void Complete (string name, double offset);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Media.Complete (settings.Name, 5);
      
  • 정지

    제공된 오프셋에서 비디오가 중지 또는 일시 중지되었음을 미디어 모듈에 알립니다.

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

      public static void Stop ( string name, double offset);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Media.Stop (settings.Name, 3);
      
  • 클릭

    미디어 항목이 클릭되었음을 미디어 모듈에 알립니다.

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

      public static void Click ( string name, double offset);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Media.Click (settings.Name, 3);
      
  • 추적

    현재 미디어 상태에 대한 추적 작업 호출(페이지 보기 없음)을 보냅니다.

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

      public static void Track ( string name, NSDictionary data);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Media.Track (settings.Name, null);
      

이 페이지에서는