Bạn có thể lấy danh sách các thành phần và thuộc tính của chúng 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
, hiển thị 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ả các thành phần trong tài khoản của nhà quảng cáo cùng với tên tài nguyên và loại của 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 dành riêng cho loại 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ả các đối tượng YoutubeVideoAsset
trong một tài khoản bằng cách lọc giá trị asset.type
. Xem 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ố về thành phần
Các chỉ số về thành phần được cung cấp thông qua một số tài nguyên:
Với những tài nguyên này, bạn có thể truy vấn các chỉ số về tài sả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ố về 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 khung hiển thị performance_label
. Thuộc tính này cung cấp thông tin chi tiết về các đặc điểm hiệu suất của việc ghép nối quảng cáo dựa trên thành phần cụ thể này. Bảng sau đây liệt kê các giá trị có thể có của trường performance_label
.
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 thành phần. |
PENDING | Thành phần này chưa có thông tin về hiệu suất. Nguyên nhân có thể là do yêu cầu của bạn 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ả cá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
.
Để biết nguồn sử dụng Thành phần RSA, hãy dùng AdGroupAdAsset.source
.