建立查詢
- 前往廣告資料中心的「查詢」分頁。
- 按一下「+ 建立查詢」。「分析查詢範本」頁面隨即開啟。
- 選用步驟:按一下「展開」 ,即可預覽範本 SQL。
- 按一下「使用範本」來選取要使用的範本,也可以點選「空白」從頭開始建立。
- 輸入報表名稱。
- 使用與 BigQuery 相容的 SQL 來編寫或編輯查詢。您可以從「Google 表格」分頁尋找可用的表格和欄位,然後插入 SQL 中。
- 選用步驟:設定參數。
- 選用步驟:設定篩除資料列摘要。
- 按一下「儲存」。
參數
參數可讓查詢更有彈性。舉例來說,如要為不同廣告活動執行相同的查詢,可以設定參數,讓系統在執行查詢時從「執行」資訊卡輸入一或多個廣告活動 ID;如此一來,您就不需要建立重複的查詢,或在每次執行前透過硬式編碼寫入廣告活動 ID。使用參數可讓程式碼保持簡潔,減少編輯時出錯的可能性,現有查詢甚至不經編輯就能重複使用。參數範圍限於建立該參數的查詢,因此可以在其他查詢中重複使用參數名稱。
參數類型
允許使用以下參數類型:
int64
float64
bool
string
date
timestamp
array
(任何允許使用的類型)
建立參數
- 開啟已儲存的查詢,或建立新查詢。
- 依序按一下「屬性」>「參數」>「新增參數」。
- 在「名稱」欄位中輸入名稱。此名稱會用來在查詢文字中指稱參數。
- 使用下拉式選單選取參數類型。
- 如果選取陣列,就會出現額外的下拉式選單。請在下拉式選單中選取陣列類型。
- 視需要重複步驟 2 至 4,直到加入所有需要的參數。
- 按一下「儲存」
使用參數
在查詢文字中使用標準 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
執行查詢時,「新工作」對話方塊會包含「參數」欄位。請為已定義的每項參數輸入值。
移除參數
- 開啟要刪除參數的查詢。
- 開啟「屬性」分頁。
- 在「參數」資訊卡中找出要刪除的參數,然後按一下旁邊的「刪除」。
- 按一下「儲存」。
保留參數
下表列出廣告資料中心保留的參數。您可以在查詢中使用這些參數,但無法建立與保留參數同名的參數。
start_date
|
date
查詢工作的開始日期 (含此日期)。系統會忽略使用這個名稱的使用者定義參數,並替換成「新工作」對話方塊中設定的值。 |
end_date
|
date
查詢工作的結束日期 (含此日期)。系統會忽略使用這個名稱的使用者定義參數,並替換成「新工作」對話方塊中設定的值。 |
time_zone
|
string
查詢工作的時區。系統會忽略使用這個名稱的使用者定義參數,並替換成「新工作」對話方塊中設定的值。 |
篩除資料列摘要
篩除資料列摘要會匯總因隱私權檢查而篩除的資料。篩除資料列中的資料在加總後會加進綜合資料列。雖然篩除後的資料無法進一步分析,但可以歸納出從結果中篩除的資料量。
編輯查詢
- 前往廣告資料中心的「查詢」分頁。
- 按一下要編輯的查詢名稱。
- 編輯查詢。
- 按一下「儲存」。
執行查詢
請先確認您已將服務帳戶的 dataEditor
權限授予將納入彙整輸出結果的資料集,再執行查詢。進一步瞭解 BigQuery 中的存取權控管。
- 前往廣告資料中心的「查詢」分頁。
- 按一下要執行的查詢名稱。
- 按一下
- 頁面頂端會顯示該查詢預估使用的位元組數。
「執行」。
- 在「廣告資料來源」下拉式選單中選取 ID,此 ID 必須與要查詢的廣告資料連結 (如要查詢沙箱資料,請選取「廣告資料中心沙箱客戶」)。
- 如果使用對照表,請從「對照表來源」下拉式選單選取對照表。
- 在「目的地表格」欄位中,指定要儲存查詢結果的位置。
- 輸入開始和結束日期,指定查詢的日期範圍。
- 輸入時區。必須與購買平台的時區一致。
- 視需要輸入任一參數的值。
- 按一下「執行」。
查看結果
查詢執行完成後,您可以在「工作」頁面上預覽結果。此外,您也可以在 BigQuery、試算表或數據分析中研究資料。
預覽
在完成的工作內按一下「預覽」。前 20 筆結果會顯示在工作下方。
BigQuery
根據預設,結果會匯出至 BigQuery。按一下「查看表格」,在新視窗中開啟 BigQuery。
試算表與數據分析
開啟「探索」下拉式選單,然後選取「透過試算表探索」或「透過數據分析探索」。資料隨即在新視窗中顯示。