MetaAds

MetaAds 連接器可讓您連線至 Meta / Facebook 廣告資料，並對資料執行建立、讀取、更新和刪除作業。

事前準備

使用 Meta Ads 連接器前，請先完成下列工作：

• 在 Google Cloud 專案中：
  • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
  • 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
  • 將下列 IAM 角色授予要用於連接器的服務帳戶：
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。連接器和服務帳戶必須屬於同一個專案。詳情請參閱「建立服務帳戶」。

  • 啟用下列服務：
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    如要瞭解如何啟用服務，請參閱「啟用服務」。

  如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。

設定連接器

連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

   前往「Connections」(連線) 頁面

2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
3. 在「位置」部分中，選擇連線位置。
   1. 區域：從下拉式清單中選取位置。

      連接器支援的地區包括：

      如需所有支援的地區清單，請參閱「位置」一文。

   2. 點選「下一步」。
4. 在「連線詳細資料」部分，完成下列步驟：
   1. 連接器：從可用連接器的下拉式清單中選取「Meta Ads」。
   2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
   3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
   4. 視需要輸入連線執行個體的「Description」(說明)。
   5. 服務帳戶：選取具備必要角色的服務帳戶。
   6. 視需要設定「連線節點設定」：
      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連線器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

   注意：只有預付方案客戶可以自訂連線節點值。
   7. 帳戶 ID：廣告帳戶的 ID。如未指定，我們會使用 Facebook 廣告傳回的第一個廣告帳戶 ID。
   8. 匯總格式：匯總或集合資料欄應傳回的格式。
   9. 以粉絲專頁身分驗證：向 Facebook 提出要求時，要以哪個粉絲專頁的名稱或 ID 進行驗證。
   10. 重試層級：驅動程式在重試時嘗試擷取結果的最精細廣告物件層級。
   11. 目標：如果未指定任何目標，則為預設目標。適用於部分表格，例如「留言」，可指定目標。
   12. (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
   13. 點選「下一步」。
5. 在「Authentication」(驗證) 部分，輸入驗證詳細資料。
   1. 選取「驗證類型」並輸入相關詳細資料。

      Meta 廣告連結支援下列驗證類型：

      • OAuth 2.0 授權碼授權

   如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

   2. 點選「下一步」。
6. 檢查：檢查連線和驗證詳細資料。
7. 點選「建立」。

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

• OAuth 2.0 授權碼授權
  • 存取權杖：用於透過以授權碼流程為基礎的連線驗證要求。
  • 用戶端 ID：連接器為您建立的應用程式提供的用戶端 ID。
  • 用戶端密鑰：Secret Manager 密鑰，內含您建立的連結應用程式用戶端密鑰。

Meta 廣告設定

如要建立與 Meta 廣告整合的應用程式，請完成下列工作：

• 設定及建立 Meta 應用程式帳戶
• 設定 OAuth 2.0 用戶端驗證
• 設定範圍詳細資料
• 設定重新導向網址

設定及建立 Meta 應用程式帳戶

1. 前往 Facebook 商家管理工具。
2. 按一下「建立帳戶」，然後填寫商家詳細資料來建立帳戶。
3. 在設定過程中驗證身分和商家資訊。
4. 設定好企業管理平台帳戶後，前往商家設定並點選選單中的「粉絲專頁」。
5. 按一下「新增」，然後選取「新增頁面」。按照其他提示，將 Facebook 粉絲專頁新增至商家管理工具帳戶。
6. 在商家設定的選單中，按一下「新增帳戶」。按一下「新增」，然後選取「新增廣告帳戶」。

你可以使用現有的廣告帳戶，或建立新的廣告帳戶。

7. 按一下商家設定中的「付款方式」。
8. 按一下「新增」，新增信用卡或 PayPal 帳戶等付款方式。按照其他提示輸入付款資訊。
9. 按一下「新增使用者」，然後輸入要授予商家管理工具帳戶存取權的使用者電子郵件地址。根據每個人的職責，指派適當的角色和權限。
10. 前往廣告管理工具，點按商家管理工具中的選單圖示，然後選取「廣告管理工具」。按一下「建立」即可建立廣告活動。
11. 按照提示定義廣告活動目標、目標對象、廣告格式、預算和時間表。
12. 上傳您建立的廣告，並在提交廣告活動審查前確認詳細資料。
13. 廣告活動上線後，請在廣告管理工具中監控廣告活動和成效。分析觸及率、參與度和轉換率等重要指標。視需要調整廣告活動，盡量提升成效並達成廣告目標。
14. 使用個人 Facebook 帳戶登入，或註冊新帳戶 (如果沒有帳戶)。登入 Facebook 開發人員。
15. 按一下「我的應用程式」下拉式選單，然後選取「建立應用程式」。
16. 選取應用程式的平台，例如 iOS、Android、網站等。
17. 提供應用程式的基本資訊，例如名稱、電子郵件地址和類別。
18. 提供必要資訊後，按一下「建立應用程式 ID」，即可為應用程式產生專屬 ID。
19. 設定應用程式的其他設定，例如新增平台專屬詳細資料 (包括 iOS 軟體包 ID、Android 套件名稱)，以及設定應用程式網域和隱私權政策網址。
20. 選擇要整合至應用程式的 Facebook 產品，例如 Facebook 登入、Analytics 或廣告。
21. 按照操作說明設定開發環境，並將 Facebook SDK 整合到應用程式程式碼中。
22. 設定及配置應用程式後，即可使用 Facebook 開發人員工具和資源，開始建構及測試應用程式功能。

如要瞭解如何建立應用程式，請參閱「建立應用程式」。

設定 OAuth 2.0 用戶端驗證詳細資料

1. 使用 Facebook 憑證前往「開發人員專用 Meta」。
2. 按一下「我的應用程式」，然後選取「應用程式」分頁，並選擇您先前建立的 Meta 應用程式。
3. 依序點選「應用程式設定」>「基本」。
4. 查看應用程式密鑰 (即用戶端密鑰)。按一下「顯示」，輸入帳戶密碼，然後複製並儲存密碼，以供日後使用。
5. 依序點選「應用程式設定」>「進階」。找出用戶端權杖，也就是用戶端 ID。如有需要，可以重設。

設定範圍詳細資料

Meta 廣告連接器的範圍為 ads_management。

設定重新導向網址詳細資料

1. 使用 Facebook 憑證前往「開發人員專用 Meta」。
2. 按一下「應用程式」分頁，然後選擇先前建立的 Meta 應用程式。
3. 依序點選 Facebook「登入」>「設定」。
4. 貼上「Valid OAuth Redirect URIs」下方產生的重新導向網址，並在其他必填欄位中輸入詳細資料。

注意：Facebook 規定必須先完成身分或商家驗證，才能建立其他廣告帳戶。如未完成這項驗證，您可能會無法建立新的廣告帳戶。Meta 要求商家驗證身分，才能在平台上放送廣告，確保廣告主合法，並維護廣告生態系統的完整性。

連線設定範例

本節列出建立 Meta Ads 連結時設定各個欄位的範例值。

Meta 廣告網站連線類型

欄位名稱	詳細資料
位置	us-central1
連接器	facebookads
連接器版本	1
連線名稱	google-cloud-meta-ads-conn
服務帳戶	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
節點數量下限	2
節點數量上限	50
用戶端 ID	CLIENT_ID
範圍	ads_management
用戶端密鑰	CLIENT_SECRET
密鑰版本	2

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

注意：您可以在「連線器工作」中查看連線器的實體、作業和動作。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

注意： 所有實體和動作都會有相關聯的結構定義。舉例來說，動作結構定義會包含參數詳細資料，例如參數名稱和對應的資料型別。連線會在執行階段從後端擷取實體和動作的結構定義 (中繼資料)。如果架構有任何更新，現有連線不會自動反映這些更新，您必須手動重新整理架構。如要重新整理連線的結構定義，請開啟連線的「連線詳細資料」頁面，然後按一下「重新整理連線結構定義」。

系統限制

MetaAds 連接器每秒可處理 6 筆交易，每個節點每秒可處理 6 筆交易，並節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

注意：整合連接器節點的數量會根據用量自動動態調整。不過，如要為大量資料保留容量，不必等待自動調度資源，可以調整連線的節點數量下限。如要處理連線的更多交易，就需要更多節點。反之，如果連線處理的交易較少，則需要的節點也較少。如要設定節點值，請按照下列步驟操作：

• 如果您是隨用隨付方案客戶，請在編輯連線頁面中設定節點的最小值和最大值。
• 如果您是訂閱型客戶，請與支援團隊聯絡。

節點可處理的最大交易量取決於多項因素。因此，建議您先檢查後端系統是否已完成最佳化設定，可處理所需流量，再調整節點下限以提升輸送量。

動作

本節列出連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

注意：執行整合後，所有動作的結果都會以 JSON 回應的形式，顯示在 Connectors 工作的 connectorOutputPayload 回應參數中。

CreateAdPreview 動作

為應用程式洞察資料建立結構定義檔案。

CreateAdPreview 動作的輸入參數

參數名稱	資料類型	必填	說明
AdFormat	字串	是	要使用的廣告格式。允許值為 AUDIENCE_NETWORK_INSTREAM_VIDEO、AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE、AUDIENCE_NETWORK_OUTSTREAM_VIDEO、AUDIENCE_NETWORK_REWARDED_VIDEO、DESKTOP_FEED_STANDARD、FACEBOOK_STORY_MOBILE、INSTAGRAM_STANDARD、INSTAGRAM_STORY、INSTANT_ARTICLE_STANDARD、INSTREAM_VIDEO_DESKTOP、INSTREAM_VIDEO_MOBILE、MARKETPLACE_MOBILE、MESSENGER_MOBILE_INBOX_MEDIA、MOBILE_BANNER、MOBILE_FEED_BASIC、MOBILE_FEED_STANDARD、MOBILE_FULLWIDTH、MOBILE_INTERSTITIAL、MOBILE_MEDIUM_RECTANGLE、MOBILE_NATIVE、RIGHT_COLUMN_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE。
AdCreativeId	字串	是	用於建立預覽畫面的廣告素材 ID。

如要瞭解如何設定 CreateAdPreview 動作，請參閱「動作範例」。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - 建立廣告預覽

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 CreateAdPreview 動作，然後按一下「完成」。
3. 在「資料對應」區段中 Open Data Mapping Editor，然後在「Input」欄位中輸入類似下列的值：

   {
   "AdCreativeId": "120208552947120478",
   "AdFormat": "AUDIENCE_NETWORK_INSTREAM_VIDEO"
   }

如果動作成功，CreateAdPreview 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
  "Url": "https://business.facebook.com/ads/api/preview_iframe.php?d=AQL_quk8kLm_6z2oZ14q9A0led9llzr981NPv-zUHhwZ5IXjO07s7ngrI2y0qI0VZCRH2w9hgCwy5xrbFQlWCy0g-uRpRHvFS0dS0erj2Lg4HI7ZfIRm8h3nZLhJygM",
  "@affectedrows": null
}, {
  "Url": null,
  "@affectedrows": null
}]

實體作業範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有廣告帳戶

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 AdAccounts。
3. 選取「List」作業，然後按一下「完成」。

範例 - 列出所有廣告活動

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Campaigns。
3. 選取「List」作業，然後按一下「完成」。
4. (選用) 在「連線器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。請一律在單引號 (') 內指定篩選子句值。

範例 - 取得廣告組合

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Adsets。
3. 選取「Get」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 120206747969710053。

   其中 120206747969710053 是 User 實體中的專屬記錄 ID。

注意： 如果實體具有複合主鍵，您可以指定篩選子句。

在整合服務中使用 MetaAds 連線

建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

• 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
• 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟

• 瞭解如何暫停及恢復連線。
• 瞭解如何監控連結器用量。
• 瞭解如何查看連接器記錄。