編寫及執行查詢

建立查詢

  1. 前往廣告資料中心的「查詢」分頁。
  2. 按一下「+ 建立查詢」。「分析查詢範本」頁面隨即開啟。
  3. 選用步驟:按一下「展開」,即可預覽範本 SQL
  4. 按一下「使用範本」來選取要使用的範本,也可以點選「空白」從頭開始建立。
  5. 輸入報表名稱。
  6. 使用與 BigQuery 相容的 SQL 來編寫或編輯查詢。您可以從「Google 表格」分頁尋找可用的表格和欄位,然後插入 SQL 中。
  7. 選用步驟:設定參數
  8. 選用步驟:設定篩除資料列摘要
  9. 按一下「儲存」

參數

參數可讓查詢更有彈性。舉例來說,如要為不同廣告活動執行相同的查詢,可以設定參數,讓系統在執行查詢時從「執行」資訊卡輸入一或多個廣告活動 ID;如此一來,您就不需要建立重複的查詢,或在每次執行前透過硬式編碼寫入廣告活動 ID。使用參數可讓程式碼保持簡潔,減少編輯時出錯的可能性,現有查詢甚至不經編輯就能重複使用。參數範圍限於建立該參數的查詢,因此可以在其他查詢中重複使用參數名稱。

參數類型

允許使用以下參數類型:

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

建立參數

  1. 開啟已儲存的查詢,或建立新查詢
  2. 依序按一下「屬性」>「參數」>「新增參數」
  3. 在「名稱」欄位中輸入名稱。此名稱會用來在查詢文字中指稱參數。
  4. 使用下拉式選單選取參數類型。
    • 如果選取陣列,就會出現額外的下拉式選單。請在下拉式選單中選取陣列類型。
  5. 視需要重複步驟 2 至 4,直到加入所有需要的參數。
  6. 按一下「儲存」

使用參數

在查詢文字中使用標準 SQL 參數格式,也就是在參數名稱前面加上 @。在以下範例中,查詢內容包含名為 @campaign_ids 的參數:

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

  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

執行查詢時,「新工作」對話方塊會包含「參數」欄位。請為已定義的每項參數輸入值。

移除參數

  1. 開啟要刪除參數的查詢。
  2. 開啟「屬性」分頁。
  3. 在「參數」資訊卡中找出要刪除的參數,然後按一下旁邊的「刪除」。
  4. 按一下「儲存」。

保留參數

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

start_date date

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

end_date date

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

time_zone string

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

params string

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

篩除資料列摘要

篩除資料列摘要會匯總因隱私權檢查而篩除的資料。篩除資料列中的資料在加總後會加進綜合資料列。雖然篩除後的資料無法進一步分析,但可以歸納出從結果中篩除的資料量。

編輯查詢

  1. 前往廣告資料中心的「查詢」分頁。
  2. 按一下要編輯的查詢名稱。
  3. 編輯查詢。
  4. 按一下「儲存」

執行查詢

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

  1. 前往廣告資料中心的「查詢」分頁。
  2. 按一下要執行的查詢名稱。
  3. 按一下 「執行」
    • 頁面頂端會顯示該查詢預估使用的位元組數。
  4. 在「廣告資料來源」欄位中選取 ID,此 ID 必須與要查詢的廣告資料連結 (如要查詢沙箱資料,請選取「廣告資料中心沙箱客戶」)。
  5. 如果使用對照表,請在「對照表來源」欄位中選取對照表。
  6. 選取隱私模式。進一步瞭解隱私權模式
  7. 在「目的地表格」欄位中,指定要儲存查詢結果的位置。
  8. 輸入開始和結束日期,指定查詢的日期範圍。
  9. 輸入時區。必須與購買平台的時區一致。
  10. 視需要輸入任一參數的值。
  11. 按一下「執行」

查看結果

查詢執行完成後,您可以在「工作」頁面上預覽結果。此外,您也可以在 BigQuery、試算表或數據分析中研究資料。

預覽

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

BigQuery

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

試算表與數據分析

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