將 Facebook 廣告資料載入 BigQuery

您可以使用 Facebook 廣告適用的 BigQuery 資料移轉服務連接器，將 Facebook 廣告資料載入 BigQuery。您可以使用 BigQuery 資料移轉服務，安排週期性移轉工作，將 Facebook 廣告的最新資料新增至 BigQuery。

受支援的報表

Facebook 廣告適用的 BigQuery 資料移轉服務支援移轉下列 Facebook 廣告報表：

• Ads
• AdInsights
• AdInsightsActions

如要瞭解 Facebook 廣告報表如何轉換成 BigQuery 資料表和檢視表，請參閱「Facebook 廣告資料轉換」一文。

限制

Facebook 廣告資料移轉作業會受到下列限制：

• Facebook 廣告資料轉移作業的間隔時間至少須為 24 小時。週期性資料移轉的預設間隔為 24 小時。
• Facebook 廣告專用的 BigQuery 資料移轉服務僅支援一組固定的資料表。不支援自訂報表。
• Facebook 廣告資料轉移作業最多需要六小時。如果轉移時間超過這個上限，就會失敗。
• AdInsights 和 AdInsightsActions 資料表不支援增量轉移。建立資料轉移作業時，如果包含 AdInsights 和 AdInsightsActions 資料表，且您在「排程選項」中指定日期，系統會轉移該日期可用的所有資料。
• BigQuery 資料移轉服務支援 AdInsights 和 AdInsightsActions 資料表的每日重新整理時間範圍。更新期是指資料移轉作業從來源資料擷取資料的天數。首次執行資料移轉作業時，資料移轉作業會擷取重新整理視窗內的所有可用來源資料。

• Facebook 廣告轉移作業需要長期有效的使用者存取權杖，但這類權杖會在 60 天後失效。

  如果長期有效的使用者存取權權杖已過期，請前往資料轉移詳細資料頁面，然後按一下「編輯」，即可取得新的權杖。在編輯轉移頁面中，按照「Facebook 廣告事前準備」中的步驟，產生新的長期有效使用者存取權杖。

• 如果設定的網路附件和虛擬機器 (VM) 執行個體位於不同區域，從 Facebook Ads 轉移資料時，可能會發生跨區域資料移動。

從 Facebook 廣告轉移作業擷取資料

如果是 AdInsights 和 AdInsightsAction 資料表，資料載入的資料表分區會對應至資料來源中的日期。

如果是 AdAccounts 表格，系統每天會擷取一次快照，並儲存在上次移轉執行日期的分區中。重新整理視窗不適用於 AdAccounts 資料表。

事前準備

下列各節將說明建立 Facebook 廣告資料轉移作業前，您需要採取的步驟。

Facebook 廣告先決條件

建立 Facebook 廣告資料轉移作業時，請確認您擁有下列 Facebook 廣告資訊。

如要取得 clientID 和 clientSecret，請執行下列步驟：

1. 建立 Facebook 開發人員應用程式，應用程式類型為 Business。
2. 在 Facebook 應用程式資訊主頁中，依序點選「應用程式設定」>「基本」，然後找出與應用程式對應的應用程式 ID 和應用程式密鑰。

如要取得長期有效的使用者存取權杖 (又稱「更新」權杖)，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，按照相關步驟建立 Facebook 廣告轉移作業。

2. 在「資料來源詳細資料」部分，複製「重新整理權杖」欄位後列出的重新導向 URI。

   

3. 按一下「Facebook 應用程式資訊主頁」，然後按一下「Facebook 企業登入」部分中的「設定」。

   

4. 在「設定」頁面中，於「有效的 OAuth 重新導向 URI」欄位輸入重新導向網址，然後按一下「儲存」。

5. 返回 Google Cloud 控制台。在「資料來源詳細資料」部分，按一下「授權」。系統會將你重新導向至 Facebook 驗證頁面。

   

6. 選取 Facebook 開發人員應用程式，授權與 BigQuery 資料移轉服務連結的帳戶。

7. 完成後，按一下「我知道了」返回 Google Cloud 控制台。現在，移轉設定中會填入長期有效的使用者存取權權杖。

長期有效的使用者存取權杖會在 60 天後失效。如要瞭解如何取得新的長期有效使用者存取權杖，請參閱「限制」。

更新權杖替代方案

或者，如果您已透過下列任一方法取得重新整理權杖，也可以在建立資料移轉作業時提供該權杖：

• 使用 Graph API 產生長效使用者存取權杖。 您必須具備 ads_management、ads_read 和 business_management 權限，才能取得資料移轉作業的有效權杖。
• 產生系統使用者權杖。 系統使用者權杖可讓您手動新增資產 (例如廣告帳戶)，以便納入資料轉移作業。如果系統使用者權杖過期，您必須手動使用新憑證更新轉移設定。您也可以在建立系統使用者權杖時，選擇建立不會過期的權杖。詳情請參閱「支援的存取權杖」。

BigQuery 必要條件

• 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
• 請建立 BigQuery 資料集來儲存您的資料。
• 如要為 Pub/Sub 設定移轉作業執行通知，請確認您擁有 pubsub.topics.setIamPolicy 身分與存取權管理 (IAM) 權限。如果您只設定電子郵件通知，則不需要 Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知一文。

須具備的 BigQuery 角色

如要取得建立移轉作業所需的權限，請要求管理員授予您 BigQuery 管理員 (roles/bigquery.admin) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備建立轉移作業所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

建立 Facebook 廣告資料移轉作業

選取下列選項之一：

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

bq mk
--transfer_config
--target_dataset=mydataset
--data_source=facebook_ads
--display_name='My Transfer'
--params='{"connector.authentication.oauth.clientId": "1650000000",
    "connector.authentication.oauth.clientSecret":"TBA99550",
    "connector.authentication.oauth.refreshToken":"abcdef"}'

排解轉移設定問題

如果無法順利設定 Facebook 廣告資料移轉作業，請嘗試下列疑難排解步驟：

• 使用 Facebook 存取權杖偵錯工具，檢查使用者存取權杖是否已過期。長期使用者存取權杖會在 60 天後失效。如果長期有效的使用者存取權杖已過期，請前往轉移詳細資料，然後按一下「編輯」修改轉移設定。在編輯轉移頁面中，按照「Facebook 廣告先決條件」中的步驟產生新的代碼。
• 確認長期有效的使用者存取權杖是使用必要權限 (ads_management、ads_read 和 business_management) 產生。如果沒有，請按照「Facebook 廣告事前準備」一文中的步驟，產生新的長期有效使用者存取權杖。
• 在 Facebook 應用程式資訊主頁的「必要動作」分頁中，查看需要處理的項目。

您可能會看到下列與 Meta API 頻率限制錯誤相關的錯誤訊息：

錯誤：There have been too many calls from this ad-account. Wait a bit and try again.

解決方法：確認沒有平行工作流程使用相同的應用程式或憑證。如果這些錯誤仍未解決，請嘗試將權限升級為進階存取權，取得更多速率限制配額。詳情請參閱「Marketing API Rate Limiting」。

常見的監控指標訊息

您也可以查看 BigQuery 資料移轉服務監控指標，判斷資料移轉失敗的原因。下表列出 Facebook 廣告資料轉移的一些常見 ERROR_CODE 訊息。

定價

這項功能處於預覽階段時，將 Facebook 廣告資料移轉至 BigQuery 不會產生費用。

後續步驟

• 進一步瞭解 BigQuery 資料移轉服務。
• 進一步瞭解如何處理移轉作業，例如查看設定和執行記錄。
• 瞭解如何透過跨雲端作業載入資料。