建立及執行報表

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

建立報表

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

  1. 在廣告資料中心中，開啟「報表」頁面。
  2. 按一下「+ 建立報表」。「建立新報表」頁面隨即開啟。
    • 你可以搜尋、選取產品圖示及選擇下拉式選單選項，篩選範本。
  3. 選擇範本並按一下「使用範本」，或按一下「SQL」從頭開始建立。
    • 按一下「展開」expand_content，即可預覽範本詳細資料和 SQL。
  4. 如要編輯報表，請按一下「編輯查詢」。使用查詢編輯器執行下列操作：
    • 使用與 BigQuery 相容的 SQL自訂報表。
    • 在「Properties」分頁中設定參數。
    • 在「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. 在「Properties」下方，找出要刪除的參數，然後按一下旁邊的「Delete」。
  4. 依序點選「Done」(完成) 和「Save」(儲存)。

保留參數

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

start_date date

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

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

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

篩除資料列摘要

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

編輯報表

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

執行報表

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

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

依排程執行報表

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

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

查看結果

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

預覽

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

BigQuery

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

試算表與數據分析

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