Raporlar

Google Ads Sorgu Dili (GAQL) sorgusu göndererek GoogleAdsService öğelerinin listesini ve özelliklerini alabilirsiniz. Öğeler, bir dizi öğeye özgü alanı kullanıma sunan asset öğesiyle temsil edilir.

Öğe özellikleri

Aşağıdaki GAQL sorgusu, bir Google Ads hesabındaki tüm öğeleri kaynak adı ve türüyle birlikte listeler.

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 ekleyebilirsiniz.

Örneğin, aşağıdaki sorgu, asset.type değeri filtrelenerek bir Google Ads hesabındaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimliklerini listeler. Olası asset.type değerlerinin listesine bakın.

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 aracılığıyla sunulur:

Bu kaynaklarla, öğe metriklerini ilgili her düzeyde sorgulayabilirsiniz. Örneğin, ad_group_asset kaynağını sorguladığınızda sonuçları segmentlere ayırmak için ad_group.id alanını kullanabilirsiniz. Böylece, ad_group ve asset'nin her benzersiz kombinasyonu için metrikleri alabilirsiniz:

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üzeyindeki metrikler

Önemli nokta: ad_group_ad_asset_view yalnızca uygulama reklamları, Talep Yaratma ve duyarlı arama ağı reklamlarıyla ilgili öğeler için bilgi döndürür.

Öğelerle ilgili reklam düzeyindeki performans metrikleri ad_group_ad_asset_view içinde toplanır. Bu görünüm, her bir tek reklam için öğelerle ilgili metrikleri toplar. Bu nedenle, bu görünüm sorgulandığında reklam grubu ve reklam başına bir satır döndürülür.

ad_group_ad_asset_view, bu belirli öğe-reklam eşlemesinin performans özellikleriyle ilgili bilgi veren görünüme özel özelliği performance_label gösterir. Aşağıdaki tabloda, performance_label alanlarının olası değerleri listelenmiştir.

performance_labelAçıklama
BESTEn iyi performansa sahip öğeler.
GOODİyi performans gösteren öğeler.
LOWEn kötü performans gösteren öğeler.
LEARNINGÖğe gösterim almaya başladı ancak istatistikler, öğe performans etiketi almak için istatistiksel olarak önemli değil.
PENDINGBu öğenin performansıyla ilgili henüz hiçbir bilgi yoktur. Bunun nedeni, inceleme sürecinin devam etmesi olabilir.
UNKNOWNBu sürümde bilinmeyen değeri temsil eder.
UNSPECIFIEDBelirtilmedi.

Aşağıdaki GAQL sorgusu, son bir ay içinde bir Google Ads hesabındaki tüm öğelerin gösterimlerini, tıklamalarını, maliyetlerini ve dönüşümlerini performance_label göre sıralanmış şekilde 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 değiştirilebilir öğeler için doğrudur.

RSA öğelerinin kaynağı için ad_group_ad_asset_view.source kullanın.