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 truy vấn 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, thực thể này hiển thị một số trường dành riêng cho thành phầ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 Google Ads cùng với tên tài nguyên và loại của chúng.
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 thành phầ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ả
YoutubeVideoAsset đối tượng trong tài khoản Google Ads
bằng cách lọc giá trị asset.type. Xem danh sách các giá trị có thể cóasset.type.
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 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ả, nhờ đó 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
Điểm quan trọng: ad_group_ad_asset_view chỉ
trả về thông tin cho các thành phần liên quan đến Quảng cáo ứng dụng, 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. Thành phần hiển thị 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 thành phần 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.
The 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 nắm được thông tin chi tiết về các đặc điểm hiệu suất của cặp quảng cáo-thành phần
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 | Những thành phần hiệu quả nhất. |
GOOD | Những 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 đã 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ó bất kỳ thông tin hiệu suất nào. Nguyên nhân có thể là do thành phầ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 | Không được 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 các thành phần quảng cáo tìm kiếm thích ứng, hãy sử dụng
ad_group_ad_asset_view.source.