以第三方身分與 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 更新,並調整您的通知設定:

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

取得支援

如果您在整合 Ad Manager 時遇到問題,我們會根據問題提供以下支援管道。如果您有產品層級相關問題,請前往 Ad Manager 產品論壇提出。如果您有特定 API 相關問題,請前往 Ad Manager API 論壇提問。請參閱這篇網誌文章,瞭解如何區分某項內容屬於產品層級問題還是 API 問題。