Bạn có thể nhận danh sách các thành phần và thuộc tính của các thành phần đó bằng cách gửi truy vấn trên Ngôn ngữ truy vấn của Google Ads (GAQL) đến GoogleAdsService. Tài sản được biểu thị bằng thực thể asset
, hiển thị một số trường dành riêng cho tài sản.
Thuộc tính tài sản
Truy vấn GAQL sau đây liệt kê tất cả thành phần trong tài khoản của một nhà quảng cáo, cùng với tên và loại tài nguyên của các thành phần đó.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Xin lưu ý rằng có các thuộc tính cụ thể về từng loại mà bạn có thể thêm vào truy vấn ở trên để đọc các thuộc tính cụ thể cho các tài sản như ImageAsset
hoặc YoutubeVideoAsset
.
Ví dụ: truy vấn sau liệt kê mã video trên YouTube cho tất cả đối tượng YoutubeVideoAsset
trong một tài khoản bằng cách lọc ra giá trị asset.type
(xem tài liệu để biết danh sách các giá trị loại có thể có) cho YoutubeVideoAsset
.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
Các chỉ số về thành phần
Có một số tài nguyên để cung cấp các chỉ số về thành phần:
Với những tài nguyên này, bạn có thể truy vấn các chỉ số về thành phần ở từng cấp tương ứng.
Ví dụ: khi truy vấn tài nguyên ad_group_asset
, bạn có thể sử dụng trường ad_group.id
để phân đoạn kết quả, từ đó truy xuất các chỉ số cho từng tổ hợp riêng biệt của ad_group
và asset
:
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
Chỉ số cấp quảng cáo
Các chỉ số hiệu suất cấp quảng cáo cho các thành phần được tổng hợp trong
ad_group_ad_asset_view
. Chế độ xem này thu thập các chỉ số cho các thành phần của mỗi quảng cáo riêng lẻ. Do đó, việc truy vấn khung hiển thị này sẽ trả về một hàng cho mỗi
nhóm quảng cáo và quảng cáo.
ad_group_ad_asset_view
hiển thị thuộc tính performance_label
dành riêng cho chế độ xem, giúp cung cấp thông tin chi tiết về đặc điểm hiệu suất của việc kết hợp quảng cáo với thành phần cụ thể này. Bảng sau liệt kê các giá trị có thể có của các trường performance_label
.
performance_label | Nội dung mô tả |
---|---|
BEST | Những thành phần hoạt động hiệu quả nhất. |
GOOD | Thành phần hoạt động hiệu quả. |
LOW | Những thành phần hoạt động kém hiệu quả nhất. |
LEARNING | Tài sản đã bắt đầu nhận được lượt hiển thị nhưng số liệu thống kê không đủ ý nghĩa thống kê để được gắn nhãn hiệu suất của tài sản. |
PENDING | Thành phần này chưa có thông tin về hiệu suất. Lý do có thể là đơn khiếu nại này vẫn đang được xem xét. |
UNKNOWN | Biểu thị giá trị không xác định trong phiên bản này. |
UNSPECIFIED | Chưa chỉ định. |
Truy vấn GAQL sau đây trả về số lượt hiển thị, số lượt nhấp, chi phí và số lượt chuyển đổi cho
tất cả thành phần trong một tài khoản trong tháng trước, được sắp xếp theo
performance_label
của các thành phần đó:
SELECT
ad_group_ad_asset_view.ad_group_ad,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.field_type,
ad_group_ad_asset_view.performance_label,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label