Bạn có thể nhận được 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 Google Ads
Ngôn ngữ truy vấn (GAQL) thành GoogleAdsService. Thành phần
được biểu thị bằng thực thể asset
. Thực thể này cho biết một số
của các trường nội dung cụ thể.
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 nhà quảng cáo tên và loại tài nguyên của chúng.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
Lưu ý rằng có những thuộc tính theo từng loại cụ thể mà bạn có thể thêm vào thuộc tính trên
để đọc các thuộc tính cụ thể cho nội dung, chẳng hạn như
ImageAsset
hoặc
YoutubeVideoAsset
.
Ví dụ: truy vấn sau đây liệt kê các mã video trên YouTube của tất cả
YoutubeVideoAsset
trong tài khoản bằng cách
lọc giá trị asset.type
(xem
tài liệu về 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
, ad_group.id
có thể được sử dụng để phân đoạn kết quả, từ đó truy xuất chỉ số cho mỗi
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ố về 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
cho nội dung trên mỗi quảng cáo riêng lẻ. Do đó, truy vấn khung hiển thị này sẽ trả về một hàng 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 theo từng khung hiển thị
performance_label
đó
cung cấp thông tin chi tiết về đặc điểm hiệu suất của quảng cáo thành phần cụ thể này
ghép nối. Các giá trị có thể có của các 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 có nhưng số liệu thống kê không đủ ý nghĩa thống kê để 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ả nội dung 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