Raporlama

GoogleAdsService'e bir Google Ads Sorgu Dili (GAQL) sorgusu göndererek öğelerin ve özelliklerinin listesini alabilirsiniz. Öğeler, asset varlığıyla temsil edilir. Bu varlık, öğeye özel çeşitli alanlar sunar.

Öğe özellikleri

Aşağıdaki GAQL sorgusu, bir reklamverenin hesabındaki tüm öğeleri kaynak adları ve türleriyle 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 sorgu, YoutubeVideoAsset için asset.type değerini filtreleyerek bir hesaptaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimliklerini listeler. (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ç kaynak üzerinden sunulur:

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

Öğeler için reklam düzeyindeki performans metrikleri ad_group_ad_asset_view'nda toplanır. Bu görünüm, her bir reklamdaki öğe metriklerini toplar. Dolayısıyla, 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şlemenin performans özellikleri hakkında bilgi veren görünüme özgü performance_label özelliğini 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 kötü performans gösteren öğeler.
LEARNINGÖğe gösterim almaya başladı ancak istatistikler öğe performans etiketi alacak 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, geçen ay bir hesapta bulunan tüm öğeler için performance_label ölçütüne göre sıralanmış gösterimleri, tıklamaları, maliyetleri ve dönüşümleri 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