開發人員快速入門

您將需要Visual Studio 2013或更新版本才能建置SDK。

取得SDK

在解壓縮 SDK下載後,您會針對每個支援的架構和平台組合,提供個別的資料夾。 您也會有檔 ADBMobileConfig.json 案,本指南稍後會說明。

選擇正確的版本

每個 .dll目標平 .winmd 台(Windows 8.1、Windows Phone 8.1)和支援的架構(x86、x64、ARM)都提供不同的檔案。 這些檔案根據以下內容分為資料夾結構:

重要

版本不 ADBMobile.winmd 反映庫的版本。 文 .winmd 件僅包含元資料,因此,根據Microsoft的 255.255.255.255 ,將具有可接受的行為版本號(請參見 How do I add assembly information for a WinRT C++ / CX component dll?)。若要檢查您使用的程式庫版本,請檢查基礎檔案的版 ADBMobile.dll 本。

語法差異

Windows 8.1 Universal App Store程式庫可用於數種程式設計語言。 本指南中的範例位於WinJS(JavaScript)中,如果您使用不同的語言,則可能需要加以修改。 請注意,當您從winJS(JavaScript)使用winmd方法時,所有方法都會自動將其第一個字母小寫。

實施之間的主要差異是用於上下文資料的資料結構。

此外,在WinJS專案中使用SDK時,請使用空字串( ""''),而非空 null 字串值。

將程式庫和設定檔案新增至您的專案- C Sharp

  1. 啟動Visual Studio並開啟您的解決方案。

  2. 在「解決方 案總管」中,以滑鼠右鍵按一下「 參考 」並選取「 新增參考」

  3. 選擇正確的程式庫版本,並瀏覽至相關的 ADBMobile.winmd 檔案。

    如需詳細資訊,請參 閱下方的「選擇正確版本 」一節。

  4. 按一下​新增

  5. 驗證是否在 ADBMobile.winmd 「參考管理器」( Reference Manager )窗口中選 定,然後按一下「​確定」(OK)。

    注意

    新增參考至Windows Phone應用程式時,若要選取, ADBMobile.winmd請將預設檔案篩選器從「元件檔案」 變更為「 所有檔案」

  6. 在「解決方 案總管」中,以滑鼠右鍵按一下「 參考 」並選取「 新增參考」

    如果您的解決方案中也有C++專案,請略過此步驟。

  7. 在左側的 Windows 標籤中,選取「 Extensions」,然後選取並新增適用於Windows的 Microsoft Visual C++ 2013 Runtime Package

  8. 將下列行添加到類中:

    using ADBMobile;
    
  9. 以滑鼠右鍵按一下您的專案,然後選 取「新增 >現 有項目」

  10. 瀏覽至您的 ADBMobileConfig.json 檔案,然後按一 下新增

  11. 在解決方案中 ADBMobileConfig.json 按一下右鍵檔案,然後選擇 屬性

  12. 將「建 立動作 」變更 為「內容」。

Add the library and config file to your project - C++

  1. 啟動Visual Studio並開啟您的解決方案。

  2. 在「解決 方案總管」中,以滑鼠右鍵按一下專案,然後選取「新增 >參 考」

  3. 選擇正確的庫版本,然後添加對關聯檔案的參 ADBMobile.winmd 考。

    如需詳細資訊,請參 閱下方的「選擇正確版本 」一節。

  4. 按一下​新增

  5. 在「參 考管理器 」(Reference Manager ADBMobile.winmd )窗口中,驗證是否已選 中並按一下「​確定」(OK)。

    小費

    新增參考至Windows Phone應用程式時,若要選取, ADBMobile.winmd請將預設檔案篩選器從「元件檔案」 變更為「 所有檔案」

  6. 將下列行添加到類中:

    using namespace ADMS::Measurement;
    
  7. 以滑鼠右鍵按一下您的專案,然後選 取「新增 >現 有項目」

  8. 瀏覽至檔案 ADBMobileConfig.json ,然後按一下「 新增」

  9. 在解決方案中 ADBMobileConfig.json 按一下右鍵檔案,然後選擇 屬性

  10. 在「一 」標籤上,將「內容 」變更為「」,然後單​擊「確定」。

Add the library and config file to your project - WinJS

  1. 啟動Visual Studio並開啟您的解決方案。

  2. 在「解決方 案總管」中,以滑鼠右鍵按一下「 參考 」並選取「 新增參考」

    如需詳細資訊,請參 閱下方的「選擇正確版本 」一節。

  3. 選擇正確的程式庫版本,然後瀏覽至相關的 ADBMobile.winmd 檔案。

  4. 按一下​新增

  5. 驗證是否 ADBMobile.winmd 已在「 Reference Manager (參考管理器)」窗口中選中,然後按一下「 OK(確定)」。

    小費

    新增參考至Windows Phone應用程式時,若要選取, ADBMobile.winmd請將預設檔案篩選器從「元件檔案」 變更為「 所有檔案」

  6. 在「解決方 案總管」中,以滑鼠右鍵按一下「 參考 」並選取「 新增參考」

    如果您的解決方案中也有C++專案,請略過此步驟。

  7. 在左側的 Windows 標籤中,選取「擴充功能 」並選取並新增 Microsoft Visual C++ 2013 Runtime Package for Windows

  8. 以滑鼠右鍵按一下您的專案,然後選 取「新增 >現 有項目」

  9. 瀏覽至檔案 ADBMobileConfig.json ,然後按一下「 新增」

  10. 在解決方案中 ADBMobileConfig.json] 按一下右鍵檔案,然後選擇 屬性

  11. 在選 取「檔案屬性 」時,請確 定「封裝動作 」已設 定為Content

    對於JavaScript專案,預設會將檔案設 定為 Content。

更新ADBMobileConfig.json設定檔案

ADBMobileConfig.json 案包含全域SDK設定,在您完成「將程式庫和設定檔案新增至專案」區段中的步驟後,就會位於您的專案根目錄 ** 。 如果您 ADBMobileConfig.json 的檔案未由Adobe Mobile Services預先設定,您必須更新一些值才能開始使用。

The following is an example of an ADBMobileConfig.json file:

{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 1 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

請至少更新您所使用之解決方案的下列值:

  • Analytics: rsidsserver
  • Target: clientCode
  • 讀者管理: server

如需詳細資訊,請 參閱ADBMobileConfig.json設定

為除錯

當您想要啟用SDK的除錯時,必須呼叫 ADBMobile.Config.setDebugLogging(true);

對於C Sharp和JS應用程式,您必須完成下列步驟以啟用原生程式碼除錯(原生程式碼除錯是C++應用程式的預設設定):

C Sharp

在專案上按一下滑鼠右鍵,選取「 屬性 >除 錯」標籤。 在除錯程式下拉式清單中,選取「僅 限原生」。

JS

按一下右鍵項目,選擇「屬 」>「配 置屬性>「調​試」頁籤。 將偵錯器類型下拉式清單變更為「僅 限原生」

完成了!您現在已準備好在Windows 8.1 Universal App Store應用程式中實作Analytics、Target和Audience Management。

本頁內容