編寫及執行查詢

建立查詢

  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

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

篩除資料列摘要

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

編輯查詢

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

執行查詢

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

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

查看結果

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

預覽

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

BigQuery

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

試算表與數據分析

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