以第三方身分與 Google Ad Manager 整合

第三方並非 Ad Manager 的直接使用者，因為他們可能沒有自己的 Ad Manager 聯播網。而是為 Ad Manager 客戶 (即他們的客戶) 建立 Ad Manager 服務或整合。本指南將提供最佳做法、提示和訣竅，說明第三方整合的基本概念。

本指南假設您對 Ad Manager API 有基本瞭解。如果您不熟悉 Ad Manager API，請參閱入門說明文件。

以第三方身分開始使用

如要使用 Ad Manager API 存取 Ad Manager 客戶的聯播網，請按照下列準則操作。您無須取得 Google 的額外核准，但請注意，存取和/或使用 Ad Manager API 即表示您同意 Ad Manager API 的條款及細則。

如何以第三方身分測試 Ad Manager 整合

身為第三方，您可能想知道如何在客戶的正式聯播網中放送廣告前，測試 Ad Manager 整合功能。建議您建立測試網路。您不必是 Ad Manager 客戶，也能執行這項操作。只要擁有 Google 帳戶，任何人都能建立測試網路。

不過請注意，測試和正式版網路之間存在差異。測試聯播網無法放送廣告。測試網路也不一定會包含所有功能，客戶可能無法在正式版網路中使用這些功能。如果您需要測試 Ad Manager 功能，但測試聯播網不支援這些功能，可以透過 Ad Manager 經銷商購買非測試聯播網的存取權。

此外，您應向客戶清楚說明，他們需要在正式版網路中提供哪些功能，應用程式才能正常運作。如果應用程式可能沒有某些功能，請擷取例外狀況並妥善處理失敗情形，或保留用戶端清單，以及每個用戶端有哪些功能。客戶應負責與 Google 聯絡人合作，管理自家聯播網的功能。

驗證：如何正確存取客戶的 Ad Manager 聯播網

如要讓應用程式存取客戶的 Ad Manager 聯播網，您必須以安全的方式設定驗證工作流程。

這項程序包含兩個步驟：

  1. 建立 Google 帳戶電子郵件地址，用來存取客戶的聯播網。
  2. 請客戶將這個帳戶新增為 Ad Manager 聯播網的使用者。

在步驟 1 中，您可以為每個客戶建立個別的 Google 帳戶，或是建立一個主要帳戶，供所有客戶使用。如果其中一個帳戶遭到入侵，前一個選項會更安全。後者表示您只需要執行一次步驟 1。

無論您在步驟 1 中採取什麼做法，在步驟 2 中，您都需要請每位新客戶將您為他們建立的適當 Google 帳戶，新增為 Ad Manager 聯播網的使用者。

1. 建立 Google 帳戶

您可以透過多種方式建立 Google 帳戶，並將其新增至 Ad Manager 聯播網。

  • 做法 1：建立 OAuth2 服務帳戶，系統會為您產生服務帳戶電子郵件地址，做為 Google 帳戶。建立新服務帳戶的操作說明。

  • 方法 2：以新使用者身分註冊，建立一般 Google 帳戶 (「Gmail」帳戶)。如果您已有 Google 帳戶，請在無痕視窗或新的瀏覽器工作階段中完成註冊。或者，如果貴公司使用 Google Workspace，您可以在公司網域中建立 Google 帳戶，並改用該帳戶。在本指南中，我們會將這兩者都稱為「一般」Google 帳戶。

2. 請客戶將你的 Google 帳戶新增至他們的聯播網

取得可存取客戶聯播網的 Google 帳戶後，請要求客戶在 Ad Manager 聯播網中將該帳戶新增為使用者。

無論選擇哪種方式，請務必與客戶討論您的帳戶應具備哪些角色和權限，確保應用程式能存取客戶聯播網中所需的資料。

現在您可以開始對客戶的 Ad Manager 聯播網發出 API 呼叫。請務必將networkCode SOAP 標頭設為您要發出 API 呼叫的客戶聯播網代碼。所有用戶端程式庫都允許以程式輔助方式設定這項功能。舉例來說，在廣告 Java 用戶端程式庫中，您可以在建構 DfpSession 執行個體時，以程式輔助方式設定聯播網代碼。

掌握 API 最新資訊

請務必隨時掌握哪些 API 版本已淘汰或停用，以及何時會發布新版本。您不希望在版本淘汰時措手不及，導致用戶端中斷運作。我們無法像通知客戶一樣，向第三方發出即將淘汰或終止服務的通知。因此，您有責任訂閱我們三種主要 API 更新管道的其中一種，並調整通知設定：

此外，我們也會在開發人員網站上提供淘汰時間表，建議您定期查看。