第三方並非 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 聯播網,您需要以安全的方式設定驗證工作流程。
這包含兩個步驟:
- 建立 Google 帳戶電子郵件地址,用於存取客戶的聯播網。
- 請客戶將這個帳戶新增為 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 聯播網的新使用者。
如果您提供的是 OAuth2 服務帳戶電子郵件地址,請要求他們將該地址新增至其聯播網。
如果您提供的是一般 Google 帳戶,請要求他們將您的帳戶新增為聯播網使用者。
無論採取哪種方式,請務必與客戶討論您的帳戶應具備哪些角色和權限,以便應用程式存取客戶網路上的必要資料。
現在,您可以開始對客戶的 Ad Manager 聯播網發出 API 呼叫。請務必將 networkCode SOAP 標頭設為您要發出 API 呼叫的用戶端聯播網代碼。所有用戶端程式庫都允許透過程式設定這項功能。舉例來說,在 Ads Java 用戶端程式庫中,您可以在建構 DfpSession 執行個體時,透過程式輔助方式設定聯播網代碼。
掌握 API 最新資訊
請務必隨時掌握哪些 API 版本已淘汰或停用,以及新版本的發布時間。您不希望在版本淘汰時措手不及,導致用戶端無法使用。我們不一定能像對待客戶一樣,主動通知第三方即將淘汰和終止服務。因此,您有責任訂閱我們三個主要管道之一,以取得 API 更新資訊,並調整通知設定:
我們也會在開發人員網站上提供淘汰時程,請定期查看。