Cấu trúc truy vấn và mệnh đề

Truy vấn được tạo thành từ một số mệnh đề: SELECT, FROM, WHERE, ORDER BY, LIMIT và PARAMETERS.

Các mệnh đề sử dụng tên trường, tên tài nguyên, toán tử, điều kiện và thứ tự kết hợp thành một yêu cầu truy vấn duy nhất.

Về cơ bản, để tạo truy vấn, bạn:

• Chỉ định một tài nguyên để truy xuất dữ liệu từ đó.
• Thêm các trường và chỉ số để xác định dữ liệu mà bạn muốn trả về.
• Thêm các phân đoạn để nhóm kết quả của bạn.
• Thêm tài nguyên được phân bổ để ngầm kết hợp dữ liệu tài nguyên có liên quan.
• Lọc, sắp xếp và giới hạn kết quả.

Mệnh đề SELECT

Mệnh đề SELECT:

• Là mệnh đề bắt buộc trong truy vấn.
• Chỉ định một tập hợp các trường để tìm nạp trong yêu cầu.
• Lấy danh sách các trường tài nguyên, cột tuỳ chỉnh, biến Floodlight tuỳ chỉnh, trường phân đoạn và chỉ số được phân tách bằng dấu phẩy rồi trả về các giá trị trong phản hồi.

Truy vấn mẫu này cho bạn biết cách chọn các thuộc tính của tài nguyên campaign:

SELECT
  campaign.id,
  campaign.name
FROM campaign

Nhiều loại trường

Bạn có thể yêu cầu nhiều loại trường trong cùng một yêu cầu.

Truy vấn mẫu bên dưới hiển thị một truy vấn với kết hợp:

• Trường tài nguyên: campaign.id, campaign.name, bidding_strategy.id và bidding_strategy.name.
• Trường phân đoạn: segments.device và segments.date.
• Trường chỉ số: metrics.impressions và metrics.clicks.

SELECT
  campaign.id,
  campaign.name,
  bidding_strategy.id,
  bidding_strategy.name,
  segments.device,
  segments.date,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Hãy xem phần Phân đoạn để tìm hiểu thêm về cách phân đoạn báo cáo tìm kiếm của bạn.

Trường tài nguyên chính

Thông thường, bạn cần đưa trường tài nguyên chính vào mệnh đề SELECT, nhưng điều này là không bắt buộc (không bắt buộc).

Truy vấn mẫu này sử dụng trường tài nguyên chính (ad_group.status) để chỉ lọc kết quả.

SELECT campaign.id
FROM ad_group
WHERE ad_group.status = PAUSED

Biến Floodlight tuỳ chỉnh

Bạn có thể đưa các biến Floodlight tuỳ chỉnh vào mệnh đề SELECT bằng cách sử dụng mã nhận dạng của các biến đó.

Trong ví dụ này, truy vấn bao gồm một biến tuỳ chỉnh có mã nhận dạng 123454321 cho tài nguyên chiến dịch.

SELECT
  conversion_custom_metrics.id[123454321]
FROM campaign

SELECT
  conversion_custom_dimensions.id[123454321]
FROM campaign

Cột tùy chỉnh

Bạn có thể đưa các cột tuỳ chỉnh vào mệnh đề SELECT bằng cách sử dụng mã nhận dạng của các cột đó.

Trong ví dụ này, truy vấn bao gồm một cột tuỳ chỉnh có mã nhận dạng 12345678 cho tài nguyên chiến dịch.

SELECT
  custom_columns.id[12345678]
FROM campaign

Xem cách lấy mã nhận dạng cột tuỳ chỉnh.

Trường chỉ số

Bạn có thể chọn các trường chỉ số cho một tài nguyên nhất định mà không cần bao gồm bất kỳ trường nào khác từ tài nguyên trong mệnh đề SELECT.

Truy vấn mẫu này chọn các chỉ số impressions và clicks cho tài nguyên campaign.

SELECT
  metrics.impressions,
  metrics.clicks
FROM campaign

Hãy xem metrics để biết danh sách trường chỉ số mà bạn có thể sử dụng trong truy vấn của mình.

Trường phân đoạn

Bạn có thể chọn các trường phân đoạn mà không cần chỉ định các trường tài nguyên hoặc chỉ số đi kèm trong mệnh đề SELECT.

Truy vấn trong ví dụ này phân đoạn các kết quả theo thiết bị.

SELECT segments.device
FROM campaign

Hãy xem segments để biết danh sách trường phân đoạn mà bạn có thể sử dụng trong truy vấn của mình.

Các trường bị cấm

Bạn không thể sử dụng các trường sau trong mệnh đề SELECT:

• Các trường không thể chọn, tức là các trường có thuộc tính siêu dữ liệu Selectable được đánh dấu là false.
• Các trường lặp lại, tức là các trường có thuộc tính siêu dữ liệu Repeated được đánh dấu là true.
• Các trường không sử dụng được đối với tài nguyên đã cho trong mệnh đề FROM. Bạn không thể chọn các thuộc tính của một số tài nguyên cùng nhau. Một số tài nguyên chỉ cung cấp một tập hợp con gồm tất cả các chỉ số và phân khúc.
• Phân đoạn hoặc chỉ số không tương thích. Vui lòng xem phần Phân đoạn để biết thêm thông tin.

Hãy xem Tài liệu tham khảo để biết thông tin chi tiết về nơi tìm thông tin này của từng tài nguyên.

Mệnh đề TỪ

Mệnh đề FROM:

• Là mệnh đề bắt buộc đối với các truy vấn đến SearchAds360Service (cả phương thức Search và SearchStream).
• Phải không được đưa vào cho các truy vấn đối với SearchAds360FieldService.
• Chỉ định tài nguyên chính mà truy vấn trả về.
• Chỉ có thể chỉ định một tài nguyên duy nhất.
• Xác định các trường mà bạn có thể sử dụng trong tất cả mệnh đề khác trong truy vấn.

Lưu ý: Trên mỗi trang tài nguyên trong phần Tài liệu tham khảo có một trường chọn Có/Không lọc ra các trường tài nguyên, phân đoạn và các trường chỉ số không thể sử dụng khi tài nguyên được chỉ định trong mệnh đề FROM.

Tài nguyên được phân bổ

Nếu có sẵn tài nguyên phân bổ, chúng sẽ được kết hợp ngầm với tài nguyên bạn chỉ định trong mệnh đề FROM. Bạn chỉ cần thêm các thuộc tính tương ứng vào mệnh đề SELECT để trả về giá trị.

Truy vấn ví dụ này trả về cả mã nhóm quảng cáo và mã chiến dịch, vì campaign là một tài nguyên phân bổ của tài nguyên ad_group.

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

Lưu ý: Không phải tài nguyên nào cũng được phân bổ tài nguyên. Phần Tệp đối chiếu cung cấp thông tin chi tiết về các tài nguyên được phân bổ có sẵn cho từng tài nguyên.

Trường resource_name

Trường resource_name của tài nguyên chính trong mệnh đề FROM luôn được trả về.

Trong truy vấn ví dụ này, ad_group.resource_name sẽ được đưa vào phản hồi, mặc dù không được chọn rõ ràng trong truy vấn:

SELECT ad_group.id
FROM ad_group

Hệ thống sẽ trả về trường resource_name của tài nguyên được phân bổ khi chọn ít nhất một trường.

Trong truy vấn mẫu này, campaign.resource_name sẽ được đưa vào phản hồi vì campaign.id được chọn:

SELECT
  campaign.id,
  ad_group.id
FROM ad_group

Lưu ý: Nếu tài nguyên trong mệnh đề FROM liệt kê một tài nguyên khác dưới dạng segment, thì việc chọn bất kỳ thuộc tính nào của tài nguyên đó đóng vai trò là một phân đoạn.

Mệnh đề WHERE

Mệnh đề WHERE:

• Là mệnh đề không bắt buộc trong truy vấn.
• Chỉ định các điều kiện để lọc và phân đoạn dữ liệu cho yêu cầu. Các điều kiện tuân theo mẫu sau: FIELD_NAME OPERATOR VALUE (phân tách bằng khoảng trống).
• Có thể bao gồm nhiều điều kiện được phân tách bằng dấu phân tách AND.

Truy vấn mẫu này cho thấy cách sử dụng mệnh đề WHERE để trả về các chỉ số impressions trong một khoảng thời gian nhất định:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Hãy xem phần Phân đoạn để tìm hiểu thêm về cách phân đoạn báo cáo tìm kiếm của bạn.

Hãy xem phần Phạm vi ngày để tìm hiểu thêm về cách chỉ định phạm vi ngày trong truy vấn của bạn.

Lọc theo trường resource_name

Bạn có thể dùng trường resource_name để lọc hoặc sắp xếp dữ liệu.

Truy vấn mẫu sau sử dụng trường campaign.resource_name để lọc kết quả theo một chiến dịch nhất định:

SELECT
  campaign.id,
  campaign.name
FROM campaign
WHERE campaign.resource_name = 'customers/1234567/campaigns/987654'

Nhiều điều kiện

Bạn có thể kết hợp nhiều điều kiện để lọc dữ liệu.

Truy vấn ví dụ này yêu cầu số lượng chỉ số clicks cho tất cả chiến dịch có chỉ số impressions trên thiết bị di động trong 30 ngày qua.

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  metrics.clicks
FROM campaign
WHERE metrics.impressions > 0
  AND segments.device = MOBILE
  AND segments.date DURING LAST_30_DAYS

Lưu ý: Bạn chỉ có thể sử dụng dấu phân cách AND giữa các điều kiện toán tử (WHERE segments.device != "DESKTOP" AND segments.device != "MOBILE") chứ không thể dùng trong một điều kiện toán tử (WHERE segments.device != "DESKTOP" AND "MOBILE").

Hãy xem phần Phân đoạn để tìm hiểu thêm về cách phân đoạn báo cáo của bạn.

Có phân biệt chữ hoa chữ thường

Khi lọc các giá trị chuỗi, độ phân biệt chữ hoa chữ thường mặc định của mỗi toán tử đóng vai trò quan trọng trong việc lọc chính xác kết quả.

Bảng sau đây cho thấy độ phân biệt chữ hoa chữ thường mặc định của từng toán tử.

Phân biệt chữ hoa chữ thường mặc định
=/!=	Case sensitive
IN/NOT IN	Case sensitive
LIKE/NOT LIKE	Case insensitive
CONTAINS (...)	Case sensitive
REGEXP_MATCH/NOT REGEXP_MATCH	Case sensitive

Bạn có thể sử dụng đối tượng sửa đổi (?i) để thay đổi độ nhạy mặc định cho REGEXP_MATCH và NOT REGEXP_MATCH thành không phân biệt chữ hoa chữ thường, ví dụ:

SELECT campaign.id
FROM campaign
WHERE campaign.name REGEXP_MATCH "(?i).*test.*"

Hãy xem Tài liệu tham khảo ngữ pháp truy vấn để biết danh sách đầy đủ các toán tử bạn có thể sử dụng để lọc dữ liệu của mình.

Phân đoạn ngày chính

Các trường phân đoạn sau đây được gọi là phân đoạn ngày chính: segments.date, segments.week, segments.month, segments.quarter và segments.year.

Bạn có thể sử dụng các phân đoạn ngày chính trong mệnh đề WHERE để chỉ định ngày hoặc khoảng thời gian.

Truy vấn mẫu này chỉ định DURING LAST_30_DAYS cho trường segments.date trong mệnh đề WHERE:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Vui lòng xem phần Phân đoạn > Phân đoạn ngày chính để biết thông tin chi tiết về cách sử dụng phân đoạn ngày chính.

Lọc bị cấm

Không cho phép lọc:

• Trên các trường phân đoạn không được chọn, ngoại trừ phân đoạn ngày chính.
• Trên các trường thuộc bất kỳ loại thông báo nào, ngoại trừ dữ liệu gốc (ví dụ: Int64Value, StringValue, v.v.).
• Trên các thuộc tính của các trường lặp lại thuộc bất kỳ loại thông báo nào, ngoại trừ các dữ liệu gốc (ví dụ: Int64Value, StringValue, v.v.).

SẮP XẾP THEO mệnh đề

Mệnh đề ORDER BY:

• Là mệnh đề không bắt buộc trong truy vấn.
• Chỉ định thứ tự mà kết quả được trả về. Cách sắp xếp sẽ tuân theo mẫu sau: FIELD_NAME ORDERING_OPTION (phân tách bằng một khoảng trống).
• Cho phép 2 lựa chọn: ASC (tăng dần) hoặc DESC (giảm dần). Giá trị mặc định là tăng dần.

Truy vấn ví dụ này sắp xếp các chiến dịch theo số lượt nhấp theo thứ tự giảm dần (cao nhất đến thấp nhất):

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
ORDER BY metrics.clicks DESC

Nhiều đơn đặt hàng

Bạn có thể chỉ định nhiều trường trong mệnh đề ORDER BY bằng cách sử dụng danh sách được phân tách bằng dấu phẩy. Kết quả sẽ được sắp xếp theo trình tự mà bạn chỉ định trong truy vấn.

Truy vấn mẫu này chọn dữ liệu nhóm quảng cáo và sắp xếp kết quả theo thứ tự tăng dần theo tên chiến dịch, sau đó theo thứ tự giảm dần theo số lượt hiển thị và sau đó theo thứ tự giảm dần theo số lượt nhấp:

SELECT
  campaign.name,
  ad_group.name,
  metrics.impressions,
  metrics.clicks
FROM ad_group
ORDER BY
  campaign.name,
  metrics.impressions DESC,
  metrics.clicks DESC

Kết hợp thứ tự và giới hạn

Bạn có thể sử dụng mệnh đề ORDER BY kết hợp với mệnh đề LIMIT để tinh chỉnh kết quả.

Truy vấn mẫu này trả về 5 chiến dịch có số lượt hiển thị cao nhất trong 30 ngày qua:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Thứ tự bị cấm

Không cho phép đặt hàng:

• Theo thuộc tính của các tài nguyên không được chọn.
• Theo các chỉ số không được chọn.
• Theo phân khúc không được chọn.
• Đối với các loại trường sau:
  • MESSAGE
  • Các trường lặp lại
  • Thuộc tính của các trường lặp lại.

Mệnh đề LIMIT

Mệnh đề LIMIT:

• Là mệnh đề không bắt buộc trong truy vấn.
• Cho phép bạn giới hạn số lượng kết quả mà truy vấn trả về.

Mệnh đề này hữu ích, chẳng hạn như khi bạn chỉ quan tâm đến một mẫu hoặc bản tóm tắt kết quả.

Truy vấn ví dụ này giới hạn tổng số kết quả là 50:

SELECT
  campaign.name,
  ad_group.name,
  segments.device,
  metrics.impressions
FROM ad_group
ORDER BY metrics.impressions DESC
LIMIT 50

Mệnh đề THAM SỐ

Mệnh đề PARAMETERS cho phép bạn chỉ định tham số meta cho yêu cầu.

Bao gồm bản thảo

Tham số include_drafts kiểm soát việc các thực thể nháp có được đưa vào kết quả hay không. Giá trị mặc định là false. Hãy đặt thuộc tính này thành true để bao gồm các thực thể nháp.

Truy vấn ví dụ sau trả về cả chiến dịch dự thảo và chiến dịch thông thường:

SELECT campaign.name
FROM campaign
PARAMETERS include_drafts=true

Bỏ chọn resource_name

Tham số omit_unselected_resource_names cho phép bạn loại trừ trường resource_name của mọi tài nguyên không được yêu cầu rõ ràng trong mệnh đề SELECT. Giá trị mặc định là false. Nếu thiết lập tham số này thành true, bạn nên yêu cầu rõ ràng tên tài nguyên của tài nguyên chính và mọi tài nguyên phân bổ trong mệnh đề SELECT.

Truy vấn ví dụ này không trả về cả trường campaign.resource_name lẫn trường customer.resource_name, vì chúng không có trong mệnh đề SELECT:

SELECT
  campaign.name,
  customer.id
FROM campaign
PARAMETERS omit_unselected_resource_names = true

Truy vấn mẫu này trả về trường campaign.resource_name vì trường này được yêu cầu rõ ràng trong mệnh đề SELECT:

SELECT
  campaign.name,
  campaign.resource_name
FROM campaign
PARAMETERS omit_unselected_resource_names = true

Thay đổi đơn vị tiền tệ dùng trong các chỉ số

Tham số metrics_currency cho phép bạn chỉ định đơn vị tiền tệ cần sử dụng khi tính toán một chỉ số có trong mệnh đề SELECT. Tuỳ chọn mặc định là sử dụng nội tệ cho tài khoản. Nếu đặt tham số này, bạn cần sử dụng mã đơn vị tiền tệ gồm 3 ký tự theo tiêu chuẩn ISO 4217. Ví dụ: USD, EUR.

Truy vấn ví dụ này trả về chỉ số cost_micros bằng nội tệ của tài khoản.

SELECT
  campaign.name,
  metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"

Truy vấn ví dụ này trả về chỉ số cost_micros bằng peso Chile (CLP).

SELECT
  campaign.name,
  metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"
PARAMETERS metrics_currency = "CLP"

Tìm hiểu thêm

• Ngữ pháp truy vấn