Show Menu
主題×

Analytics methods

此資訊可協助您將 Windows 8.1 通用應用程式商店 SDK 與 Adobe Analytics 搭配使用。
The SDK currently has support for multiple Adobe Experience Cloud Solutions], including Analytics], Target], and 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 空白,在報表中會顯示為 "app name app version (build)"。如果在報表中看到此值,請務必在每個 state 呼叫中設定 TrackState
    這是唯一會增加頁面檢視次數的追蹤呼叫。
    • 以下是此方法的語法:
      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​ValueIncrease (winJS: trackLifetime​ValueIncrease)
    Adds amount to the user's lifetime value.
    • 以下是此方法的語法:
      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 追蹤佇列中所有儲存的點擊。
    • Here is the syntax for this message:
      static void ClearTrackingQueue();
      
      
    • Here is the code sample:
      ADBMobile.Analytics.clearTrackingQueue();
      
      
  • GetQueueSizeAsync(winJS:getQueueSizeAsync)
    傳回 Analytics 佇列中目前儲存的點擊數量。
    • 以下是此方法的語法:
      static Windows::Foundation::IAsyncOperation<int> ^GetQueueSizeAsync();
      
      
    • 以下是此方法的範例程式碼:
      var queueSize; 
      ADBMobile.Analytics.getQueueSizeAsync().then(function (size) { 
          queueSize = size; 
      });