Microsoft Advertising 沙盒

Microsoft Advertising 提供 API 沙箱環境，您可以在其中測試應用程式，再將其部署至生產環境。 不會提供您在沙箱中建立的廣告。 沙箱中支持的服務與生產環境不同。 若要取得支援服務的Web服務位址，請參閱 Bing 廣告 API Web 服務位址。

注意事項

沙箱可能會關閉以進行維護，無論是否事先通知。

初始客戶註冊

沙箱和生產環境會使用個別的認證。

請遵循下列步驟來取得新的沙箱客戶。 如果您已經有沙盒客戶，而且想要新增使用者，例如使用 Microsoft 帳戶認證，您可以跳到 使用者邀請 步驟。

1. 開啟瀏覽器並瀏覽至 https://sandbox.bingads.microsoft.com?simpsp=true。

2. 按兩下 [註冊 Microsoft Advertising] 或 [立即註冊]

3. 選 取 [建立新的電子郵件位址 ] 以建立 MSA。 請勿使用現有的電子郵件位址。

4. 按一下[下一步]

5. 輸入 MSA 電子郵件位址。 電子郵件伺服器必須是 outlook-int.com (例如， someone@outlook-int.com) 。

   重要事項

   沙箱僅支援使用 outlook-int.com 電子郵件帳戶建立的 MSA。 您不能使用 outlook.com 電子郵件帳戶。 此外，您可能不會使用另一個電子郵件服務 (的電子郵件帳戶，例如， @contoso.com) 即使帳戶已連結至 outlook.com 或 outlook-int.com 電子郵件帳戶也一樣。

6. 指定其餘的使用者和安全性資訊，以完成 MSA 工作流程。 接著，系統會將您重新導向至 Microsoft Advertising，以繼續沙盒客戶和帳戶註冊。

7. 填寫 [建立帳戶] 窗體

8. 針對 [匯入/建立活動]，按兩下 [略過營銷活動建立]

9. 針對 [上線]，按兩下 [略過付款資訊]

邀請更多使用者

若要在沙箱中 向 OAuth 進行驗證 ，您需要使用沙箱 Microsoft 帳戶 (MSA) 。 如果您的沙盒客戶尚未透過 Microsoft 帳戶擁有使用者認證，您必須透過下列步驟邀請使用者使用 沙盒 帳戶。

1. 在 Microsoft Advertising 沙箱中，按兩下右上角 (用戶名稱)

2. 按兩下 [帳戶 & 計費]

3. 按兩下 [使用者]

4. 按兩下 [邀請使用者]

5. 輸入要邀請之使用者的電子郵件位址。 電子郵件伺服器必須 outlook.com (例如， someone@outlook.com) 。

   重要事項

   您只能將邀請傳送至 outlook.com 電子郵件帳戶。 即使帳戶已連結至 outlook.com 電子郵件帳戶，您也可能不會將邀請傳送至任何其他網域。 例如， someone@contoso.com 如果您嘗試將邀請傳送至另一個網域 (例如，) ，BingAds UI 會將邀請顯示為無限期擱置， (邀請永遠不會傳送) 。

6. 按兩下 [傳送]

Microsoft Advertising 會傳送電子郵件邀請給使用者。 如果邀請未顯示在收件匣中，請核取 [垃圾 Email] 資料夾。 可能需要幾分鐘的時間才能收到邀請。 下列步驟示範如何接受邀請。

1. 開啟來自 Microsoft Advertising 的電子郵件，主旨列為 Microsoft Advertising 的邀請

2. 按兩下內嵌連結

3. 選 取 [建立新的電子郵件位址 ] 以建立 MSA。 請勿使用現有的電子郵件位址。

4. 按一下[下一步]

5. 輸入 MSA 電子郵件位址。 電子郵件伺服器必須是 outlook-int.com (例如， someone@outlook-int.com) 。

   重要事項

   沙箱僅支援使用 outlook-int.com 電子郵件帳戶建立的 MSA。 您不能使用 outlook.com 電子郵件帳戶。 此外，您可能不會使用另一個電子郵件服務 (的電子郵件帳戶，例如， @contoso.com) 即使帳戶已連結至 outlook.com 或 outlook-int.com 電子郵件帳戶也一樣。

6. 指定其餘的使用者資訊以完成工作流程

7. 完成 MSA 程式之後結束 Microsoft Advertising。

注意事項

MSA 註冊程式會將您傳回 SI Microsoft Advertising 用戶介面 (ui.si.bingads.microsoft.com) 。 完成 MSA 程式之後，註銷 SI 介面，然後使用您在 的新 outlook-int.com 電子郵件地址登入 https://secure.sandbox.bingads.microsoft.com/。

取得 API 存取

沙箱和生產環境會使用個別的認證。

針對沙箱環境，以 取代https://login.microsoftonline.com/commonhttps://login.windows-ppe.net/consumers

下表包含其他沙箱端點。

描述	生產環境	沙箱
OAuth 要求的端點	login.microsoftonline.com	login.windows-ppe.net
取得 Microsoft 帳戶時所使用電子郵件的網域	任何電子郵件位址	outlook-int.com
變更 Microsoft 帳戶密碼的端點	account.live.com/password/change	account.live-int.com/password/change

雖然在生產環境中，您必須使用自己的開發人員令牌，但所有 Microsoft Advertising 客戶都可以在沙箱中使用下列通用開發人員令牌。

BBD37VB98

雖然在生產環境中，您必須使用自己的應用程式標識碼 (也即用戶端標識碼) ，但所有 Microsoft Advertising 客戶都可以在沙箱中使用下列公用應用程式識別符。 「教學課程範例應用程式」用戶端識別碼僅限於桌面或控制台應用程式，無法與 Web 應用程式中的任何用戶端密碼搭配使用。

4c0b021c-00c3-4508-838f-d3127e8167ff

現在您可以取得 Microsoft Advertising 使用者的存取和重新整理令牌，並使用 Bing 廣告 API 進行您的第一個服務呼叫，請參閱 快速入門 指南。

提示

如需如何使用 Bing 廣告 SDK 取得存取和重新整理令牌的詳細資訊，請參閱 使用 SDK 進行驗證。

沙箱最佳做法

沙箱不應用於與生產環境相同的容量。

• 請確定當您將應用程式部署至生產環境時，您會使用生產 WSDL 和生產認證。
• 沙箱包含目前的生產版本，無論是否事先通知，都會以功能預覽進行更新。
• 沙箱的容量小於生產環境的容量，您不應該使用它來執行壓力或容量測試。
• 請勿使用多個線程。

Ad Insight Service

沙箱支援一組有限的關鍵詞來測試 Ad Insight 服務作業。 您不應該使用測試數據來推斷或預期生產環境中關鍵詞的類似估計值。 下表說明一些限制。

提示

在生產環境中使用 Ad Insight 服務，而不是沙箱。 沙箱只提供生產服務作業的子集，而深入解析數據會落後生產環境。 沙盒商機數據會在每個週末重新整理和更新，並且在星期一推出。 沙箱中的關鍵詞構想數據可能會落後生產環境數個月。 如果作業因為日期範圍無效而失敗，請嘗試以較早的日期範圍再次提交要求。

服務作業	沙箱限制
GetBidLandscapeByKeywordIds	不支援。 您可以使用現有的關鍵詞標識碼來呼叫作業，但不會傳回任何數據。
GetEstimatedBidByKeywordIds	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。
GetEstimatedBidByKeywords	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。
GetEstimatedPositionByKeywordIds	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 為了增加取得估計的機率， MaxBid 元素應該大於或等於5美元，或是其他貨幣的對等專案。
GetEstimatedPositionByKeywords	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 為了增加取得估計的機率， MaxBid 元素應該大於或等於5美元，或是其他貨幣的對等專案。
GetHistoricalKeywordPerformance	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 MatchType 和 AdPosition 元素必須設定為 Aggregate。 Devices 元素必須設定為 [計算機] 或左 nil。
GetHistoricalSearchCount	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 EndMonthAndYear 元素必須設定為上個月。 例如，如果今天的日期是 2020 年 4 月 1 日，結束月份應該是 2020 年 3 月。 Devices 元素必須設定為 [計算機] 或左 nil。
GetKeywordCategories	沙箱與生產環境應該沒有任何差異。
GetKeywordDemographics	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 Devices 元素必須設定為 [計算機] 或左 nil。
GetKeywordIdeas	沙箱測試數據每隔 3 個月會重新整理一次，因此您必須設定較早的日期器範圍。
GetKeywordLocations	支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當日交易、折扣、娛樂、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。 Devices 元素必須設定為 [計算機] 或左 nil。
SuggestKeywordsForUrl	沙箱與生產環境應該沒有任何差異。
SuggestKeywordsFromExistingKeywords	如果 SuggestionType 設定為 1，則與生產環境相比，行為應該沒有任何差異。 針對建議類型值 2、3 和 4，支援一組有限的關鍵詞：空中、自動、最佳交易、預約、汽車資訊、照護、當天交易、折扣、娛樂、娛樂、遊戲、旅館評論、保險比較、運動、旅館。

大量服務

生產環境中上傳的檔案大小限制為100MB或250萬個數據列。 針對沙箱，限制為2萬個數據列。 如需詳細資訊，請 參閱大量下載和上傳。

營銷活動管理服務

編輯支援

沙箱支援有限的編輯評論和審查。 您無法如同在生產環境中一樣，取得沙箱編輯問題的原因，例如透過 GetEditorialReasonsByIds 服務作業。

產品廣告

美國 中的沙箱支援產品廣告。 若要自動核准，您必須建立目錄和以 「sandbox」 結尾的 Microsoft 商家中心商店，如下所示。

1. 在 Microsoft Advertising Web 應用程式中，按兩下 [ 工具]。

2. 在 [ 管理工具] 下，按兩下 [Microsoft 商家中心]。

3. 按兩下 [建立存放區]，然後輸入以 “sandbox” 結尾的商店名稱， (不區分大小寫的) 。

4. 新增您的市集資訊，選取 [目錄設定] 底下的 [產品廣告]，然後按兩下 [完成]。

5. 在新存放區中，按兩下 [ 目錄管理]，然後按兩下 [ 建立目錄]。

6. 新增您的目錄名稱，選取 [目錄摘要檔案] 下方的 [手動上傳檔案]，然後按兩下 [儲存]。

客戶計費服務

沙箱不支援付款方式。

Reporting Service

當您建立關鍵詞時，應該在幾小時內產生測試效能數據。 提供數據來測試沙箱中的產生、擷取和剖析報表。 您不應該使用測試數據來推斷或預期生產環境中關鍵詞的類似效能。

測試數據只會在新增或更新實體的同一天產生。 例如，如果您今天新增關鍵詞並下載上周的關鍵詞效能報告，則不會有任何數據。 您必須提取包含今天報表時段的報表。

下列報告可以傳回沙盒中的效能數據。 雖然沙箱服務不會傳回任何範例數據，也就是當您輪詢結果時，將不會設定報表下載 URL，但可以成功提交所有其他報表類型。

• AccountPerformanceReportRequest
• AdDynamicTextPerformanceReportRequest
• AdGroupPerformanceReportRequest
• AdPerformanceReportRequest
• CallDetailReportRequest
• CampaignPerformanceReportRequest
• DestinationUrlPerformanceReportRequest
• KeywordPerformanceReportRequest
• UserLocationPerformanceReportRequest