Bạn có thể lấy danh sách thành phần và thuộc tính của thành phần bằng cách gửi một truy vấn bằng 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, cho thấy một số trường dành riêng cho tài sản.
Thuộc tính của thành phần
Truy vấn GAQL sau đây liệt kê tất cả thành phần trong một tài khoản Google Ads 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
Bạn có thể thêm các thuộc tính theo loại cụ thể vào truy vấn này để đọc các thuộc tính dành riêng cho tài sản, chẳng hạ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 Google Ads bằng cách lọc giá trị asset.type. Hãy xem danh sách các giá trị asset.type có thể áp dụng.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
Chỉ số về 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ố 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
Điểm mấu chốt: ad_group_ad_asset_view chỉ trả về thông tin cho những thành phần liên quan đến Quảng cáo ứng dụng, chiến dịch Tạo nhu cầu và quảng cáo tìm kiếm thích ứng.
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 theo 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, giúp bạn hiểu rõ các đặc điểm về hiệu suất của kiểu kết hợp thành phần-quảng cáo cụ thể này. Bảng sau đây liệt kê các giá trị có thể có của các trường performance_label.
performance_label | Mô tả |
|---|---|
BEST | 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 kém hiệu quả nhất. |
LEARNING | Thành phần đã bắt đầu nhận được lượt hiển thị nhưng số liệu thống kê chưa đủ ý nghĩa thống kê để nhận được nhãn hiệu suất thành phần. |
PENDING | Thành phần này chưa có thông tin về hiệu suất. Điều này có thể là do ứng dụng vẫn đang được xem xét. |
UNKNOWN | Đại diện cho 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ả các thành phần trong tài khoản Google Ads 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 tài sản
Asset.source chỉ chính xác đối với các thành phần có thể thay đổi.
Đối với nguồn của thành phần RSA, hãy sử dụng ad_group_ad_asset_view.source.