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_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 öğe performans etiketi alacak 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, 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