Show Menu
主题×

Android方法

用于Experience Cloud解决方案4.x SDK的Xamarin组件的Android方法。

配置方法

  • 调试日志记录
    返回当前调试日志记录首选项,默认值为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;
      
      
  • 隐私状态
    返回当前用户隐私状态的枚举表示形式。
    • ADBMobilePrivacyStatus.OptIn - 立即发送点击。
    • ADBMobilePrivacyStatus.OptOut - 丢弃点击。
    • ADBMobilePrivacyStatus.Unknown - 如果启用了离线跟踪,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果未启用离线跟踪,则将丢弃点击,直到隐私状态更改为选择启用。
    The default value is set in the ADBMobileConfig.json file.
    • 以下是此方法的语法:
      public static MobilePrivacyStatus PrivacyStatus; 
      
      
    • 以下是此方法的代码示例:
      getter: var privacyStatus = Config.PrivacyStatus; 
      setter: Config.PrivacyStatus = MobilePrivacyStatus.MobilePrivacyStatusUnknown;
      
      
  • 用户标识符
    如果已设置自定义标识符,则返回此标识符。 如果未设置自定义标识符,则返回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(活动活动)
    (4.2或更高版本)向SDK表示应收集生命周期数据以用于SDK中的所有解决方案。 有关更多信息,请参阅 生命周期量度
    • 以下是此方法的语法:
      public static void collectLifecycleData(Activity activity); 
      
      
    • 以下是此方法的代码示例:
      Config.CollectLifecycleData (this);
      
      
  • CollectLifecycleData(活动活动)
    (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创建的通知的大图标。 此图标是用户在通知中心查看完整通知时显示的主要图像。
    • 以下是此方法的语法:
      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 方法

  • 跟踪标识符
    返回自动生成的Analytics ID。 这是在初始启动时生成、从该点开始存储和使用的特定于应用程序的唯一ID。 此ID在应用程序升级期间保留,并在卸载时删除。
    • 以下是此方法的语法:
      public static string TrackingIdentifier;
      
      
    • 以下是此方法的代码示例:
      Var trackingId = Analytics.TrackingIdentifier
      
      
  • TrackState
    通过可选的上下文数据跟踪应用程序状态。 States 是您的应用程序中可用的视图,如“标题屏幕”、“级别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, 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
    发送当前纬度和经度坐标。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(); 
      
      
  • 队列大小
    检索当前在脱机队列中的点击数。
    • 以下是此方法的语法:
      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 CloudID,您可以设置其他客户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
    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
    Convenience constructor to create an ADBTargetLocationRequest object with the given parameters.
    • 以下是此方法的语法:
      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
    清除应用程序中的目标cookie。
    • 以下是此方法的语法:
      public static void ClearCookies(); 
      
      
    • 以下是此方法的代码示例:
      Target.ClearCookies (); 
      
      

Audience Manager

  • 访客资料
    返回最近获取的访客资料。如果尚未提交任何信号,则返回零。 访客资料保存在 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
    设置 dpid dpuuid 。 如果 dpid 已设 dpuuid 置,则每个信号都会发送。
    • 以下是此方法的语法:
      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());
      
      
  • 重置
    Resets audience manager UUID and purges current visitor profile.
    • 以下是此方法的语法:
      public static void Reset ();
      
      
    • 以下是此方法的代码示例:
       AudienceManager.Reset ();
      
      

视频

有关视频分析的更多信息,请参 阅视频分析
  • 媒体设置
    通过指定的参数返回 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"); 
      
      
  • Open
    打开 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); 
      
      
  • 完成
    在提供的“offset”时间(以秒为单位)将媒体项目手动标记为完成。
    • 以下是此方法的语法:
      public static void Complete (string name, double offset); 
      
      
    • 以下是此方法的代码示例:
      Media.Complete (settings.Name, 5); 
      
      
  • 停止
    通知媒体模块已在给定的“offset”时间停止或暂停视频。
    • 以下是此方法的语法:
      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);