Show Menu
화제×

iOS 메서드

experience cloud 솔루션 4.x SDK용 Xamarin 구성 요소에 대한 iOS 메서드입니다.

구성 메서드

  • CollectLifecycleData
    SDK의 솔루션 전체에서 사용하기 위해 라이프사이클 데이터를 수집해야 함을 SDK에 표시합니다. 자세한 내용은 라이프사이클 지표 를 참조하십시오.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void CollectLifecycleData();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.CollectLifecycleData();
      
      
  • 디버그 로깅
    현재 디버그 로깅 기본 설정을 반환합니다. 기본값은 false 입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static bool DebugLogging(); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var debugEnabled = ADBMobile.DebugLogging();
      
      
  • SetDebugLogging
    디버그 로깅 기본 설정을 활성화됨으로 설정합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void SetDebugLogging(bool enabled);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.SetDebugLogging(true);
      
      
  • 라이프타임 값
    현재 사용자의 수명 값을 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static double LifetimeValue();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var lifetimeValue = ADBMobile.LifetimeValue();
      
      
  • 개인 정보 상태
    현재 사용자에 대한 개인 정보 상태의 열거 표현을 반환합니다.
    • ADBMobilePrivacyStatus.OptIn - 히트가 즉시 전송됩니다.
    • ADBMobilePrivacyStatus.OptOut - 히트가 삭제됩니다.
    • ADBMobilePrivacyStatus.Unknown - 오프라인 추적이 활성화되면 개인 정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트가 삭제됨)으로 변경될 때까지 히트가 저장됩니다. 오프라인 추적이 비활성화되면 개인 정보 상태가 옵트인으로 변경될 때까지 히트가 무시됩니다.
    The default value is set in the ADBMobileConfig.json .
    • 다음은 이 메서드에 대한 구문입니다.
      public static ADBPrivacyStatus PrivacyStatus();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var privacyStatus = ADBMobile.PrivacyStatus();
      
      
  • SetPrivacyStatus
    현재 사용자의 개인 정보 상태를 상태로 설정합니다. 다음 값 중 하나를 설정합니다.
    • ADBMobilePrivacyStatus.OptIn - 히트가 즉시 전송됩니다.
    • ADBMobilePrivacyStatus.OptOut - 히트가 삭제됩니다.
    • ADBMobilePrivacyStatus.Unknown - 오프라인 추적이 활성화되면 개인 정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다. 오프라인 추적이 비활성화되면 개인 정보 상태가 옵트인으로 변경될 때까지 히트가 무시됩니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void SetPrivacyStatus(ADBPrivacyStatus status) 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.SetPrivacyStatus(ADBMobilePrivacyStatus.OptIn); 
      
      
  • 사용자 식별자
    사용자 지정 식별자가 설정된 경우 사용자 지정 사용자 식별자를 반환합니다. 사용자 지정 식별자가 설정되지 않은 경우 null을 반환합니다. 기본값은 null 입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string UserIdentifier(); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var userId = ADBMobile.UserIdentifier(); 
      
      
  • SetUserIdentifier
    사용자 지정 식별자가 설정된 경우 사용자 지정 사용자 식별자를 반환합니다. 사용자 지정 식별자가 설정되지 않은 경우 null을 반환합니다. 기본값은 null 입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string UserIdentifier();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.SetUserIdentifier ("customUserIdentifier”); 
      
      
  • GetVersion
    라이브러리 버전을 가져옵니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string Version();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var version = ADBMobile.Version();
      
      
  • KeepLifecycleSessionAlive(iOS만 해당)
    구성 파일의 라이프사이클 세션 시간 제한 값과 상관없이 다음 번에 백그라운드에서 세션이 다시 시작할 때 새 세션이 시작하지 않아야 함을 SDK에 표시합니다.
    이 메서드는 앱이 백그라운드에 있을 때 알림을 등록하는 앱에 사용하기 위한 것으로 앱이 백그라운드에 있을 때 실행하는 코드에서만 호출되어야 합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void KeepLifecycleSessionAlive();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.KeepLifecycleSessionAlive();
      
      

Analytics 메서드

  • TrackingIdentifier
    분석 추적 식별자를 검색합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string TrackingIdentifier();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var trackingId = ADBMobile.TrackingIdentifier();
      
      
  • TrackState
    선택적 컨텍스트 데이터로 앱 상태를 추적합니다. 상태는 "제목 화면", "레벨 1", "일시 중지" 등과 같이 앱에서 사용할 수 있는 보기입니다. 이러한 상태는 웹 사이트의 페이지와 유사하며 증가 페이지 보기를 TrackState 호출합니다. 상태가 비어있으면 보고서에 "앱 이름 앱 버전(빌드)"으로 표시됩니다. If you see this value in reports, make sure you are setting state in each TrackState call.
    페이지 보기 횟수를 늘리는 유일한 추적 호출입니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackState(string state, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary contextData; 
       contextData = NSDictionary.FromObjectAndKey (NSObject.FromObject("val"),NSObject.FromObject("key")); 
        ADBMobile.TrackState("title screen", contextData); 
      
      
  • TrackAction
    앱의 작업을 추적합니다. 작업은 "죽음", "획득 레벨", "피드 구독" 및 기타 지표 등 측정하려는 앱에서 발생하는 일들입니다.
    백그라운드에 앱이 있을 때 실행할 수 있는 코드가 있는 경우(예: 백그라운드 데이터 검색) trackActionFromBackground 를 대신 사용합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackAction(string action, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackAction("level gained", null); 
      
      
  • TrackActionFromBackground(iOS만 해당)
    백그라운드에서 발생한 작업을 추적합니다. 특정 시나리오에서 라이프사이클 이벤트가 실행되지 않습니다.
    이 메서드는 백그라운드에 앱이 있을 때 실행되는 코드에서만 호출해야 합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackActionFromBackground(string action, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackActionFromBackground("majorLocationChange", null);
      
      
  • TrackLocation
    현재 위도 및 경도 좌표를 보냅니다. 또한 ADBMobileConfig.json 파일에서 정의된 관심 영역을 사용하여 매개변수로 제공된 위치가 POI 내에 있는지 파악합니다. 현재 좌표가 정의된 POI 내에 있을 경우 컨텍스트 데이터 변수를 채워 TrackLocation 호출로 보냅니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackLocation(CLLocation location, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      CoreLocation.CLLocation l = new CoreLocation.CLLocation  (111.111, 44.156);
      ADBMobile.TrackLocation (l, null);
      
      
  • TrackBeacon
    사용자가 비콘 근접 위치에 들어오면 추적합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackBeacon( CLBeacon beacon, NSDictionary cdata);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      CoreLocation.CLBeacon beacon = new CoreLocation.CLBeacon (); 
      ADBMobile.TrackBeacon (beacon, null);
      
      
  • TrackingClearCurrentBeacon
    사용자가 비콘 근접 위치를 떠난 후 비콘 데이터를 지웁니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackingClearCurrentBeacon();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackingClearCurrentBeacon();
      
      
  • TrackLifetimeValueIncrease
    사용자의 라이프타임 값에 금액을 추가합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public nbsp;static void TrackLifetimeValueIncrease(double amount, NSDictionary data);
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackLifetimeValueIncrease(5, null); 
      
      
  • TrackTimedActionStart
    이름 작업으로 시간 제한 작업을 시작합니다. 이미 시작한 작업에 대해 이 메서드를 호출하는 경우 이전 시간 제한 작업을 덮어씁니다.
    이 호출은 히트를 전송하지 않습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackTimedActionStart(string action, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackTimedActionStart("level2", null);
      
      
  • TrackTimedActionUpdate
    데이터를 전달하여 주어진 작업과 연관된 컨텍스트 데이터를 업데이트합니다. 전달된 데이터는 주어진 작업의 기존 데이터에 추가되며 작업에 대해 동일한 키가 이미 정의된 경우 데이터를 덮어씁니다.
    이 호출은 히트를 전송하지 않습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackTimedActionUpdate(string action, NSDictionary cdata); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary updatedData = NSDictionary.FromObjectAndKey (NSObject.FromObject("val2"), NSObject.FromObject ("key2")); 
        ADBMobile.TrackTimedActionUpdate("level2", updatedData); 
      
      
  • TrackTimedActionEnd
    시간 제한 작업을 종료합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TrackTimedActionEnd(string action, Func<double, double, NSMutableDictionary, sbyte> block); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackTimedActionEnd  ("level2", (double  arg1,  double  arg2,  NSMutableDictionary  arg3)  =>  { 
      return  Convert.ToSByte(true); 
      });
      
      
  • TrackingTimedActionExists
    시간 제한 작업이 진행 중인지 또는 진행 중인지 여부를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static bool TrackingTimedActionExists(string action); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TrackTimedActionEnd  ("timedAction",  (double  inAppDuration, 
      double  totalDuration,  NSMutableDictionary  data)  =>  { 
                   return  true; 
      });
      
      
  • 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 methods

  • GetMarketingCloudID
    ID 서비스에서 Experience Cloud ID를 검색합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string GetMarketingCloudID(); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      var mcid = ADBMobile.GetMarketingCloudID();
      
      
  • 방문자 동기화 식별자
    Experience Cloud ID를 사용하여 각 방문자와 연결할 추가 고객 ID를 설정할 수 있습니다. 방문자 API는 서로 다른 고객 ID의 범위를 구분하기 위해 동일한 방문자에 대한 여러 고객 ID와 고객 유형 식별자를 수락합니다. 이 메서드는 JavaScript 라이브러리의 setCustomerID에 해당합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void VisitorSyncIdentifiers(NSDictionary identifiers);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary  ids  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("pushID")); 
      ADBMobile.VisitorSyncIdentifiers(ids); 
      
      

Target 메서드

  • TargetLoadRequest
    Sends request to your configured Target server and returns the string value of the offer generated in a Action<NSDictionary> callback.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TargetLoadRequest (ADBTargetLocationRequest request, Action<NSString> callback); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary  dict  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1")); 
      ADBTargetLocationRequest  req  =  ADBMobile.TargetCreateRequest  ("iOSTest",  "defGal",  dict); 
      ADBMobile.TargetLoadRequest(req,    (context)  =>  { 
      Console.WriteLine  (context); 
      });
      
      
  • TargetCreateRequest
    Convenience constructor to create an ADBTargetLocationRequest object with the given parameters.
    • 다음은 이 메서드에 대한 구문입니다.
      public static ADBTargetLocationRequest ADBTargetLocationRequest TargetCreateRequest (string name, string defaultContent, NSDictionary parameters); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary  dict  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1")); 
      ADBTargetLocationRequest  req  =  ADBMobile.TargetCreateRequest  ("iOSTest",  "defGal",  dict); 
      
      
  • TargetCreateOrderConfirmRequest
    ADBTargetLocationRequest 를 생성합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static ADBTargetLocationRequest ADBTargetLocationRequest TargetCreateRequest (string name, string defaultContent, NSDictionary parameters);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TargetCreateOrderConfirmRequest ("myOrder", "12345", "29.41", "cool stuff", null); 
      
      
  • TargetClearCookies
    앱에서 모든 타겟 쿠키를 지웁니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void TargetClearCookies(); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.TargetClearCookies(); 
      
      

Audience Manager

  • AudienceVisitorProfile
    가장 최근 획득한 방문자 프로필을 반환합니다. 아직 신호가 전송되지 않은 경우 nil을 반환합니다. Visitor profile is saved in NSUserDefaults for easy access across multiple launches of your app.
    • 다음은 이 메서드에 대한 구문입니다.
      public static NSDictionary AudienceVisitorProfile (); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary profile = ADBMobile.AudienceVisitorProfile();
      
      
  • AudienceDpid
    현재 DPID를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string AudienceDpid ();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      string currentDpid = ADBMobile.AudienceDpid();
      
      
  • AudienceDpuuid
    현재 DPUUID를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static string AudienceDpuuid ();
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      string currentDpuuid = ADBMobile.AudienceDpuuid(); 
      
      
  • AudienceSetDpidAndDpuuid
    dpid 및 dpuuid를 설정합니다. dpid 및 dpuuid가 설정되면 각 신호와 함께 전송됩니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void AudienceSetDpidAndDpuuid (NSDictionary data, Action<NSDictionary> callback); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.AudienceSetDpidAndDpuuid ("testDppid", "testDpuuid")
      
      
  • AudienceSignalWithData
    Sends audience management a signal with traits and get the matching segments returned in a Action<NSDictionary> callback.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void AudienceSignalWithData (NSDictionary data, Action<NSDictionary> callback); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSDictionary  audienceData  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1")); 
      ADBMobile.AudienceSignalWithData  (audienceData,  (context)  =>  { 
      Console.WriteLine  (context); 
      }); 
      
      
  • AudienceReset
    Audience Manager UUID를 재설정하고 현재 방문자 프로필을 삭제합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void AudienceReset ();
      
      
    • 다음은 이 메서드에 대한 구문입니다.
      ADBMobile.AudienceReset ();
      
      

비디오

  • MediaCreateSettings
    지정된 매개 변수와 함께 ADBMediaSettings 개체를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static ADBMediaSettings MediaCreateSettings ([string name, double length, string playerName, string playerID); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMediaSettings settings = ADBMobile.MediaCreateSettings ("name1", 10, "playerName1", "playerID1"); 
      
      
  • MediaAdCreateSettings
    광고 비디오 추적에 사용할 ADBMediaSettings 개체를 반환합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static ADBMediaSettings MediaAdCreateSettings ( string name,  double length,  string playerName,  string parentName,  string parentPod,  double parentPodPosition,  string CPM); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMediaSettings adSettings = ADBMobile.MediaAdCreateSettings("adName1", 2, "playerName1", "name1", "podName1", 4, "CPM1");
      
      
  • MediaOpenWithSettings
    추적을 위해 ADBMediaSettings 개체를 엽니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaOpenWithSettings ( ADBMediaSettings settings,  Action<ADBMediaState> callback); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMediaSettings settings = ADBMobile.MediaCreateSettings  ("name1",  10,  "playerName1",  "playerID1"); 
      ADBMobile.MediaOpenWithSettings  (settings,  (state)  =>  { 
      Console.WriteLine  (state.Name); 
      }); 
      
      
  • MediaClose
    이름이 name인 미디어 항목을 닫습니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaClose ( string name);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.MediaClose  (settings.Name);
      
      
  • MediaPlay
    제공된 offset(초)에서 이름이 name인 미디어 항목을 재생합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaPlay ( string name, double offset);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.MediaPlay (settings.Name, 0); 
      
      
  • MediaComplete
    제공된 오프셋(초)에서 완료된 미디어 항목을 수동으로 표시합니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaComplete ( string name, double offset);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.MediaComplete (settings.Name, 5);
      
      
  • MediaStop
    제공된 오프셋에서 비디오가 중지 또는 일시 중지되었음을 미디어 모듈에 알립니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaStop ( string name, double offset);
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      ADBMobile.MediaStop (settings.Name, 3);
      
      
  • MediaClick
    미디어 항목이 클릭되었음을 미디어 모듈에 알립니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaClick ( string name, double offset); 
      
      
  • MediaTrack
    현재 미디어 상태에 대한 추적 작업 호출(페이지 보기 없음)을 보냅니다.
    • 다음은 이 메서드에 대한 구문입니다.
      public static void MediaTrack ( string name, NSDictionary data); 
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
       ADBMobile.MediaTrack (settings.Name, null);