Bạn có thể lấy danh sách thành phần và các thuộc tính của thành phần đó bằng cách gửi truy vấn bằng Ngôn ngữ truy vấn Google Ads (GAQL) đến GoogleAdsService. Các thành phần được biểu thị bằng thực thể asset, hiển thị một số trường dành riêng cho thành phần.
Thuộc tính thành phần
Truy vấn GAQL sau đây liệt kê tất cả thành phần trong tài khoản của nhà quảng cáo cùng với tên và loại tài nguyên.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Xin lưu ý rằng có một số thuộc tính dành riêng cho loại mà bạn có thể thêm vào truy vấn này để đọc các thuộc tính dành riêng cho các thành phần như ImageAsset hoặc YoutubeVideoAsset.
Ví dụ: truy vấn sau đây 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 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'
Chỉ số thành phần
Bạn có thể xem các chỉ số về thành phần thông qua một số tài nguyên:
Với các tài nguyên này, bạn có thể truy vấn các chỉ số 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 duy nhấ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 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 thành phần trên từng quảng cáo riêng lẻ. Do đó, việc truy vấn chế độ xem 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 dành riêng cho thành phần hiển thị performance_label, cung cấp thông tin chi tiết về các đặc điểm hiệu suất của cặp thành phần-quảng cáo cụ thể này. Các giá trị có thể có của trường performance_label được liệt kê trong bảng sau.
performance_label | 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 | Thành phần này đã bắt đầu nhận được lượt hiển thị nhưng số liệu thống kê chưa đủ ý nghĩa để nhận được nhãn hiệu suất của thành phần. |
PENDING | Thành phần này chưa có thông tin về hiệu suất. Có thể là do yêu cầu đó 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:
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
Nguồn của thành phần
Asset.source chỉ chính xác đối với Thành phần mutable.
Đối với nguồn sử dụng Tài sản RSA, hãy sử dụng AdGroupAdAsset.source.