Raporlar

GoogleAdsService'e bir Google Ads Sorgu Dili (GAQL) sorgusu göndererek öğelerin ve özelliklerinin listesini alabilirsiniz. Öğeler, öğeye özgü bir dizi alanı gösteren asset öğesiyle temsil edilir.

Öğe özellikleri

Aşağıdaki GAQL sorgusunda, bir reklamverenin hesabındaki tüm öğeler, kaynak adları ve türleriyle birlikte listelenir.

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

ImageAsset veya YoutubeVideoAsset gibi öğelere özgü özellikleri okumak için bu sorguya türe özgü özellikler ekleyebileceğinizi unutmayın.

Örneğin, aşağıdaki sorgu, YoutubeVideoAsset için asset.type değerini filtreleyerek (olası tür değerlerinin listesi için dokümana bakın) hesaptaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimliklerini listeler.

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

Öğe metrikleri

Öğe metrikleri birkaç kaynak üzerinden sunulur:

Bu kaynaklar sayesinde öğe metrikleri ilgili her düzeyde sorgulanabilir. Örneğin, ad_group_asset kaynağı sorgulanırken ad_group.id alanı, sonuçları segmentlere ayırmak için kullanılabilir. Böylece, her bir benzersiz ad_group ve asset kombinasyonu için metrikler alınır:

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

Reklam düzeyinde metrikler

Öğeler için reklam düzeyindeki performans metrikleri ad_group_ad_asset_view içinde toplanır. Bu görünüm, her reklam için öğelerle ilgili metrikleri toplar. Bu nedenle, bu görünümün sorgulanması her reklam grubu ve reklam için bir satır döndürür.

ad_group_ad_asset_view, bu belirli öğe-reklam eşleştirmesinin performans özellikleri hakkında bilgi veren görüntülemeye özel özelliği performance_label gösterir. performance_label alanlarının olası değerleri aşağıdaki tabloda listelenmiştir.

performance_labelAçıklama
BESTEn iyi performans gösteren öğeler.
GOODİyi performans gösteren öğeler.
LOWEn düşük performans gösteren öğeler.
LEARNINGÖğe gösterim almaya başlamış ancak istatistikler, öğe performansı etiketi almak için istatistiksel olarak yeterince anlamlı değil.
PENDINGBu öğenin performansıyla ilgili henüz hiçbir bilgi yoktur. Bunun nedeni, hâlâ inceleniyor olması olabilir.
UNKNOWNBu sürümde bilinmeyen değeri temsil eder.
UNSPECIFIEDBelirtilmedi.

Aşağıdaki GAQL sorgusu, bir hesaptaki tüm öğelerin son bir aydaki gösterim, tıklama, maliyet ve dönüşümlerini performance_label değerine göre sıralayarak döndürür:

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

Öğe Kaynağı

Asset.source yalnızca mutable öğeleri için doğrudur.

RSA öğelerinin kaynağı için AdGroupAdAsset.source.