使用 Microsoft Store Services SDK 與客戶互動

Microsoft市集服務 SDK 提供的功能可協助您與通用 Windows 平臺 （UWP） 應用程式中的客戶互動，例如將目標通知傳送至您的應用程式，以及在應用程式中執行 A/B 實驗。 此 SDK 是 Visual Studio 2015 和更新版本的 Visual Studio 延伸模組。

Microsoft Store Services SDK 支援的案例

Microsoft Store Services SDK 目前支援下列 UWP app 案例。 如需 API 參考檔，請參閱 Microsoft Store Services SDK API 參考。

先決條件

Microsoft Store Services SDK 需要：

• Visual Studio 2015 或更新版本。
• Visual Studio Tools for Universal Windows Apps 隨您的 Visual Studio 版本一起安裝。

安裝 SDK

在您的開發計算機上安裝 Microsoft Store Services SDK 有兩個選項：

• MSI 安裝程式 您可以在這裡透過 可用的 MSI 安裝程式安裝 SDK。
• NuGet 套件 您可以將 SDK 安裝為 NuGet 套件。

Microsoft會定期發行具有效能改進和新功能的 Microsoft Store Services SDK 新版本。 如果您有使用 SDK 且想要使用最新版本的現有專案，請在開發電腦上安裝最新版本的 SDK。

透過 MSI 安裝

若要透過 MSI 安裝程式安裝 Microsoft Store Services SDK：

1. 關閉 Visual Studio 的所有實例。

2. 如果您先前已安裝 Microsoft Store Engagement 和 Monetization SDK、Universal Ad Client SDK 或 Ad Mediator 擴充功能，請立即卸載這些 SDK。 或者，開啟 [命令提示字元 ] 視窗並執行下列命令，以清除任何可能已隨 Visual Studio 一起安裝的舊版 SDK 版本，但可能不會出現在您電腦上的已安裝程式清單中：

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. 下載並安裝 Microsoft Store Services SDK。 安裝可能需要幾分鐘的時間。 務必等到過程完成為止。

4. 重新啟動 Visual Studio。

5. 如果您有參考任何舊版 Microsoft Store Services SDK 的連結庫的現有專案，Microsoft Advertising SDK、通用 Ad 用戶端 SDK，或Microsoft Store Engagement and Monetization SDK，建議您在 Visual Studio 中開啟專案，然後清除並重建您的專案（在 方案總管中，以滑鼠右鍵單擊您的專案節點並選擇 [清除]，然後選擇 [ 清除] 然後再次以滑鼠右鍵按下您的項目節點，然後選擇 [ 重建]。

否則，如果您在專案中第一次使用 SDK，您現在已準備好 將元件參考新增至專案。

透過 NuGet 安裝

若要透過 NuGet 安裝 Microsoft Store Services SDK 連結庫：

1. 關閉 Visual Studio 的所有實例。

2. 如果您先前已安裝 Microsoft Store Engagement 和 Monetization SDK、Universal Ad Client SDK 或 Ad Mediator 擴充功能，請立即卸載這些 SDK。 或者，開啟 [命令提示字元 ] 視窗並執行下列命令，以清除任何可能已隨 Visual Studio 一起安裝的舊版 SDK 版本，但可能不會出現在您電腦上的已安裝程式清單中：

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. 啟動 Visual Studio，然後開啟您要在其中使用 Microsoft Store Services SDK 的專案。

   備註

   如果您的專案已經包含先前 MSI 安裝的 SDK 程式庫參考，請從專案中移除這些參考。 這些參考旁邊會有警告圖示，因為它們參考的連結庫已在先前的步驟中移除。

4. 在 Visual Studio 中，點選 專案 和 管理 NuGet 套件。

5. 在搜尋方塊中，輸入 Microsoft.Services.Store.Engagement ，並安裝 Microsoft.Services.Store.Engagement 套件。 當套件完成安裝時，請儲存您的解決方案。

   備註

   如果 [輸出 ] 視窗報告安裝 套件 錯誤，指出指定的路徑太長，您可能需要設定 NuGet，將套件擷取到路徑比預設位置短的替代位置。 若要這樣做，請將 repositoryPath 值新增至計算機上的 nuget.config 檔案，並將它指派給可擷取 NuGet 套件的簡短資料夾路徑。 如需詳細資訊，請參閱 NuGet 檔中 的這篇文章 。 或者，您也可以嘗試將 Visual Studio 專案移至具有較短路徑的替代資料夾。 問題也可能是因為您的全域套件路徑太長所造成。 在此情況下，請將 globalPackagesFolder 值新增至您的 nuget.config 檔案。

6. 關閉包含您專案的 Visual Studio 方案，然後重新開啟方案。

7. 如果您的專案已經參考透過 NuGet 安裝的舊版 Microsoft Store Services SDK 的連結庫，而且您已將專案更新為較新版本的 SDK，建議您清除並重建專案（在 方案總管中，以滑鼠右鍵按下您的專案節點，然後選擇 [ 清除]，然後再次以滑鼠右鍵按下您的專案節點，然後選擇 [ 重建]。

否則，如果您在專案中第一次使用 SDK，您現在已準備好 將元件參考新增至專案。

將組件參考新增至專案

透過 MSI 安裝程式或 NuGet 安裝 Microsoft Store Services SDK 之後，請遵循這些指示來參考 UWP 專案中的 SDK 元件。

1. 在 Visual Studio 中開啟您的專案。

   備註

   如果您的專案是以任何 CPU為目標的 JavaScript 應用程式，請將專案更新為使用架構特定的組建輸出（例如，x86）。

2. 在 [方案總管] 中，右鍵點擊 [參考]，然後選取 [新增參考...]

3. 在 參考管理員 中，展開 通用 Windows，按一下 擴充功能，然後選取 Microsoft Engagement Framework 旁的核取方塊。 這可讓您在 Microsoft.Services.Store.Engagement 命名空間中使用 API。

4. 按兩下 [確定]。

瞭解 SDK 中的架構套件

Microsoft Store Services SDK 中的 Microsoft.Services.Store.Engagement.dll 程式庫設置為 架構套件。 此連結庫包含 Microsoft.Services.Store.Engagement 命名空間中的 API。

因為此連結庫是架構套件，這表示在使用者安裝使用此連結庫的應用程式版本之後，每當我們發佈新版本的連結庫並具有修正和效能改善時，就會透過Windows Update 在其裝置上自動更新此連結庫。 這有助於確保您的客戶隨時在其裝置上安裝了最新可用的程式庫版本。

如果我們在此連結庫中發行引進新 API 或功能的新版本 SDK，您必須安裝最新版本的 SDK，才能使用這些功能。 在此案例中，您也需要將更新的應用程式發佈至市集。

相關主題

• Microsoft Store Services SDK API 參考
• 使用 A/B 測試執行實驗
• 從您的應用程式啟動意見反應中樞
• 設定您的應用程式以接收合作夥伴中心推播通知
• 記錄合作夥伴中心的自定義事件