Alışveriş reklamları için ürün raporlama

Diğer reklam türlerinde olduğu gibi, Alışveriş ürünlerinin ürün durumu ve performans verilerini almak için GoogleAdsService.SearchStream kullanabilirsiniz.

Google Merchant Center feed'indeki ürünleri destekleyen kampanyalarda aşağıdaki özel raporlar bulunur:

• Alışveriş Performansı Görünümü
• Ürün Grubu Görünümü
• Öğe Grubu Ürün Grubu Görünümü
• Alışveriş Ürünü
• Alışveriş sepeti verileri satış görünümü (v24 ve sonraki sürümlerde kullanılabilir)
• Nihai URL genişletmesi öğe görünümü (v26 ve sonraki sürümlerde Alışveriş kampanyaları için kullanılabilir)

Ayrıca, 26. sürümden itibaren Alışveriş kampanyalarında, AI Max (campaign.ai_max_setting.enable_ai_max = true) ve nihai URL genişletmesi (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) etkinleştirildiğinde yayınlanan metin özelleştirme öğeleri final_url_expansion_asset_view tarafından raporlanır. Sorgu koşulları ve örnek için Nihai URL genişletmesi öğe görünümü bölümüne bakın.

Not: Hem shopping_performance_view hem de shopping_product, ürün düzeyinde metrikler döndürür. shopping_performance_view, reklam yayınlayan bir ürünün geçmişteki durumunu, shopping_product ise reklam yayınlayıp yayınlamadığına bakılmaksızın bir ürünün mevcut durumunu gösterir. shopping_product özelliğini öncelikli olarak bir ürünün mevcut durumunu ve bir kampanya tarafından kullanılmasını engelleyen sorunları değerlendirmek için kullanın.

Alışveriş Performansı Görünümü

Alışveriş Performansı Görünümü, ürünler için product_item_id gibi özelliklere göre toplu geçmiş raporlama istatistikleri sağlar.

Alışveriş, Maksimum Performans, Talep Yaratma, video, uygulama ve Görüntülü Reklam Ağı kampanyaları dahil olmak üzere Google Merchant Center'daki ürün feed'lerini kullanan tüm kampanya türlerini destekler.

Not: 15 Haziran 2026'dan itibaren Alışveriş Performansı Görünümü, tüm Maksimum Performans ağlarından gelen verileri içerecek. Daha önce hariç tutulan ağlardan (ör. YouTube) gelen veriler dahil edildiğinden, Maksimum Performans kampanyaları için raporlanan metriklerde tek seferlik bir artış görebilirsiniz.

Alışveriş Performansı Görünümü, ilgili metriklerin kaydedildiği sırada ürünün durumunu yakalar. Buna, metrik kaydedildiğinden beri değişmiş olabilecek product_title gibi segmentler dahildir.

shopping_performance_view, aşağıdaki segmentleri ve metrikleri de destekler:

• segments.ad_sub_network_type (product_group_view ve asset_group_product_group_view dillerinde de desteklenir).
• Dönüşüm tarihine göre segmentlere ayrılmış metrikler: metrics.conversions_by_conversion_date, metrics.all_conversions_by_conversion_date, metrics.conversions_value_by_conversion_date, metrics.all_conversions_value_by_conversion_date, metrics.value_per_conversions_by_conversion_date ve metrics.value_per_all_conversions_by_conversion_date.
• Rekabetçi gösterim payı metrikleri: metrics.search_budget_lost_impression_share, metrics.search_rank_lost_impression_share, metrics.search_budget_lost_absolute_top_impression_share ve metrics.search_rank_lost_absolute_top_impression_share.
• 24 ve sonraki sürümlerde kullanılabilir: segments.conversion_attribution_event_type segmenti ve metrics.all_* alışveriş sepeti verileri metrikleri (teklif verilemeyen dönüşümler de dahil olmak üzere tüm dönüşümlerdeki alışveriş sepeti verilerini raporlar).

Son 30 gün içinde tıklama alan ürünlerin gösterimlerini, tıklamalarını, maliyetini, dönüşümlerini ve tüm dönüşümlerini product_item_id ölçütüne göre alan örnek bir sorgu aşağıda verilmiştir (tüm dönüşümler, dönüşümler, tıklamalar, maliyet ve gösterimler ölçütlerine göre azalan düzende sıralanmıştır):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Ürün raporlama için ilişkilendirme mantığı

Ürün düzeyindeki raporlar, tek bir reklamda birden fazla ürün gösterildiğinde her bir ürünün performansını kredilendirmek için belirli bir ilişkilendirme çerçevesi kullanır.

Finansal metrikler

metrics.cost_micros ve metrics.conversions gibi finansal metrikler, tüm ürünlerdeki toplamlarının kampanya düzeyindeki raporları aşmamasını sağlayacak şekilde hesaplanır.

Doğrudan etkileşimler

Kullanıcı niyeti net olduğunda ve tek bir ürünle ilişkilendirildiğinde (ör. doğrudan bir ürünün tıklanması), ilişkili maliyet ve dönüşüm kredisinin %100'ü söz konusu ürüne atanır.

Dolaylı etkileşimler

Kullanıcı niyeti reklamın tamamına yönelik olduğunda (ör. kullanıcı bir başlığı, harekete geçirici mesaj düğmesini veya videoyu tıkladığında) ilişkili maliyet ve dönüşüm kredisi, söz konusu reklamda sunulan tüm ürünlere eşit olarak dağıtılır.

Etkileşim metrikleri

metrics.impressions ve metrics.clicks gibi etkileşim metrikleri, ürüne özel etkileşimi ölçer.

Gösterimler için, ürünün kullanıcının görüntü alanında görünür olup olmadığına bakılmaksızın, etkinlik gerçekleştiğinde reklamda yer alan her ürün için sayı artırılır. Bu nedenle, bir rapordaki tüm ürünlerin gösterimlerinin toplamı, ilgili kampanya düzeyindeki toplamdan önemli ölçüde yüksek olabilir.

Buna karşılık metrics.clicks, yalnızca söz konusu üründe gerçekleşen tıklamaları ölçer. Google Ads kullanıcı arayüzünde metrics.clicks alanı açıkça Ürün Tıklamaları olarak etiketlenir.

Ürün Grubu Görünümü

Ürün Grubu Görünümü, Alışveriş listeleme grupları (kullanıcı arayüzünde ürün grupları olarak adlandırılır) için toplu raporlama istatistikleri sağlar. Öğe Grubu Ürün Grubu Görünümü örnekleri için Maksimum Performans raporlama kılavuzuna bakın.

Aşağıda, son 30 gün içinde gösterim alan kampanyaya göre Alışveriş listeleme grupları için gösterimleri, tıklamaları, dönüşümleri ve tüm dönüşümleri alan örnek bir sorgu verilmiştir (tüm dönüşümlere, ardından dönüşümlere, ardından tıklamalara, ardından gösterimlere göre azalan düzende sıralanmıştır):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Alışveriş ürünü raporu

Alışveriş Ürünü raporu, Google Ads hesabına bağlı Google Merchant Center hesaplarında bulunan ürünlerin özelliklerini ve raporlama istatistiklerini sağlar. Bu rapor, müşteri, kampanya ve reklam grubu düzeyindeki istatistikleri incelemek için kullanılabilir. Alışveriş, Maksimum Performans, Talep Yaratma, video ve (24 ve sonraki sürümlerde) uygulama kampanyalarını destekler. Satıcı tarafından sağlanan ürün resminin URI'sini almak için shopping_product.product_image_uri alanını da sorgulayabilirsiniz.

Aşağıda, bağlı tüm Google Merchant Center hesaplarındaki tüm Alışveriş ürünleri için son 30 güne ait gösterimleri, tıklamaları, dönüşümleri ve tüm dönüşümleri (tüm dönüşümler, ardından dönüşümler, ardından tıklamalar, ardından gösterimler şeklinde azalan düzende sıralanmış) alan örnek bir sorgu verilmiştir:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Sorgular hakkında daha fazla bilgi için Raporlama kılavuzuna bakın.

Performansla ilgili konular

Alışveriş ürünü raporu, bir hesap çok sayıda ürünle bağlantılı olduğunda önemli miktarda veri döndürebilir. Aşağıdaki öneriler, GAQL sorgularınızın performansını artırmanıza yardımcı olabilir:

• Kampanya ve reklam grubu düzeyindeki sorgular, genellikle hesap düzeyindeki sorgulardan daha hızlıdır. Bunun nedeni, daha az ürün içermeleri ve daha az veriye erişim gerektirmeleridir.
• SELECT yan tümcesinde ne kadar çok alan ve metrik varsa yanıt süresi o kadar yavaş olur. Sorguda yalnızca ihtiyacınız olan alanları ve metrikleri seçin.
• Bir veya daha fazla sorunu olan ürünler daha fazla veri döndürür. İlgili duruma neden olan sorunları döndürme olasılığı yüksek olan ürünleri anlamak için WHERE ifadesinde shopping_product.status ölçütüne göre filtreleme yapabilirsiniz.

Alışveriş ürünü raporunun yaygın kullanım alanları

Alışveriş ürünü raporu, ürün feed'lerini kullanan kampanyalar için ürün bilgilerine esnek erişim sağlar. Bu sayede, Google Merchant Center hesaplarındaki ürünlerin durumunun yanı sıra performans metrikleri ve ürünlerin reklam yayınlamasını engelleyen sorunlar gibi reklamlara özel bilgiler hakkında analizler elde edebilirsiniz.

Bu bölümde, Google Ads kullanıcı arayüzündeki Ürünler görünümünde mümkün olanlara benzer bazı tipik kullanım alanları ele alınmaktadır.

shopping_product için issues alanı, Merchant API'deki ProductStatus alanına benzer. Bu alanda Google Ads'e özgü sorunlar da yer alır. Sorunun Google Merchant Center'da mı yoksa Google Ads'de mi çözülmesi gerektiğini kontrol etmek için öncelikle yanıtın shopping_product.issues.documentation alanını kontrol edin. Bu alanda, size yardımcı olacak bir Yardım Merkezi makalesi bulunur.

Ürün durumları (hesap düzeyi)

Raporu kampanya veya reklam grubu için filtreler olmadan belirtmek, hesap düzeyindeki tüm ürünleri döndürür.

Aşağıdaki türde hesaplardaki tüm kampanyalara ait metrikleri, durumları ve sorunları destekler:

• Alışveriş
• Maksimum Performans

Bu sorgu, ürünün durumunu (ör. NOT_ELIGIBLE) ve ürünün bu duruma gelmesine neden olan sorunların listesini görmenizi sağlar:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

Ürün durumları (kampanya düzeyinde)

Raporu, WHERE yan tümcesinin bir parçası olarak kampanya kaynağıyla belirtmek, seçilen kampanyaya dahil edilen tüm ürünleri döndürür.

Ürün feed'lerini kullanabilen aşağıdaki kampanya türleri tarafından desteklenir:

• Alışveriş
• Maksimum Performans
• Talep Yaratma
• Video
• Uygulama (24 ve sonraki sürümlerde kullanılabilir)

Not: Talep Yaratma, Video ve (v24 ve sonraki sürümlerde) Uygulama kampanyaları için yalnızca impressions, clicks ve ctr metrikleri desteklenir. Ayrıca, uygulama kampanyalarında shopping_product.status ve shopping_product.issues desteklenmez.

Bu sorgu, belirli bir kampanyaya dahil edilen her ürünün durumunu ve bu duruma neden olan sorunları görmenizi sağlar. Örneğin, duraklatılmış bir kampanya ürün durumunu etkiler:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'

Ürün durumları (reklam grubu düzeyi)

Raporu WHERE ifadesinin bir parçası olarak hem reklam grubu kaynağı hem de kampanya kaynağıyla belirtmek, seçilen kampanyaya dahil olan tüm ürünleri döndürür. Ürünün metrikleri, durumu ve sorunları, ürünün seçili reklam grubuna dahil edilip edilmediğini yansıtır.

Aşağıdaki kampanya türleri tarafından desteklenir:

• Alışveriş
• Talep Yaratma
• Video
• Uygulama (24 ve sonraki sürümlerde kullanılabilir; yalnızca impressions, clicks ve ctr metriklerini destekler, status veya issues metriklerini desteklemez)

Bu sorgu, ürünün ilgili reklam grubuna göre durumunu görmenizi sağlar. Ürün grubu filtrelerinin (reklam grubu düzeyinde) doğru şekilde uygulandığını onaylamanıza ve her ürünün durumunu kontrol etmenize olanak tanır:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
  AND shopping_product.ad_group =
    'customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>'

Not: WHERE ifadesinde hem kampanya hem de reklam grubu belirtilmelidir. Bunlardan biri yoksa sorgu şu hatalardan biriyle sonuçlanır: MISSING_CAMPAIGN_FILTER veya MISSING_AD_GROUP_FILTER.

Tarihe göre filtrelenmiş ürün metrikleri (hesap düzeyi)

WHERE ifadesinde bir tarih veya tarih aralığıyla raporu belirtmek, metriklerin sıfır olup olmadığına bakılmaksızın, belirtilen dönem için hesap düzeyindeki tüm ürünlerin metriklerini döndürür.

segments.date seçeneğini belirleyemezsiniz. Bu seçeneği belirlerseniz UNSUPPORTED_DATE_SEGMENTATION hatası alırsınız.

Bu sorgu, belirli bir gün veya diğer uyumlu tarih aralığı için her bir ürünün performansını tüm kampanyalarda toplu olarak görmenizi sağlar:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date DURING LAST_30_DAYS

Alışveriş sepeti verileriyle ürün performansı

Perakende reklamverenleri; gelir, brüt kâr, brüt kâr marjı ve satılan birim sayısı gibi alakalı satış ve kâr metriklerine erişebilir. Bu metrikler, Alışveriş kampanyalarında alışveriş sepeti verileriyle dönüşüm özelliğini uygulayan tüm reklamverenler tarafından kullanılabilir ve aşağıdaki raporlarla uyumludur:

• ad_group
• ad_group_ad
• campaign
• cart_data_sales_view (24 ve sonraki sürümlerde kullanılabilir)
• customer (Tüm kampanyalar için toplu)
• product_group_view
• shopping_performance_view
• shopping_product (v24 ve sonraki sürümlerdeki metrics.all_* alışveriş sepeti verileri metrikleri için)

Aşağıdaki alışveriş sepeti verileri metrikleri, Alışveriş kampanyaları için shopping_performance_view gibi raporlarda kullanılabilir:

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

Sürüm 24 ve sonraki sürümlerde, aşağıdaki alışveriş sepeti verileri metrikleri de tüm dönüşümlerde (teklif verilemez dönüşümler dahil) raporlanabilir:

metrics.all_average_cart_size
metrics.all_average_order_value_micros
metrics.all_cost_of_goods_sold_micros
metrics.all_cross_sell_cost_of_goods_sold_micros
metrics.all_cross_sell_gross_profit_micros
metrics.all_cross_sell_revenue_micros
metrics.all_cross_sell_units_sold
metrics.all_gross_profit_margin
metrics.all_gross_profit_micros
metrics.all_lead_cost_of_goods_sold_micros
metrics.all_lead_gross_profit_micros
metrics.all_lead_revenue_micros
metrics.all_lead_units_sold
metrics.all_orders
metrics.all_revenue_micros
metrics.all_units_sold

Not: Alışveriş sepeti verileri metrikleri, ilişkili ürünler için dönüşümler kaydedilene kadar kullanılamaz. shopping_performance_view ile ilgili sorguların yürütülmesi, filtreler uygulanmış olsa bile çok sayıda ürün içeren hesaplar için daha uzun sürebilir.

Aşağıdaki örnekte, Alışveriş kampanyalarının son 30 gündeki ürün düzeyinde performansını analiz etmek için alışveriş sepeti verileri metriklerinin nasıl kullanılabileceği gösterilmektedir:

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Alışveriş sepeti verileriyle kampanya performansı

Alışveriş sepeti verileri metrikleri kampanya düzeyinde kullanılabilir ve gösterim sayısı, tıklama sayısı ve maliyet gibi diğer performans metrikleriyle birleştirilebilir:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Nihai URL genişletmesi öğe görünümü

Sürüm 26'dan itibaren, Maksimum Yapay Zeka (campaign.ai_max_setting.enable_ai_max = true) ve nihai URL genişletmesi (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) etkinleştirildiğinde Alışveriş kampanyalarında yayınlanan metin özelleştirme öğelerinin öğe düzeyindeki performansını ölçmek için final_url_expansion_asset_view kullanabilirsiniz.

final_url_expansion_asset_view sorgusu yaparken aşağıdaki filtreleme ve alan seçimi kurallarına uyun:

• final_url_expansion_asset_view ile ilgili sorgular campaign.advertising_channel_type, campaign (campaign.id, campaign.resource_name veya final_url_expansion_asset_view.campaign) ya da ad_group (ad_group.id, ad_group.resource_name veya final_url_expansion_asset_view.ad_group) seçeneklerinden en az birine göre filtrelenmelidir. Bunların tümü atlanırsa FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER döndürülür.
• Hesap veya kampanya düzeyinde Alışveriş kampanyaları için final_url_expansion_asset_view sorgusu yaparken campaign.advertising_channel_type = 'SHOPPING' ile filtrelemeniz (veya = kullanarak tek bir reklam grubuna göre filtrelemeniz) gerekir. Kampanyaya göre filtreleme (campaign.id, campaign.resource_name veya final_url_expansion_asset_view.campaign) için de campaign.advertising_channel_type = 'SHOPPING' gerekir. Bu filtre atlanırsa FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER döndürülür. Tek bir ad_group ile filtreleme ise filtre şartını tek başına karşılar.
• campaign.advertising_channel_type, campaign veya ad_group üzerindeki filtreler tek bir değerde = operatörünü kullanmalıdır. Aynı kaynak türü için IN veya birden fazla koşul kullanıldığında FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE döndürülür.
• Alışveriş kampanyalarında ad_group alanlarını seçip bunlara göre filtreleme yapabilirsiniz ancak asset_group alanlarını seçemezsiniz. Alışveriş kampanyalarında asset_group alanlarını seçtiğinizde (veya ad_group ölçütüne göre filtreleme yaptığınızda) FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP (veya ad_group alanları da seçildiğinde CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP) döndürülür. ad_group alanlarını seçerken asset_group ile filtreleme yapıldığında CANNOT_SELECT_AD_GROUP, hem ad_group hem de asset_group ile filtreleme yapıldığında ise CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP döndürülür.

Aşağıdaki sorgu, Alışveriş kampanyaları için son 30 güne ait öğe düzeyinde performans metriklerini alır:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  final_url_expansion_asset_view.asset,
  final_url_expansion_asset_view.field_type,
  final_url_expansion_asset_view.final_url,
  final_url_expansion_asset_view.status,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions
FROM final_url_expansion_asset_view
WHERE
  campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS