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_label | Açıklama |
---|---|
BEST | En iyi performans gösteren öğeler. |
GOOD | İyi performans gösteren öğeler. |
LOW | En 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. |
PENDING | Bu öğenin henüz hiçbir performans bilgisi yok. Bunun nedeni videonuzun hâlâ inceleniyor olması olabilir. |
UNKNOWN | Bu sürümde bilinmeyen değeri temsil eder. |
UNSPECIFIED | Belirtilmedi. |
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