Show Menu
화제×

Android methods

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

Configuration methods

  • 디버그 로깅
    현재 디버그 로깅 기본 설정을 반환하고 기본값은 false입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static Boolean DebugLogging;
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      getter: var debuglog = Config.DebugLogging;
      setter: Config.DebugLogging = (Java.Lang.Boolean)true;
      
      
  • LifetimeValue
    현재 사용자의 수명 값을 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      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
    사용자 지정 식별자가 설정된 경우 이 식별자를 반환합니다. If a custom identifier is not set, returns null. 기본값은 null 입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static UserIdentifier();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      getter: var userId = Config.UserIdentifier;
      setter: Config.UserIdentifier = "imBatman";
      
      
  • 버전
    라이브러리 버전을 가져옵니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string Version;
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var version = ADBMobile.Version;
      
      
  • PauseCollectingLifecycleData
    라이프사이클 지표를 정확히 계산하기 위해 앱이 일시 중지되었음을 SDK에 표시합니다. 예를 들어, OnPause에서 타임스탬프를 수집하여 기존 세션 길이를 파악합니다. 플래그를 설정하여 앱이 충돌하지 않았음을 라이프사이클에서 정확히 알도록 할 수도 있습니다. 자세한 내용은 라이프사이클 지표 를 참조하십시오.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void PauseCollectingLifecycleData (); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      Config.PauseCollectingLifecycleData();
      
      
  • CollectLifecycleData(Activity 활동)
    (4.2 이상 버전) SDK의 솔루션 전체에서 사용하기 위해 라이프사이클 데이터를 수집해야 함을 SDK에 표시합니다. 자세한 내용은 라이프사이클 지표 를 참조하십시오.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void collectLifecycleData(Activity activity); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      Config.CollectLifecycleData (this);
      
      
  • CollectLifecycleData(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 or later) Lets you load a different ADBMobile JSON config file when the application starts. 애플리케이션이 닫힐 때까지 다른 구성을 사용합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void OverrideConfigStream (Stream stream);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      Stream st1 = Assets.Open ("ADBMobileConfig-2.json"); 
      Config.OverrideConfigStream (st1); 
      
      
  • SetLargeIconResourceId(int resourceId)
    (4.2 이상 버전) SDK에서 만든 알림에 사용되는 큰 아이콘을 설정합니다. This icon is the primary image that is displayed when the user sees the complete notification in the notification center.
    • 다음은 이 메서드에 대한 구문입니다.
      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 methods

  • TrackingIdentifier
    분석을 위해 자동으로 생성된 ID를 반환합니다. This is an app-specific unique ID that is generated on initial launch and is stored and used from that point forward. 이 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
    앱의 작업을 추적합니다. 작업은 "예기치 못한 종료", "획득 레벨", "피드 구독" 및 기타 지표 등 측정하려는 앱에서 발생하는 일을 의미합니다.
    If you have code that might run while the app is in the background (for example, a background data retrieval), use trackActionFromBackground instead.
    • 다음은 이 메서드에 대한 구문입니다.
      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
    현재 위도 및 경도 좌표를 보냅니다. Also uses points of interest defined in the ADBMobileConfig.json file to determine whether the location that was provided as a parameter is in any of your POIs. 정의된 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(); 
      
      
  • QueueSize
    현재 오프라인 큐에 있는 히트 수를 검색합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static long QueueSize(); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var queueSize = Analytics.QueueSize();
      
      

Experience Cloud ID methods

  • 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 methods

  • LoadRequest
    Sends a request to your configured Target server and returns the string value of the offer generated in a Action<NSDictionary> callback.
    • 다음은 이 메서드에 대한 구문입니다.
      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
    Creates an . 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
    Returns the current DPID .
    • 다음은 이 메서드에 대한 구문입니다.
      public static string Dpuuid; 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      string currentDpid = AudienceManager.Dpid;
      
      
  • Dpuuid
    Returns the current DPUUID .
    • 다음은 이 메서드에 대한 구문입니다.
      public static string AudienceDpuuid; 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      string currentDpuuid = AudienceManager.Dpuuid;
      
      
  • AudienceSetDpidAndDpuuid
    Sets the and . dpid``dpuuid If dpid and dpuuid are set, they are sent with each signal.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void AudienceSetDpidAndDpuuid (string Dpid, String Dpuuid);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      AudienceManager.SetDpidAndDpuuid ("testDpid", "testDpuuid");
      
      
  • SignalWithData
    Sends audience management a signal with traits and get the matching segments returned in a Action<NSDictionary> callback.
    • 다음은 이 메서드에 대한 구문입니다.
      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 ();
      
      

비디오

비디오 분석에 대한 자세한 내용은 비디오 분석을 참조하십시오 .
  • 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) 
      {
      }
      }
      
      
  • 닫기
    이름이 명명된 미디어 항목을 닫습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void Close(string name);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      Media.Close (settings.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);