本文包含有關Bing Ads API 的一些常見問題的解答。
取得說明
哪裡可以取得協助?
Microsoft Q&A 論壇可供開發人員社群詢問及回答有關Bing Ads API 和Microsoft Advertising 腳本的問題。 Microsoft會監視論壇,並回復社群尚未回答的問題。
重要事項
若要確定我們已看到您的問題,請將它標記為 『advertising-api』。
如果調查涉及敏感性帳戶或個人詳細數據,或您找不到透過 Q&A Microsoft解決問題所需的資訊,請 連絡 Microsoft Advertising 支援。 若要有效率地解決問題,請提供支援,並提供 參與支援中所要求的詳細數據。
如何了解變更?
開始使用
使用 Bing Ads API 有哪些需求?
若要 開始使用,您必須註冊 Microsoft Advertising 帳戶,然後透過開發人員入口網站的 [ 帳戶 ] 索引標籤取得開發人員令牌。
支援哪些程式設計語言和 SDK?
您可以使用任何支援 Web 服務的程式設計語言來開發Bing Ads API 應用程式。 Bing Ads API 軟體開發工具組 (SDK) 增強使用 .NET、Java、PHP 和 Python 語言開發Bing Ads API 應用程式的體驗。 每個 SDK 都包含所有Bing Ads API Web 服務的 Proxy,並以 OAuth 擷取低階驗證詳細數據。 您可以使用高階 BulkServiceManager 和 ReportingServiceManager 介面,在低階 Bulk 和 Reporting Services 中抽象化和執行作業。
我們已聽到其他 SDK 的要求,例如 Perl 和 Ruby,雖然近期內沒有新增支持的計劃。
如何以不同的程式設計語言檢視程式代碼範例?
除了程式 代碼範例 之外,您還會在許多技術指南中找到代碼段,例如 開始使用 指南。 您可以使用這些頁面頂端或右邊的語言選取器,以 CSharp、Java、Php 或 Python 檢視範例。 當您選擇語言時,會在流覽其他頁面時保留設定。 語言選取器只會包含具有該特定頁面範例的語言,而且如果您先前設定的語言不適用於您瀏覽的頁面,則預設為 C#。
功能可用性
我應該使用大量或營銷活動管理 API 嗎?
建議 使用大量服務 ,特別是當您需要在帳戶中的多個廣告群組或營銷活動之間新增或更新廣告和關鍵詞時。 某些功能無法大量使用,例如 AddUetTags、 GetBMCStoresByCustomerId、 GetGeoLocationsFileUrl 和 GetMediaMetaDataByAccountId。 針對這些功能,您當然必須使用 營銷活動管理服務。
哪些 API 效能報告可用,以及何時可以使用我的數據?
Reporting 服務支援您可以在 Microsoft Advertising Web 應用程式 中找到的大部分相同報表類型。 如需可用性詳細數據,請務必參閱 報表屬性和效能統計數據 和 報告數據保留時間週期 指南。
當使用者按兩下廣告時,系統最多可能需要兩小時的時間來處理按兩下 (3小時,以進行轉換) 並使其可供報告。 當前一天的所有數據都已處理並可供報告時,此狀態稱為「關閉書籍」。 如需有關何時關閉書籍以進行報告的詳細資訊,請參閱 報表中的時區。
OAuth
何時需要透過Bing Ads API、內容 API 和旅館價格廣告 API 進行多重要素驗證?
我需要進行任何變更以符合多重要素驗證需求嗎?
您必須更新應用程式,才能透過 Microsoft 身分識別平台 端點使用新msads.manage
範圍。 所有應用程式開發人員都必須採取動作,才能使用新的範圍。
您必須透過新msads.manage
範圍和 Microsoft 身分識別平台 端點提示使用者同意。
我需要註冊新的應用程式才能使用 msads.manage 嗎?
如果您的舊版應用程式標識碼 (也稱為用戶端標識符) 格式化為十六進位值,例如 00000000012345A67,則您必須註冊新的應用程式。 有效的 Microsoft 身分識別平台 應用程式標識符會格式化為具有破折號的 GUID,例如 00001111-aaaa-2222-bbbb-3333cccc4444。 如果您在 Azure 入口網站 中看不到現有的應用程式 - 應用程式註冊,這表示您應該將它取代為新的應用程式。
當我升級至 msads.manage 時,使用者是否需要授與同意?
是。 您必須透過新msads.manage
範圍和 Microsoft 身分識別平台 端點提示使用者同意。
透過 Microsoft 身分識別平台 端點提示要求同意時,用戶體驗是什麼?
當您提示使用者同意 (使用通用租使用者) 與 Microsoft 身分識別平台 端點時,使用者登入體驗會根據認證背後的基礎身分識別而有所不同。
- 只有 MSA 身分識別的人員會被導向至 MSA 登入頁面。
- 只有 Azure AD 身分識別的人員會被導向至其組織登入頁面。
- 認證在 MSA 和 Azure AD 網域中都有效的人員將會遇到明確頁面,要求他們選擇其個人和工作或學校身分識別。 只要此使用者有兩個系結至相同電子郵件位址的身分識別,就一律會出現這種模棱兩可的情況。 用戶可以變更 其個人Microsoft帳戶的電子郵件位址,以停止看到此資訊。 如需詳細資訊,請參閱 https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/。
注意事項
您應該處理 作業錯誤碼 122 到 125,以協助應用程式的使用者選取正確的認證,也就是工作與個人帳戶。
當使用者在 Microsoft Advertising 中從使用其個人帳戶切換到其公司或學校帳戶時,其重新整理令牌會發生什麼事?
如果使用者不再具有 MSA 個人帳戶身分識別,則Bing Ads API 將不再接受其現有的存取令牌。 同樣地,重新整理令牌無法再用來要求新的存取令牌,因此您必須再次要求使用者同意,應用程式才能管理其Microsoft Advertising 帳戶。 您應該捨棄先前的重新整理令牌。
沙箱是否支援公司或學校帳戶?
不能。 只有在生產環境中才支援公司或學校帳戶。
我想要在沒有使用者互動的情況下執行我的應用程式。 如何在未收到使用廣告認證Microsoft許可權提示的情況下進行驗證?
若要以程式設計方式管理 Microsoft Advertising 帳戶,您必須透過 Web 應用程式同意流程至少提供一次同意。 針對重複或長期驗證,您應該遵循授權碼授與流程來取得存取令牌和重新整理令牌。 之後,您可以使用最新的重新整理令牌來要求新的存取和重新整理令牌,而不需要任何進一步的用戶互動。 您可能需要再次要求使用者同意,例如,如果使用者通過帳戶復原、變更其密碼,或是移除應用程式代表其進行驗證的許可權。
存取和重新整理令牌何時到期?
存取令牌通常會在一小時后到期,不過您應該一律在每次要求新令牌時檢查到期時間。
重新整理令牌對您的應用程式而言永遠都是完全不透明的。 它們的存留期很長,例如公用用戶端的90天,但不應寫入應用程式,以預期重新整理令牌會持續一段時間。 重新整理令牌隨時都可以失效,而應用程式知道重新整理令牌是否有效的唯一方法是嘗試藉由提出令牌要求來兌換它。 即使您使用最新的重新整理令牌持續重新整理相同裝置上的令牌,您也應該預期會重新啟動,並在例如您將使用者註銷、Microsoft Advertising 使用者變更其密碼、從其受信任裝置清單中移除裝置,或移除應用程式代表其進行驗證的許可權時,要求使用者同意。 在沒有任何事先警告的情況下,Microsoft可能會判斷應該再次授與使用者同意。 最佳做法是,每次要求新的存取和重新整理令牌時,您應該一律安全地儲存最新的重新整理令牌。
為什麼我需要存取令牌和開發人員令牌?
存取令牌代表可存取一或多個廣告帳戶Microsoft用戶認證。 應用程式識別碼 (也就是,client_id) 会为每个授与同意的Microsoft Advertising 用戶識別您的應用程式。 開發人員令牌可讓您的應用程式使用Bing Ads API。
品牌
Bing Ads API 是否會與 Microsoft Advertising 平臺一起更名?
Bing Ads現在已Microsoft Advertising。 我們的新名稱反映我們如何拓展廣告解決方案,以協助您觸及更多客戶。 目前沒有任何方案可將任何目前的 API 版本重新命名。 下表列出已變更或尚未變更的名稱。 如需詳細資訊,請參閱 品牌公告。
上一個名稱 | 目前名稱 |
---|---|
廣告預覽和診斷工具 | 廣告預覽和診斷工具 |
Bing Ads | Microsoft Advertising |
Bing Ads認證的專業人員 | Bing Ads認證的專業人員 |
Bing Ads API | Bing Ads API |
Bing Ads應用程式 | Microsoft Advertising App |
Bing Ads內容 API | Bing Ads內容 API |
Bing Ads 編輯器 | Microsoft Advertising 編輯器 |
Bing Ads風扇 | Microsoft廣告迷 |
Bing Ads智慧 | Microsoft Advertising Intelligence |
Bing Ads合作夥伴 | Microsoft Advertising 合作夥伴 |
Bing Ads腳本 | Microsoft廣告腳本 |
Bing Ads SDK | Bing Ads SDK |
Bing 旅館中心 | Microsoft飯店中心 |
Bing 商家中心 | Microsoft商家中心 |
Bing 網路 | Microsoft Advertising Network |
Bing 網路新聞訂閱 | Microsoft Advertising Partner 網站 |
Bing 合作夥伴獎 | Microsoft廣告合作夥伴獎 |
Bing 合作夥伴計劃 | Microsoft Advertising 合作夥伴計劃 |
Bing 購物活動 | Microsoft購物活動 |
關鍵詞 Planner | 關鍵詞 Planner |
旅館價格廣告 | 旅館價格廣告 |
旅館 API | 旅館 API |