建立及執行報表

本指南說明如何建立及執行報表，以及如何查看結果。

建立報表

分析人員和超級使用者可以建立及編輯報表。進一步瞭解廣告資料中心的存取權控管。

  1. 在廣告資料中心，開啟「報表」頁面。
  2. 按一下「+ 建立報表」。「建立新報表」頁面隨即開啟。
    • 搜尋、選取產品圖示及選擇下拉式選單中的選項，即可篩選範本。
  3. 選擇範本並點選「使用範本」，或點選「SQL」從頭開始。
    • 按一下「展開」expand_content，即可預覽範本詳細資料和 SQL。
  4. 如要編輯報表，請按一下「編輯查詢」。使用查詢編輯器可執行下列操作：
    • 使用與 BigQuery 相容的 SQL 自訂報表。
    • 在「屬性」分頁中設定參數。
    • 在「Google 表格」分頁中，查看可用表格和欄位的清單。
    • 在「第一方資料表」分頁中，查看匯入的第一方資料表清單及其結構定義。
    • 按一下「執行」，執行 SQL 查詢。請注意，從 SQL 查詢編輯器啟動的執行作業不會計入報表的執行記錄，也不會顯示在「首頁」頁面的「近期活動」部分。
    • 按一下「完成」確認查詢變更，並返回報表設定頁面。
  5. 輸入報表名稱。
  6. 如適用，請在「設定」資訊卡中設定參數值。
  7. 設定這份報表執行工作的輸入和輸出：
    • 在「廣告資料來源」欄位中選取資料來源。此 ID 必須與要查詢的廣告資料連結。 (如要查詢沙箱資料，請選取「廣告資料中心沙箱客戶」。)
    • 如果使用對照表，請在「對照表帳戶」欄位中選取對照表。
    • 選取報表的日期範圍和時區。報表時區應與已連結廣告帳戶 (例如 Google Ads 帳戶) 的時區一致。注意：只有從 SQL 編輯器畫面執行查詢時，系統才會支援查詢測試的自訂日期範圍。
    • 選用步驟：變更隱私權設定，並設定篩除資料列摘要。
    • 選擇要儲存報表結果的 BigQuery 專案、資料集和資料表。
  8. 選用：將報表設為定期執行。
  9. 按一下 [儲存]。

參數

參數可讓您指定特定報表的執行方式。使用 SQL 建立報表時 (或編輯報表範本的 SQL 時)，您可以透過參數在不同報表重複使用相同的 SQL 程式碼，並在每個報表副本中設定不同的參數值。舉例來說，您可以設定參數，並在報表詳細資料頁面的「設定」部分中設定參數值，針對不同廣告活動 ID 集執行兩個共用相同 SQL 查詢或範本的報表。使用參數可讓 SQL 程式碼保持簡潔，減少編輯時出錯的可能性，現有 SQL 查詢甚至不經編輯就能重複用於多份報表。

在以下範例中，報表包含名為 campaign_ids 的參數，該參數可接受 int64 廣告活動 ID 的 array：

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

參數類型

允許使用以下參數類型：

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array (任何允許使用的類型)

在報表中新增參數

  1. 開啟已儲存的報表，或建立新報表。
  2. 按一下「編輯查詢」。
  3. 在「屬性」下方，按一下「新增參數」。
  4. 在「名稱」欄位中輸入名稱。此名稱會用來在報表文字中指稱參數。
  5. 使用下拉式選單選取參數類型。
    • 如果選擇陣列類型，就會出現額外的下拉式選單。請在這個下拉式選單中選取陣列類型。
  6. 在 SQL 查詢中，使用標準 SQL 參數格式新增參數：@PARAMETER_NAME。請參閱這些步驟後的範例。
  7. 依序點選「Done」(完成) 和「Save」(儲存)。

使用參數

  1. 開啟已設定參數的報表。
  2. 在「設定」窗格中，為已定義的每項參數輸入值
  3. 按一下「儲存」保留參數值。

移除參數

  1. 開啟已設定參數的報表。
  2. 按一下「編輯查詢」開啟 SQL 編輯器。
  3. 在「屬性」下方，找出要刪除的參數，然後按一下旁邊的「刪除」。
  4. 依序點選「Done」(完成) 和「Save」(儲存)。

保留參數

下表列出廣告資料中心保留的參數。您可以在報表中使用這些參數，但無法建立與保留參數同名的參數。

start_date date

報表工作的開始日期 (含此日期)。系統會忽略使用這個名稱的使用者定義參數，並替換成「新工作」對話方塊中設定的值。
end_date date

報表工作的結束日期 (含此日期)。系統會忽略使用這個名稱的使用者定義參數，並替換成「新工作」對話方塊中設定的值。
time_zone string

報表工作的時區。系統會忽略使用這個名稱的使用者定義參數，並替換成「新工作」對話方塊中設定的值。
params string

用於命名匯出資料表的命名空間。請使用以下格式在查詢中建立預留位置，然後在執行報表時提供資料表名稱：params.TABLE_NAME (請勿使用其他參數開頭的 @)。如要進一步瞭解如何使用這個參數，請參閱同筆查詢匯出多個資料表。

篩除資料列摘要

篩除資料列摘要會匯總因差異檢查而篩除的資料。篩除資料列中的資料在加總後會加進綜合資料列。雖然篩除後的資料無法進一步分析，但可以歸納出從結果中篩除的資料量。對於使用差異檢查隱私權模式的查詢，廣告資料中心會自動啟用及設定篩除資料列摘要。編輯查詢時，廣告資料中心會自動根據已選取的資料欄調整設定。如要進一步瞭解篩除資料列摘要，或手動設定摘要，請參閱「篩除資料列摘要」一文。

編輯報表

  1. 在廣告資料中心，開啟「報表」頁面。
  2. 按一下要編輯的報表名稱。
  3. 變更報表。例如編輯 SQL、管理參數值或設定時間表。
  4. 按一下 [儲存]。

執行報表

請先確認您已將服務帳戶的 dataEditor 權限授予將納入彙整輸出結果的資料集，再執行報表。進一步瞭解 BigQuery 中的存取權控管。

  1. 在廣告資料中心，開啟「報表」頁面。
  2. 按一下要執行的報表名稱。
  3. 按一下「執行」。

依排程執行報表

  1. 在廣告資料中心，開啟「報表」頁面。
  2. 按一下要設定排程的報表名稱。
    • 如要為新報表設定時間表，請建立報表，然後按一下「儲存」。
  3. 按一下「+ 設定時間表」。
  4. 在「時間表」窗格中，按一下「按照以下詳細資料排定執行這個報表的時間」切換按鈕，將其設為開啟。
  5. 在「頻率」下方，選取間隔和一天中的時間，然後輸入時區。
    • 如要改用 Cron 運算式，請按一下「使用 Cron 運算式設定排程」切換鈕，然後在方塊中輸入運算式。
  6. 按一下 [完成]。
  7. 按一下「儲存」，將變更套用至報表。

如要在「首頁」頁面顯示排定的工作，請從「擁有者」篩選器清單中選取「任何人」。

查看結果

報表執行完成後，您可以在報表詳細資料頁面中預覽結果。如要稍後查看結果，請從「首頁」開啟報表。此外，您也可以在 BigQuery、試算表或數據分析中探索資料。

預覽

在完成的工作內按一下「預覽」。前 20 筆結果會顯示在工作下方。

BigQuery

根據預設，結果會匯出至 BigQuery。按一下「查看表格」，在新視窗中開啟 BigQuery。

試算表與數據分析

開啟「探索」下拉式選單，然後選取「透過試算表探索」或「透過數據分析探索」。資料隨即在新視窗中顯示。