GoogleAdsService'e bir Google Ads Sorgu Dili (GAQL) sorgusu göndererek öğelerin ve özelliklerinin listesini alabilirsiniz. Öğeler, öğeye özgü bir dizi alanı gösteren asset
öğesiyle temsil edilir.
Öğe özellikleri
Aşağıdaki GAQL sorgusunda, bir reklamverenin hesabındaki tüm öğeler, kaynak adları ve türleriyle birlikte listelenir.
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 ekleyebileceğinizi unutmayın.
Örneğin, aşağıdaki sorgu, YoutubeVideoAsset
için asset.type
değerini filtreleyerek (olası tür değerlerinin listesi için dokümana bakın) hesaptaki tüm YoutubeVideoAsset
nesnelerinin YouTube video kimliklerini listeler.
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 kaynaklar sayesinde öğe metrikleri ilgili her düzeyde sorgulanabilir.
Örneğin, ad_group_asset
kaynağı sorgulanırken ad_group.id
alanı, sonuçları segmentlere ayırmak için kullanılabilir. Böylece, her bir 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üzeyinde metrikler
Öğeler için reklam düzeyindeki performans metrikleri ad_group_ad_asset_view
içinde toplanır. Bu görünüm, her reklam için öğelerle ilgili metrikleri toplar. Bu nedenle, 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şleştirmesinin performans özellikleri hakkında bilgi veren görüntülemeye özel özelliği performance_label
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 düşük performans gösteren öğeler. |
LEARNING | Öğe gösterim almaya başlamış ancak istatistikler, öğe performansı etiketi almak için istatistiksel olarak yeterince anlamlı değil. |
PENDING | Bu öğenin performansıyla ilgili henüz hiçbir bilgi yoktur. Bunun nedeni, hâlâ inceleniyor olması olabilir. |
UNKNOWN | Bu sürümde bilinmeyen değeri temsil eder. |
UNSPECIFIED | Belirtilmedi. |
Aşağıdaki GAQL sorgusu, bir hesaptaki tüm öğelerin son bir aydaki gösterim, tıklama, maliyet ve dönüşümlerini performance_label
değerine göre sıralayarak 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
.