Google Ads Sorgu Dili (GAQL) sorgusu göndererek GoogleAdsService öğelerinin listesini ve özelliklerini alabilirsiniz. Öğeler, bir dizi öğeye özgü alanı kullanıma sunan asset öğesiyle temsil edilir.
Öğe özellikleri
Aşağıdaki GAQL sorgusu, bir Google Ads 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 bu sorguya türe özgü özellikler ekleyebilirsiniz.
Örneğin, aşağıdaki sorgu, asset.type değeri filtrelenerek bir Google Ads hesabındaki tüm YoutubeVideoAsset nesnelerinin YouTube video kimliklerini listeler. Olası asset.type 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 sunulur:
Bu kaynaklarla, öğe metriklerini ilgili her düzeyde 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 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üzeyindeki metrikler
Önemli nokta: ad_group_ad_asset_view yalnızca uygulama reklamları, Talep Yaratma ve duyarlı arama ağı 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, her bir tek reklam için öğelerle ilgili metrikleri 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 özel özelliği
performance_label gösterir. Aşağıdaki tabloda, performance_label alanlarının olası değerleri listelenmiştir.
performance_label | Açıklama |
|---|---|
BEST | En iyi performansa sahip öğ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 almak için istatistiksel olarak önemli değil. |
PENDING | Bu öğenin performansıyla ilgili henüz hiçbir bilgi yoktur. Bunun nedeni, inceleme sürecinin devam etmesi olabilir. |
UNKNOWN | Bu sürümde bilinmeyen değeri temsil eder. |
UNSPECIFIED | Belirtilmedi. |
Aşağıdaki GAQL sorgusu, son bir ay içinde bir Google Ads hesabındaki 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 değiştirilebilir öğeler için doğrudur.
RSA öğelerinin kaynağı için ad_group_ad_asset_view.source kullanın.