Raporlar

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

Öğ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

Bu sorguya türe özgü özellikler ekleyerek ImageAsset veya YoutubeVideoAsset gibi öğelere özgü özellikleri okuyabilirsiniz.

Örneğin, aşağıdaki sorgu, asset.type değeri filtrelenerek bir hesaptaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimliklerini listeler. YoutubeVideoAsset için olası tür 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 kullanılabilir:

• ad_group_asset
• campaign_asset
• customer_asset

Bu kaynaklarla, her düzeydeki öğe metriklerini 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 bir 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üzeyinde metrikler

Önemli Nokta: ad_group_ad_asset_view yalnızca uygulama 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, öğeler için metrikleri tek tek reklamlara göre 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 özgü özelliği performance_label gösterir. Aşağıdaki tabloda, performance_label alanlarının olası değerleri listelenmektedir.

performance_label	Açıklama
BEST	En iyi performansa sahip öğeler.
GOOD	İyi performans gösteren öğeler.
LOW	En düşük performans gösteren öğeler.
LEARNING	Öğe gösterim almaya başlamıştır ancak istatistikler, öğe performans etiketi almak için istatistiksel olarak yeterince anlamlı değildir.
PENDING	Bu öğenin performansıyla ilgili henüz hiçbir bilgi yoktur. Bunun nedeni, yorumun hâlâ inceleniyor olması olabilir.
UNKNOWN	Bu sürümde bilinmeyen değeri temsil eder.
UNSPECIFIED	Belirtilmedi.

Aşağıdaki GAQL sorgusu, son bir ay içinde bir hesaptaki 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 mutable öğeleri için doğrudur.

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