Show Menu
主题×

Analytics methods

此信息可帮助您将 Windows 8.1 通用应用商店 SDK 与 Adobe Analytics 配合使用。
SDK目前支持多个Adobe Experience cloud解决方案],包括Analytics]、Target]和Audience Manager]。 方法将根据解决方案来添加前缀。Analytics 方法具有“Analytics”前缀。
下面每个方法均可用来将数据发送至 Adobe Analytics 报表包。
When you consume winmd methods from winJS (JavaScript), all methods automatically have their first letter lowercased.
  • TrackState(winJS:trackState)
    通过可选的上下文数据跟踪应用程序状态。状态是指您的应用程序中提供的各种视图,例如“主页功能板”、“应用程序设置”、“购物车”等。这些状态与网站中的页面类似,而且 TrackState 调用会使页面查看次数递增。如果 state 为空,它会在报表中显示为“应用程序名称 应用程序版本 (内部版本)”。如果您在报表中看到该值,请确保在每个 state 调用中设置 TrackState
    This is the only tracking call that increments page views.
    • 下面是这种方法对应的语法:
      static void TrackState(Platform::String ^state, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData); 
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile;
      ADB.Analytics.trackState("loginScreen", null);
      
      
  • TrackAction(winJS:trackAction)
    跟踪您的应用程序中的操作。操作是指您的应用程序中发生的要测量的事件,例如“登录”、“横幅点按”、“信息源订阅”及其他量度。
    • 下面是这种方法对应的语法:
      static void TrackAction(Platform::String ^action, Windows::Foundation::Collections::IMap <Platform::String^, Platform::Object> ^contextData);
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      ADB.Analytics.trackAction("Button Click", null); 
      
      
  • GetTrackingIdentifierAsync(winJS:getTrackingIdentifierAsync)
    返回自动为 Analytics 生成的访客标识符。这是一个应用程序特定的唯一访客 ID,在初次启动时生成,随后进行存储并一直使用下去。此 ID 会在应用程序升级期间保留,并在应用程序卸载后删除。
    • 下面是这种方法对应的语法:
      static Windows::Foundation::IAsyncOperation<Platform::String^> ^GetTrackingIdentifierAsync(); 
      
      
    • 以下是这种方法的代码示例:
      var trackingIdentifier; 
      ADBMobile.Analytics.getTrackingIdentifierAsync().then(function (trackingid) { 
         trackingIdentifier = trackingid; 
      });
      
      
  • TrackLocation(winJS:trackLocation)
    发送当前的 x y 坐标。此方法还使用 ADBMobileConfig.json 文件中定义的目标点来确定作为参数提供的位置是否位于您的任何 POI 内。如果当前坐标位于定义的 POI 内,则会填充上下文数据变量,并随 trackLocation 调用发送该变量。
    • 下面是这种方法对应的语法:
      static void TrackLocation(double lat, double lon, double accuracy, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      ADB.Analytics.trackLocation(47.60621, -122.33207, null);
      
      
  • TrackLifetime​价值增加(winJS:trackLifetime ​ ValueIncrease)
    向用户的生命周期值中添加 amount
    • 下面是这种方法对应的语法:
      static void TrackLifetimeValueIncrease(float amount, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData); 
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      ADB.Analytics.trackLifetimeValueIncrease(10, null); 
      
      
  • TrackTimed​ActionStart (winJS: trackTimed​ActionStart)
    启动名为 action 的定时操作。如果对已启动的操作调用此方法,则将覆盖上一个定时操作。
    这个调用不发送点击。
    • 下面是这种方法对应的语法:
      static void TrackTimedActionStart(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      ADB.Analytics.trackTimedActionStart("cartToCheckout", null); 
      
      
  • TrackTimed ​ ActionUpdate(winJS:trackTimed ​ ActionUpdate)
    传入 contextData ,以更新与给定 action 关联的上下文数据。The data passed is appended to the existing data for the given action, and overwrites the data if the same key is already defined for action .
    这个调用不发送点击。
    • 下面是这种方法对应的语法:
      static void TrackTimedActionUpdate(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData); 
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      var contextData = new Windows.Foundation.Collections.PropertySet(); 
      contextData["quantity"] = 3; 
      ADB.Analytics.trackTimedActionUpdate("cartToCheckout", contextData); 
      
      
  • TrackTimedActionExistsAsync(winJS:trackTimedActionExistsAsync)
    如果存在给定的定时操作,则返回 true;如果不存在给定的定时操作,则返回 false。
    • 下面是这种方法对应的语法:
      static Windows::Foundation::IAsyncOperation<bool> ^TrackTimedActionExistsAsync(Platform::String ^action); 
      
      
    • 以下是这种方法的代码示例:
      ADBMobile.Analytics.trackTimedActionExistsAsync("signUp").then(function (exists) { 
          actionExists = exists; 
      });
      
      
  • TrackTimed ​ ActionEnd(winJS:trackTimed ​ ActionEnd)
    结束定时操作。
    • 下面是这种方法对应的语法:
      static void TrackTimedActionEnd(Platform::String ^action);
      
      
    • 以下是这种方法的代码示例:
      var ADB = ADBMobile; 
      ADB.Analytics.trackTimedActionEnd("cartToCheckout"); 
      
      
  • ClearTrackingQueue(winJS:clearTrackingQueue)
    清除 Analytics 跟踪队列中所有存储的点击。
    • 以下是此消息的语法:
      static void ClearTrackingQueue();
      
      
    • 以下是代码示例:
      ADBMobile.Analytics.clearTrackingQueue();
      
      
  • GetQueueSizeAsync(winJS:getQueueSizeAsync)
    返回 Analytics 队列中当前存储的点击量。
    • 下面是这种方法对应的语法:
      static Windows::Foundation::IAsyncOperation<int> ^GetQueueSizeAsync();
      
      
    • 以下是这种方法的代码示例:
      var queueSize; 
      ADBMobile.Analytics.getQueueSizeAsync().then(function (size) { 
          queueSize = size; 
      });