Raporlama

GoogleAdsService'e bir Google Ads Sorgu Dili (GAQL) sorgusu göndererek öğelerin ve özelliklerinin listesini alabilirsiniz. Öğeler, öğeye özel çok sayıda alanı gösteren asset varlığıyla temsil edilir.

Öğe özellikleri

Aşağıdaki GAQL sorgusu, bir reklamverenin 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 yukarıdaki sorguya ekleyebileceğiniz türe özgü özellikler olduğunu unutmayın.

Örneğin, aşağıdaki sorguda YoutubeVideoAsset için asset.type değerini filtreleyerek bir hesaptaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimlikleri listelenmektedir (olası tür değerlerinin listesi için belgelere 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ç kaynakla sunulur:

Bu kaynaklar sayesinde öğe metrikleri, her bir ilgili düzeyde sorgulanabilir. Örneğin, ad_group_asset kaynağını sorgularken, sonuçları segmentlere ayırmak için ad_group.id alanı kullanılabilir. Böylece, ad_group ve asset öğelerinin her bir benzersiz 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üzeyindeki metrikler

Öğeler için reklam düzeyindeki performans metrikleri ad_group_ad_asset_view'da toplanır. Bu görünüm, tek reklam başına öğe metriklerini toplar. Dolayısıyla, bu görünümün sorgulanması reklam grubu ve reklam başına bir satır döndürür.

ad_group_ad_asset_view, bu belirli öğe reklam eşlemesinin performans özellikleriyle ilgili analiz sağlayan görünüme özgü performance_label özelliğini sunar. performance_label alanlarının olası değerleri aşağıdaki tabloda sıralanmıştır.

performance_labelAçıklama
BESTEn iyi performans gösteren öğeler.
GOODİyi performans gösteren öğeler.
LOWEn kötü performans gösteren öğeler.
LEARNINGÖğe gösterim almaya başladı ancak istatistikler istatistiksel olarak öğe performans etiketi almaya yetecek kadar önemli değil.
PENDINGBu öğenin henüz hiçbir performans bilgisi yok. Bunun nedeni videonuzun hâlâ inceleniyor olması olabilir.
UNKNOWNBu sürümde bilinmeyen değeri temsil eder.
UNSPECIFIEDBelirtilmedi.

Aşağıdaki GAQL sorgusu, bir hesapta geçen ay içinde yer alan tüm öğeler için performance_label metriğine göre sıralanmış gösterim, tıklama, maliyet ve dönüşüm sayısını 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