將 Display & Video 360 資料載入 BigQuery

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

連接器總覽

Display & Video 360 連接器的 BigQuery 資料移轉服務支援下列資料移轉選項。

資料移轉選項	支援
受支援的報表	Display & Video 360 連接器支援從資料移轉第 2 版 (Display & Video DTv2) 檔案中的報表移轉資料。 如要瞭解 Display & Video 360 報表如何轉換為 BigQuery 資料表和檢視表，請參閱「Display & Video 360 報表轉換」。
重複頻率	Display & Video 360 連接器支援每日資料移轉。 根據預設，資料移轉作業會安排在建立資料移轉作業時執行。您可以在設定資料移轉作業時，設定資料移轉時間。
重新整理時間範圍	執行資料移轉作業時，Display & Video 360 連接器會擷取最多 2 天前的 Display & Video 360 資料。您無法設定這個連接器的重新整理時間範圍。 詳情請參閱「重新整理時間範圍」。
補充資料可用性	執行資料補充作業，擷取排定資料移轉作業以外的資料。只要在資料來源的資料保留政策允許範圍內，即可擷取資料。 如要瞭解 Display & Video 360 的資料保留政策，請參閱「報表資料更新間隔和可用性」。

支援的設定資料

除了報表資料外，BigQuery 資料移轉服務也會從 Display & Video 360 移轉下列設定資料。設定資料是從 Display & Video 360 API v3 擷取。

• 合作夥伴
• 廣告主
• LineItem
• LineItemTargeting
• Campaign
• CampaignTargeting
• InsertionOrder
• InsertionOrderTargeting
• AdGroup
• AdGroupTargeting
• AdGroupAd
• 廣告素材

如要進一步瞭解各類設定資料，請參閱下列連結：

• 關於合作夥伴
• 建立廣告主
• 建立委刊項
• 建立廣告活動
• 建立廣告訂單
• 關於 YouTube 與合作夥伴委刊項
• 管理廣告素材

從 Display & Video 360 移轉作業擷取資料

將資料從 Display & Video 360 移轉至 BigQuery 時，資料會載入依日期分區的 BigQuery 資料表。資料載入的資料表分區會對應資料來源的日期。如果您在同一天安排多項移轉作業，BigQuery 資料移轉服務會以最新資料覆寫該日期的分區。在同一天進行多次移轉或執行補充作業，不會產生重複資料，其他日期的分區也不會受到影響。

重新整理時間範圍

「更新回溯期」是指資料移轉作業發生時，資料移轉作業擷取資料的天數。舉例來說，如果重新整理時間範圍為三天，且每天進行移轉，BigQuery 資料移轉服務會從來源資料表擷取過去三天的所有資料。在本例中，每日移轉作業執行時，BigQuery 資料移轉服務會建立新的 BigQuery 目的地資料表分區，並複製當天的來源資料表資料，然後自動觸發補充執行作業，使用過去兩天的來源資料表資料更新 BigQuery 目的地資料表分區。自動觸發的回填執行作業會覆寫或增量更新 BigQuery 目的地資料表，具體取決於 BigQuery 資料移轉服務連接器是否支援增量更新。

首次執行資料移轉作業時，系統會擷取重新整理時間範圍內的所有可用來源資料。舉例來說，如果更新時間範圍為三天，且您首次執行資料移轉作業，BigQuery 資料移轉服務會擷取三天內的所有來源資料。

如要擷取重新整理時間範圍以外的資料 (例如歷來資料)，或從任何移轉中斷或缺漏中復原資料，您可以啟動或排定補充執行作業。

事前準備

建立 Display & Video 360 資料移轉作業前，請先詳閱下列必要條件和資訊。

必要條件

• 確認您已完成啟用 BigQuery 資料移轉服務的所有必要動作。
• 建立 BigQuery 資料集，用於儲存 Display & Video 360 資料。
• 請確認您有 Display & Video 360 夥伴 ID 或廣告主 ID。合作夥伴 ID 是階層中的父項。
• 請確認您具備讀取的權限，可透過 Display and Video API 存取夥伴或廣告主資料。

• 確認貴組織有權存取 Display & Video 360 資料移轉第 2 版 (Display & Video 360 DTv2) 檔案。這些檔案由 Display & Video 360 團隊在 Cloud Storage bucket 中提供。要求存取 Display & Video 360 DTv2 檔案，取決於您是否與 Display & Video 360 直接簽訂合約。無論是哪一種情況，都可能需要支付額外費用。

  • 如果您與 Display & Video 360 簽訂合約，請聯絡 Display & Video 360 支援團隊，設定 Display & Video 360 DTv2 檔案。
  • 如果您未與 Display & Video 360 簽訂合約，請與代理商聯絡，取得 Display & Video 360 DTv2 檔案的存取權。
  • 完成這個步驟後，您會收到下列其中一個 Cloud Storage bucket 名稱，具體取決於您是為合作夥伴或廣告主進行設定：
    • gs://dcdt_-dbm_partnerPARTNER_ID
    • gs://dcdt_-dbm_advertiserADVERTISER_ID
  注意： Google Cloud 團隊無法代您產生或授予 Display & Video 360 DTv2 檔案的存取權。如要存取 Display & Video 360 DTv2 檔案，請與 Display & Video 360 支援團隊或代理商聯絡。

• 如要設定 Pub/Sub 的移轉作業執行通知，您必須具備 pubsub.topics.setIamPolicy 權限。詳情請參閱「BigQuery 資料移轉服務執行通知」。

查看 Display & Video 360 ID

如要擷取 Display & Video 360 ID，請前往 Google Cloud 控制台的 Cloud Storage「Buckets」(值區) 頁面，查看 Display & Video 360 資料移轉 Cloud Storage bucket 中的檔案。Display & Video 360 ID 用於比對所提供 Cloud Storage bucket 中的檔案。ID 會嵌入檔案名稱，而非 Cloud Storage bucket 名稱。例如：

• 在名為 dbm_partner123_activity_* 的檔案中，ID 為 123。
• 在名為 dbm_advertiser567_activity_* 的檔案中，ID 為 567。

尋找檔案名稱前置字串

在某些情況下，Cloud Storage bucket 中的檔案可能包含由 Google Marketing Platform 服務團隊為您設定的非標準自訂檔案名稱。例如：

在名為 dbm_partner123456custom_activity_* 的檔案中，前置字串為 dbm_partner123456custom。

如需檔案名稱前置字元相關協助，請與 Display & Video 360 支援團隊聯絡。

設定 Display & Video 360 資料移轉作業

選取下列選項之一：

控制台

1. 前往 Google Cloud 控制台的「Data transfers」(資料移轉) 頁面。

   前往「資料移轉」頁面

2. 按一下「 建立移轉作業」。

3. 在「Create transfer」(建立轉移作業)頁面執行下列操作：

   • 在「Source type」(來源類型) 專區，「Source」(來源) 請選擇「Display & Video 360」。
   • 在「Transfer config name」(轉移設定名稱) 專區，「Display name」(顯示名稱) 請輸入資料移轉作業的名稱。移轉作業名稱可以是任何值，能讓您辨識移轉作業，方便您日後在必要時進行修改。

4. 在「Schedule options」(排程選項) 專區：

   • 選取「Start now」(立即開始) 或「Start at set time」(在所設時間開始執行)，並提供開始日期和執行時間。
   • 在「Repeats」(重複頻率) 選取選項，指定資料移轉作業的執行頻率。如果選取「Days」(天)，請按照世界標準時間提供有效的值。

5. 在「Destination settings」(目的地設定) 部分的「Destination dataset」(目的地資料集) 選單，請選取您為了儲存資料而建立的資料集。

6. 在「Data source details」(資料來源詳細資料) 區段：

   • 在「DV360 DTV2 Cloud Storage bucket」欄位中，輸入含有 Display & Video 360 DTv2 檔案的 Cloud Storage bucket。如果您需要設定這個 bucket，請與 Display & Video 360 支援團隊聯絡。
   • 在「DV360 Partner/Advertiser ID」(DV360 合作夥伴/廣告主 ID) 欄位中，輸入合作夥伴 ID 或廣告主 ID。
   • (選用) 在「Notification options」(通知選項) 專區：
     • 按一下啟用電子郵件通知的切換開關。當您啟用此選項時，移轉管理員會在移轉作業失敗時收到電子郵件通知。
     • 點選切換按鈕，啟用 Pub/Sub 通知。在「Select a Cloud Pub/Sub topic」(選取 Cloud Pub/Sub 主題) 選取主題名稱，或是點選「Create a topic」(建立主題)。這個選項會針對移轉作業設定 Pub/Sub 執行通知。

7. 按一下 [儲存]。

bq

輸入 bq mk 指令並提供移轉建立標記 - --transfer_config。必須使用下列旗標：

• --data_source
• --target_dataset
• --display_name
• --params

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

其中：

• PROJECT_ID：您的專案 ID。
• DATASET：資料移轉設定的目標資料集。
• NAME：資料移轉設定的顯示名稱。移轉作業名稱可以是任意值，日後需要修改移轉作業時，能夠據此識別即可。
• PARAMETERS：所建立資料移轉設定的參數，格式為 JSON。例如 --params='{"param":"param_value"}'。如果是 Display & Video 360 移轉作業，則必須提供 bucket 和 displayvideo_id 參數。file_name_prefix 參數為選用，僅用於不常見的自訂檔案名稱。
• DATA_SOURCE：資料來源 - displayvideo。

舉例來說，下列指令會使用 Display & Video 360 ID 123456、Cloud Storage bucket dcdt_-dbm_partner123456 和目標資料集 mydataset，建立名為 My Transfer 的 Display & Video 360 資料移轉作業。

資料移轉作業會在預設專案中建立：

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

執行指令後，您會收到如下的訊息：

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

請按照訊息中的操作說明進行，在指令列中貼上驗證碼。

API

請使用 projects.locations.transferConfigs.create 方法，並提供 TransferConfig 資源的例項。

查詢資料

資料移轉至 BigQuery 時，系統會將資料寫入擷取時間分區資料表。詳情請參閱「分區資料表簡介」。

建議您查詢自動產生的檢視表，而非直接查詢資料表。不過，如要直接查詢資料表，則必須在查詢中使用 _PARTITIONTIME 虛擬資料欄。詳情請參閱「查詢分區資料表」。