Ingin menyampaikan masukan tentang Google Ads API? Daftar untuk diundang berpartisipasi dalam riset pengguna.

Halaman ini diterjemahkan oleh Cloud Translation API.

Laporan

Anda bisa mendapatkan daftar aset beserta atributnya dengan mengirimkan kueri Bahasa Kueri Google Ads (GAQL) ke GoogleAdsService. Aset diwakili oleh entitas asset, yang menampilkan sejumlah kolom khusus aset.

Atribut aset

Kueri GAQL berikut mencantumkan semua aset di akun pengiklan beserta nama dan jenis resource-nya.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

Perhatikan bahwa ada atribut khusus jenis yang dapat Anda tambahkan ke kueri ini untuk membaca properti khusus untuk aset seperti ImageAsset atau YoutubeVideoAsset.

Misalnya, kueri berikut mencantumkan ID video YouTube untuk semua objek YoutubeVideoAsset di sebuah akun dengan memfilter nilai asset.type (lihat dokumentasi untuk mengetahui daftar kemungkinan nilai jenis) untuk YoutubeVideoAsset.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

Metrik aset

Metrik aset tersedia melalui beberapa resource:

Dengan resource ini, metrik aset dapat dikueri di setiap levelnya. Misalnya, saat membuat kueri resource ad_group_asset, kolom ad_group.id dapat digunakan untuk menyegmentasikan hasil, sehingga akan mengambil metrik untuk setiap kombinasi unik ad_group dan 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

Metrik tingkat iklan

Metrik performa tingkat iklan untuk aset digabungkan di ad_group_ad_asset_view. Tampilan ini mengumpulkan metrik untuk aset per iklan. Dengan demikian, membuat kueri tampilan ini akan menampilkan baris per grup iklan dan iklan.

ad_group_ad_asset_view mengekspos atribut khusus tampilan performance_label yang memberikan insight tentang karakteristik performa dari pasangan iklan aset tertentu ini. Kemungkinan nilai kolom performance_label dihitung dalam tabel berikut.

`performance_label`	Deskripsi
`BEST`	Aset berperforma terbaik.
`GOOD`	Aset berperforma baik.
`LOW`	Aset berperforma terburuk.
`LEARNING`	Aset telah mulai mendapatkan tayangan iklan, tetapi statistiknya tidak cukup signifikan secara statistik untuk mendapatkan label performa aset.
`PENDING`	Aset ini belum memiliki informasi performa apa pun. Hal ini mungkin karena video tersebut masih dalam peninjauan.
`UNKNOWN`	Merepresentasikan nilai yang tidak diketahui dalam versi ini.
`UNSPECIFIED`	Tidak ditentukan.

Kueri GAQL berikut menampilkan tayangan, klik, biaya, dan konversi untuk semua aset di akun selama sebulan terakhir, yang diurutkan menurut 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

Sumber Aset

Asset.source hanya akurat untuk Aset mutable.

Untuk sumber penggunaan Aset RSA, AdGroupAdAsset.source.

Sebelumnya

Menangani aset