Package google.shopping.merchant.reports.v1beta

Dizin

ReportService

Ürünleriniz, ürünlerinizin performansı ve Google'daki rekabet ortamları hakkında rapor ve analiz almayı sağlayan hizmet.

Arama

rpc Search(SearchRequest) returns (SearchResponse)

Bir arama sorgusu tarafından tanımlanan bir raporu getirir. Yanıt, page_size tarafından belirtilenden daha az satır içerebilir. İstenecek daha fazla satır olup olmadığını belirlemek için next_page_token güvenini kullanın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

BestSellersBrandView

best_sellers_brand_view tablosunda sorgu için kullanılabilecek alanlar

En popüler markalarla birlikte Çok satanlar raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
report_date

Date

Rapor tarihi. Bu alanın değeri yalnızca aşağıdakilerden biri olabilir:

  • Haftalık raporlar için haftanın ilk günü (Pazartesi),
  • Aylık raporlar için ayın ilk günü.

SELECT yan tümcesinde zorunludur. Sorguda report_date için bir WHERE koşulu belirtilmezse kullanılabilir en son haftalık veya aylık rapor döndürülür.
report_granularity

ReportGranularityEnum

Raporun ayrıntı düzeyi. Sıralama, bir hafta veya bir aylık zaman aralığı üzerinden yapılabilir.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_granularity koşulu için gereklidir.
report_country_code

string

Sıralamanın hesaplandığı ülke. ISO 3166 biçiminde gösterilir.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_country_code koşulu için gereklidir.
report_category_id

int64

Google'ın ürün sınıflandırmasında belirtilen, sıralamanın hesaplanacağı Google ürün kategorisi kimliği.

SELECT yan tümcesinde zorunludur. Sorguda report_category_id için bir WHERE koşulu belirtilmezse tüm üst düzey kategorilerin sıralamaları döndürülür.
brand

string

Markanın adı.
rank

int64

Markanın, satılan tahmini birim sayısına göre seçilen kategori ve ülkede Reklamlarda ve organik platformlarda popülerliği.
previous_rank

int64

Önceki hafta veya ay içindeki popülerlik sıralaması.
relative_demand

RelativeDemandEnum

Aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip markayla ilgili tahmini talep.
previous_relative_demand

RelativeDemandEnum

Önceki hafta veya ay içinde aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip olan markayla ilgili tahmini talep.
relative_demand_change

RelativeDemandChangeTypeEnum

Tahmini talepteki değişim. Suyun yükselmesi, batması veya düz durması.

BestSellersProductClusterView

best_sellers_product_cluster_view tablosunda sorgu için kullanılabilecek alanlar

En çok satan ürün kümelerini içeren çok satanlar raporu Ürün kümesi, aynı ürünü temsil eden farklı teklifler ve varyantlar için bir gruplandırmadır (ör. Google Pixel 7).

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
report_date

Date

Rapor tarihi. Bu alanın değeri yalnızca aşağıdakilerden biri olabilir:

  • Haftalık raporlar için haftanın ilk günü (Pazartesi),
  • Aylık raporlar için ayın ilk günü.

SELECT yan tümcesinde zorunludur. Sorguda report_date için bir WHERE koşulu belirtilmezse kullanılabilir en son haftalık veya aylık rapor döndürülür.
variant_gtins[]

string

Ürün kümesinin örnek varyantlarının GTIN'leri.
report_granularity

ReportGranularityEnum

Raporun ayrıntı düzeyi. Sıralama, bir hafta veya bir aylık zaman aralığı üzerinden yapılabilir.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_granularity koşulu için gereklidir.
report_country_code

string

Sıralamanın hesaplandığı ülke. ISO 3166 biçiminde gösterilir.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_country_code koşulu için gereklidir.
report_category_id

int64

Google'ın ürün sınıflandırmasında belirtilen, sıralamanın hesaplanacağı Google ürün kategorisi kimliği.

SELECT yan tümcesinde zorunludur. Sorguda report_category_id için bir WHERE koşulu belirtilmezse tüm üst düzey kategorilerin sıralamaları döndürülür.
title

string

Ürün kümesinin başlığıdır.
brand

string

Ürün kümesinin markası.
category_l1

string

Ürün kümesinin Google ürün sınıflandırmasında gösterilen ürün kategorisi (1. seviye).
category_l2

string

Ürün kümesinin Google ürün sınıflandırmasında gösterilen ürün kategorisi (2. seviye).
category_l3

string

Ürün kümesinin Google ürün sınıflandırmasında gösterilen ürün kategorisi (3. seviye).
category_l4

string

Ürün kümesinin Google ürün sınıflandırmasında gösterilen ürün kategorisi (4. seviye).
category_l5

string

Ürün kümesinin Google ürün sınıflandırmasında gösterilen ürün kategorisi (5. seviye).
inventory_status

InventoryStatus

Ürün kümesinin en az bir ülkedeki ürün veri kaynağınızda IN_STOCK, tüm ülkelerdeki ürün veri kaynağınızda OUT_OF_STOCK veya NOT_IN_INVENTORY olup olmadığı.

Çok satanlar raporundaki ülke filtresi bu alanda hesaba katılmaz.
brand_inventory_status

InventoryStatus

Ülkelerin en az birindeki ürün veri kaynağınızda şu anda IN_STOCK markasının en az bir ürünü varsa tüm ürünler tüm ülkelerdeki ürün veri kaynağınızda OUT_OF_STOCK veya NOT_IN_INVENTORY olur.

Çok satanlar raporundaki ülke filtresi bu alanda hesaba katılmaz.
rank

int64

Seçilen kategori ve ülkede, satılan tahmini birim sayısına göre Ads ve organik platformlarda ürün kümesinin popülerlik düzeyi.
previous_rank

int64

Önceki hafta veya ay içindeki popülerlik sıralaması.
relative_demand

RelativeDemandEnum

Aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip ürün kümesiyle ilgili tahmini talep.
previous_relative_demand

RelativeDemandEnum

Önceki hafta veya ay içinde aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip ürün grubuyla ilgili tahmini talep.
relative_demand_change

RelativeDemandChangeTypeEnum

Tahmini talepteki değişim. Suyun yükselmesi, batması veya düz durması.

InventoryStatus

Envanterinizdeki ürün kümesinin veya markanın durumu.

Sıralamalar
INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
IN_STOCK Bu ürün kümesi veya marka için stokta bir ürününüz var.
OUT_OF_STOCK Envanterinizde bu ürün kümesi veya marka için bir ürününüz var ancak bu ürün şu anda stokta yok.
NOT_IN_INVENTORY Envanterde bu ürün kümesi veya marka için ürününüz yok.

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view tablosunda sorgu için kullanılabilecek alanlar

Kategori karşılaştırmasıyla Görünürlük Rekabeti raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
date

Date

Bu satırın tarihi.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde date için bir koşul gereklidir.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_country_code için bir koşul gereklidir.
report_category_id

int64

Raporun hesaplanacağı ve Google'ın ürün sınıflandırmasında belirtilen Google ürün kategorisi kimliği.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_category_id için bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.
your_domain_visibility_trend

double

Seçili zaman aralığının (veya sıfır olmayan gösterime sahip ilk günün) başlangıcına göre alan adınıza ilişkin gösterimlere dayalı görünürlük değişikliği.

'WHERE' yan tümcesinde filtrelenemez.
category_benchmark_visibility_trend

double

Pazara yakın görünürlüğe sahip birleşik bir satıcı grubunun, seçilen zaman aralığının (veya gösterim sayısı sıfır olmayan ilk günün) başlangıcıyla ilişkili olarak gösterimlere dayalı görünürlükteki değişiklik.

'WHERE' yan tümcesinde filtrelenemez.

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view tablosunda sorgu için kullanılabilecek alanlar

Görünürlüğü benzer işletmelerle Görünürlük rekabeti raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
date

Date

Bu satırın tarihi.

WHERE yantümcesinde date için bir koşul gereklidir.
domain

string

"is_your_domain" doğruysa rakibinizin veya kendi alan adınızın alan adı.

SELECT yan tümcesinde zorunludur. 'WHERE' yan tümcesinde filtrelenemez.
is_your_domain

bool

Bu satırda alanınıza ait veriler varsa doğru değerini döndürür.

'WHERE' yan tümcesinde filtrelenemez.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_country_code için bir koşul gereklidir.
report_category_id

int64

Raporun hesaplanacağı ve Google'ın ürün sınıflandırmasında belirtilen Google ürün kategorisi kimliği.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_category_id için bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.
rank

int64

Seçilen anahtarlar (date, report_category_id, report_country_code, traffic_source) için gösterimlere göre alanın benzer işletmelerdeki konumu. 1 en yüksek değerdir.

'WHERE' yan tümcesinde filtrelenemez.
ads_organic_ratio

double

Reklam / organik oranı, alanın organik trafiğe kıyasla ne sıklıkta Alışveriş reklamlarından gösterim aldığını gösterir. Sayı yuvarlanır ve gruplanır.

'WHERE' yan tümcesinde filtrelenemez.
page_overlap_rate

double

Sayfa çakışma oranı, rakip perakendecilere ait tekliflerin aynı sayfada sizin tekliflerinizle birlikte ne sıklıkta gösterildiğini belirtir.

'WHERE' yan tümcesinde filtrelenemez.
higher_position_rate

double

Daha üst konuma yerleştirilme sıklığı, bir rakibin teklifinin sayfada sizin teklifinizden daha üst bir konuma ne sıklıkla yerleştirildiğini gösterir.

'WHERE' yan tümcesinde filtrelenemez.
relative_visibility

double

Göreli görünürlük, rakiplerinize ait tekliflerin kendi tekliflerinize kıyasla ne sıklıkta gösterildiğini belirtir. Başka bir deyişle bu değer, rakip bir perakendecinin görüntülenen gösterim sayısının, seçilen bir ürün kategorisi ve ülke için belirli bir zaman aralığındaki gösterim sayınıza bölünmesiyle elde edilir.

'WHERE' yan tümcesinde filtrelenemez.

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view tablosunda sorgu için kullanılabilecek alanlar

En yüksek görünürlüğe sahip işletmeyi içeren Görünürlük rekabeti raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
date

Date

Bu satırın tarihi.

SELECT yan tümcesinde seçilemez. WHERE yantümcesinde date için bir koşul gereklidir.
domain

string

"is_your_domain" doğruysa rakibinizin veya kendi alan adınızın alan adı.

SELECT yan tümcesinde zorunludur. 'WHERE' yan tümcesinde filtrelenemez.
is_your_domain

bool

Bu satırda alanınıza ait veriler varsa doğru değerini döndürür.

'WHERE' yan tümcesinde filtrelenemez.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_country_code için bir koşul gereklidir.
report_category_id

int64

Raporun hesaplanacağı ve Google'ın ürün sınıflandırmasında belirtilen Google ürün kategorisi kimliği.

SELECT yan tümcesinde zorunludur. WHERE yantümcesinde report_category_id için bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.
rank

int64

Seçilen anahtarlar (date, report_category_id, report_country_code, traffic_source) için gösterimlere göre en iyi satıcılar arasındaki alanın konumu. 1 en yüksek değerdir.

'WHERE' yan tümcesinde filtrelenemez.
ads_organic_ratio

double

Reklam / organik oranı, alanın organik trafiğe kıyasla ne sıklıkta Alışveriş reklamlarından gösterim aldığını gösterir. Sayı yuvarlanır ve gruplanır.

'WHERE' yan tümcesinde filtrelenemez.
page_overlap_rate

double

Sayfa çakışma oranı, rakip perakendecilere ait tekliflerin aynı sayfada sizin tekliflerinizle birlikte ne sıklıkta gösterildiğini belirtir.

'WHERE' yan tümcesinde filtrelenemez.
higher_position_rate

double

Daha üst konuma yerleştirilme sıklığı, bir rakibin teklifinin sayfada sizin teklifinizden daha üst bir konuma ne sıklıkla yerleştirildiğini gösterir.

'WHERE' yan tümcesinde filtrelenemez.

MarketingMethod

Bu türde alan yok.

Ürünlerinizi Google'da tanıtmak için kullanılan pazarlama yöntemleri (organik veya reklam)

MarketingMethodEnum

Pazarlama yöntemi değerleri.

Sıralamalar
MARKETING_METHOD_ENUM_UNSPECIFIED Belirtilmedi.
ORGANIC Organik pazarlama.
ADS Reklam tabanlı pazarlama.

NonProductPerformanceView

non_product_performance_view tablosunda sorgu için kullanılabilecek alanlar

Ürünle ilgili olmayan sayfalarınıza yönlendiren resimler ve online mağaza bağlantılarıyla ilgili performans verileri. Buna, performans metrikleri (örneğin, clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (örneğin, date) dahildir.

Sorgularda en az bir metrik alanı seçilmeden segment alanları da seçilemez.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
date

Date

Metriklerin geçerli olduğu satıcı saat dilimindeki tarih. Segment.

WHERE yantümcesinde date koşulu için gereklidir.
week

Date

Metriklerin alındığı haftanın ilk günü (pazartesi), satıcı saat dilimine göre belirlenir. Segment.
clicks

int64

Ürünle ilgili olmayan sayfalarınıza yönlendiren resimlere ve online mağaza bağlantılarına yapılan tıklamaların sayısı. Metrik.
impressions

int64

Ürünle ilgili olmayan sayfalarınıza yönlendiren resimlerin ve online mağaza bağlantılarının gösterilme sayısı. Metrik.
click_through_rate

double

Tıklama oranı - Ürünle ilgili olmayan sayfalarınıza yönlendiren resimlerin ve online mağaza bağlantılarının tıklama sayısının (clicks) gösterim sayısına (impressions) bölünmesiyle elde edilen orandır. Metrik.

PriceCompetitivenessProductView

price_competitiveness_product_view tablosunda sorgu için kullanılabilecek alanlar

Fiyat rekabetçiliği raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
price

Price

Ürünün geçerli fiyatı.
benchmark_price

Price

Ürün kataloğu için karşılaştırma ülkesinde kullanılabilen en son fiyat karşılaştırma değeri.
report_country_code

string

Fiyat karşılaştırmasının yapıldığı ülke. ISO 3166 biçiminde gösterilir.

SELECT yan tümcesinde zorunludur.
id

string

Ürünün channel~languageCode~feedLabel~offerId biçimindeki REST kimliği. Verileri product_view tablosuyla birleştirmek için kullanılabilir.

SELECT yan tümcesinde zorunludur.
offer_id

string

Ürünün satıcı tarafından sağlanan kimliği.
title

string

Ürünün başlığı.
brand

string

Ürünün markası.
category_l1

string

Google'ın ürün sınıflandırmasında ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasında ürün kategorisi (2. seviye).
category_l3

string

Google ürün sınıflandırmasındaki ürün kategorisi (3. seviye).
category_l4

string

Google ürün sınıflandırmasındaki ürün kategorisi (4. seviye).
category_l5

string

Google ürün sınıflandırmasındaki ürün kategorisi (5. seviye).
product_type_l1

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (1. seviye).
product_type_l2

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (2. seviye).
product_type_l3

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (3. seviye).
product_type_l4

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (4. seviye).
product_type_l5

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (5. seviye).

PriceInsightsProductView

price_insights_product_view tablosunda sorgu için kullanılabilecek alanlar

Fiyat analizleri raporu.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
price

Price

Ürünün geçerli fiyatı.
suggested_price

Price

Ürün için önerilen en son fiyat.
effectiveness

Effectiveness

Fiyat önerisinin uygulanmasının tahmini etki düzeyi (gruplandırılmış).
id

string

Ürünün channel~languageCode~feedLabel~offerId biçimindeki REST kimliği. Verileri product_view tablosuyla birleştirmek için kullanılabilir.

SELECT yan tümcesinde zorunludur.
offer_id

string

Ürünün satıcı tarafından sağlanan kimliği.
title

string

Ürünün başlığı.
brand

string

Ürünün markası.
category_l1

string

Google'ın ürün sınıflandırmasında ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasında ürün kategorisi (2. seviye).
category_l3

string

Google ürün sınıflandırmasındaki ürün kategorisi (3. seviye).
category_l4

string

Google ürün sınıflandırmasındaki ürün kategorisi (4. seviye).
category_l5

string

Google ürün sınıflandırmasındaki ürün kategorisi (5. seviye).
product_type_l1

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (1. seviye).
product_type_l2

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (2. seviye).
product_type_l3

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (3. seviye).
product_type_l4

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (4. seviye).
product_type_l5

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (5. seviye).
predicted_impressions_change_fraction

double

Önerilen fiyat ve mevcut etkin fiyata karşılaştırma sağlandıktan sonra gösterim sayısındaki tahmini değişim. Örneğin 0,05 değeri, gösterimlerde öngörülen% 5'lik bir artıştır.
predicted_clicks_change_fraction

double

Önerilen fiyat geçerli etkin fiyata göre sunulduktan sonra tıklama sayısındaki tahmini değişim. Örneğin 0,05 değeri, tıklamalarda tahmini% 5'lik bir artış anlamına gelir.
predicted_conversions_change_fraction

double

Önerilen fiyat geçerli etkin fiyata göre uygulandıktan sonra dönüşüm sayısındaki tahmini değişim (kesirli). Örneğin, 0,05 değeri dönüşümlerde öngörülen% 5'lik bir artıştır.

Etki Düzeyi

Tahmin edilen etki düzeyi paketi.

Etkinlik, fiyat değişikliklerinden en çok hangi ürünlerin faydalanacağını gösterir. Bu puan, indirimli fiyatın ve mevcut fiyatınızla önerilen fiyat arasındaki farkın ayarlanmasıyla tahmin edilen performans artışını dikkate alır. HIGH etkililiği olan fiyat önerilerinin performansta en büyük artışı sağlayacağı tahmin ediliyor.

Sıralamalar
EFFECTIVENESS_UNSPECIFIED Etkinliği bilinmiyor.
LOW Etkinlik düzeyi düşük.
MEDIUM Etki düzeyi orta düzeydedir.
HIGH Etkinlik düzeyi yüksek.

ProductPerformanceView

product_performance_view tablosunda sorgu için kullanılabilecek alanlar

Performans metrikleri (örneğin, clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlara göre (örneğin, offer_id) hesabınız için ürün performansı verileri. offer_id gibi ürün boyutlarının değerleri, ürünün gösterim anındaki durumunu yansıtır.

Sorgularda en az bir metrik alanı seçilmeden segment alanları da seçilemez.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
date

Date

Metriklerin geçerli olduğu satıcı saat dilimindeki tarih. Segment.

WHERE yantümcesinde date koşulu için gereklidir.
week

Date

Metriklerin alındığı haftanın ilk günü (pazartesi), satıcı saat dilimine göre belirlenir. Segment.
conversion_value

Price

Ürünle ilişkilendirilen ve dönüşüm tarihinde raporlanan dönüşümlerin değeri. Metrik.

Yalnızca FREE trafik kaynağı için kullanılabilir.
marketing_method

MarketingMethodEnum

Metriklerin geçerli olduğu pazarlama yöntemi. Segment.
customer_country_code

string

Etkinlik sırasında müşterinin bulunduğu ülkenin kodu. ISO 3166 biçiminde gösterilir. Segment.

Müşterinin ülkesi belirlenemezse özel bir 'ZZ' kodu döndürülür.
offer_id

string

Ürünün satıcı tarafından sağlanan kimliği. Segment.
title

string

Ürünün başlığı. Segment.
brand

string

Ürünün markası. Segment.
category_l1

string

Google'ın ürün sınıflandırmasında ürün kategorisi (1. seviye). Segment.
category_l2

string

Google'ın ürün sınıflandırmasında ürün kategorisi (2. seviye). Segment.
category_l3

string

Google'ın ürün sınıflandırmasında ürün kategorisi (3. seviye). Segment.
category_l4

string

Google'ın ürün sınıflandırmasında ürün kategorisi (4. seviye). Segment.
category_l5

string

Google'ın ürün sınıflandırmasında ürün kategorisi (5. seviye). Segment.
product_type_l1

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (1. seviye). Segment.
product_type_l2

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (2. seviye). Segment.
product_type_l3

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (3. seviye). Segment.
product_type_l4

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (4. seviye). Segment.
product_type_l5

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (5. seviye). Segment.
custom_label0

string

Ürünlerin özel gruplandırılması için özel etiket 0. Segment.
custom_label1

string

Ürünlerin özel gruplandırılması için özel etiket 1. Segment.
custom_label2

string

Ürünlerin özel gruplandırılması için özel etiket 2. Segment.
custom_label3

string

Ürünlerin özel gruplandırılması için özel etiket 3. Segment.
custom_label4

string

Ürünlerin özel gruplandırılması için özel etiket 4. Segment.
clicks

int64

Tıklama sayısı. Metrik.
impressions

int64

Satıcıya ait ürünlerin gösterilme sayısı. Metrik.
click_through_rate

double

Tıklama oranı - Satıcının ürünlerinin aldığı tıklama (tıklama sayısı) sayısının ürünlerin gösterilme (gösterim sayısı) sayısına bölünmesiyle elde edilen oran. Metrik.
conversions

double

Ürünle ilişkilendirilen ve dönüşüm tarihinde raporlanan dönüşümlerin sayısı. İlişkilendirme modeline bağlı olarak bir dönüşüm, her tıklamaya kendi kredisinin atandığı birden çok tıklamaya dağıtılabilir. Bu metrik, bu türdeki tüm kredilerin toplamıdır. Metrik.

Yalnızca FREE trafik kaynağı için kullanılabilir.
conversion_rate

double

Dönüşüm sayısının, gösterim tarihinde raporlanan tıklama sayısına bölümü. Metrik.

Yalnızca FREE trafik kaynağı için kullanılabilir.

ProductView

product_view tablosunda sorgu için kullanılabilecek alanlar

Geçerli envanterdeki ürünler. Bu tablodaki ürünler, Ürünler alt API'sindekiyle aynıdır, ancak Ürünler alt API'sindeki tüm ürün özellikleri bu tabloda sorgulanabilir. Ürünler alt API'sinin aksine bu tablo, döndürülen ürün listesinin ürün özelliklerine göre filtrelenmesine olanak tanır. id tarihine kadar tek bir ürün almak veya tüm ürünleri listelemek için Ürünler alt API'si kullanılmalıdır.

Değerler yalnızca isteğin arama sorgusunda açıkça istenen alanlar için ayarlanır.

Alanlar
price

Price

Ürün fiyatı. Ürünün fiyatıyla ilgili bilgi yoksa bu eksiktir.
gtin[]

string

Ürünün Global Ticari Öğe Numaralarının (GTIN'ler) listesi.
creation_time

Timestamp

Zaman damgası saniyesi cinsinden, satıcının ürünü oluşturduğu zaman.
expiration_date

Date

Ürünün ekleme sırasında belirtilen son kullanma tarihi.
item_issues[]

ItemIssue

Ürünle ilgili öğe sorunlarının listesi.

Bu alan, sonuçları sıralamak için kullanılamaz.

Sonuçları filtrelemek için yalnızca bu alanın seçili özellikleri (örneğin, item_issues.severity.aggregated_severity) kullanılabilir.
click_potential

ClickPotential

Satıcının en iyi performans gösteren ürünleriyle karşılaştırıldığında tahmini performans potansiyeli.
id

string

Ürünün channel~languageCode~feedLabel~offerId biçimindeki REST kimliği. Ürünler üzerinde çalışan Merchant API yöntemleri bunu name parametresi olarak alır.

SELECT yan tümcesinde zorunludur.
channel

ChannelEnum

Ürünün kanalı. ONLINE veya LOCAL olabilir.
language_code

string

Ürünün BCP 47 biçimindeki dil kodu.
feed_label

string

Ürünün feed etiketi.
offer_id

string

Ürünün satıcı tarafından sağlanan kimliği.
title

string

Ürünün başlığı.
brand

string

Ürünün markası.
category_l1

string

Google'ın ürün sınıflandırmasında ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasında ürün kategorisi (2. seviye).
category_l3

string

Google ürün sınıflandırmasındaki ürün kategorisi (3. seviye).
category_l4

string

Google ürün sınıflandırmasındaki ürün kategorisi (4. seviye).
category_l5

string

Google ürün sınıflandırmasındaki ürün kategorisi (5. seviye).
product_type_l1

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (1. seviye).
product_type_l2

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (2. seviye).
product_type_l3

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (3. seviye).
product_type_l4

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (4. seviye).
product_type_l5

string

Satıcının kendi ürün sınıflandırmasındaki ürün türü (5. seviye).
condition

string

Ürünün durumu.
availability

string

Ürünün stok durumu.
shipping_label

string

Veri kaynağında belirtilen normalleştirilmiş gönderim etiketi.
item_group_id

string

Varyantları birlikte gruplandırmak için satıcı tarafından sağlanan öğe grubu kimliği.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Toplu durum.
click_potential_rank

int64

Ürünün tıklama potansiyeline göre sıralaması. click_potential_rank 1 değerine sahip bir ürün, satıcının arama sorgusu koşullarını karşılayan ürünleri arasında en yüksek tıklama potansiyeline sahiptir.

AggregatedReportingContextStatus

Ürünün durumu, tüm raporlama bağlamları için toplanır.

Toplu durumun nasıl hesaplandığına dair bir örneği aşağıda bulabilirsiniz:

Ücretsiz listelemeler Alışveriş reklamları Durum
Approved Approved UYGUN
Approved Beklemede UYGUN
Approved Onaylanmadı ELIGIBLE_LIMITED
Beklemede Beklemede BEKLEMEDE
Onaylanmadı Onaylanmadı NOT_ELIGIBLE_OR_DISAPPROVED
Sıralamalar
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Belirtilmedi.
NOT_ELIGIBLE_OR_DISAPPROVED Ürün, tüm raporlama bağlamları için uygun değil veya onaylanmadı.
PENDING Ürünün durumu tüm raporlama bağlamlarında beklemede.
ELIGIBLE_LIMITED Ürün, bazı (ancak tümü değil) raporlama bağlamları için uygundur.
ELIGIBLE Ürün, tüm raporlama bağlamları için uygundur.

ClickPotential

Tıklama potansiyeli, ürünlerin satıcının en iyi performans gösteren ürünleriyle karşılaştırıldığında performans potansiyelini tahmin eder. Ürünlerin tıklama potansiyeli, düzeltilecek ürünleri önceliklendirerek satıcıların ürünleri potansiyellerine göre nasıl performans gösterdiğini anlamalarına yardımcı olur.

Sıralamalar
CLICK_POTENTIAL_UNSPECIFIED Bilinmeyen tahmini tıklamaların etkisi.
LOW Satıcının en iyi performans gösteren ürünlerine kıyasla daha az tıklama alma potansiyeli.
MEDIUM Satıcının en iyi performans gösteren ürünlerine kıyasla orta düzeyde tıklama alma potansiyeli.
HIGH Satıcının en iyi performans gösteren ürünleriyle benzer sayıda tıklama alma potansiyeli.

ItemIssue

Ürünle ilişkili öğe sorunu.

Alanlar
type

ItemIssueType

Öğe sorunu türü.
severity

ItemIssueSeverity

Öğe sorununun önem derecesi.
resolution

ItemIssueResolution

Öğe sorununun çözümü.

ItemIssueResolution

Sorunun çözümü.

Sıralamalar
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Belirtilmedi.
MERCHANT_ACTION Satıcının sorunu düzeltmesi gerekir.
PENDING_PROCESSING Bu sorun otomatik olarak (örneğin, resim tarama) veya bir Google incelemesi aracılığıyla çözülür. Şu anda satıcının işlem yapması gerekmez. Çözüm, başka bir soruna yol açabilir (örneğin, tarama başarısız olursa).

ItemIssueSeverity

Sorunun, ürünün yayınlanmasını nasıl etkilediği.

Alanlar
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Raporlama bağlamına göre sorunun önem derecesi.
aggregated_severity

AggregatedIssueSeverity

Sorunun, etkilediği tüm raporlama bağlamları için toplu önem derecesi.

Bu alan, sonuçları filtrelemek için kullanılabilir.

AggregatedIssueSeverity

Tüm raporlama bağlamları için sorun önem derecesi toplanır.

Sıralamalar
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Belirtilmedi.
DISAPPROVED Sorun, ürünü en az bir raporlama bağlamında onaylamıyor.
DEMOTED Sorun, ürünün etkilediği tüm raporlama bağlamlarında sıralamasını düşürür.
PENDING Sorunun çözümü: PENDING_PROCESSING.

IssueSeverityPerReportingContext

Raporlama bağlamına göre sorunun önem derecesi.

Alanlar
disapproved_countries[]

string

Raporlama bağlamında ISO 3166 biçiminde gösterilen, onaylanmayan ülkelerin listesi.
demoted_countries[]

string

ISO 3166 biçiminde gösterilen, raporlama bağlamında sıralaması düşürülen ülkelerin listesi.
reporting_context

ReportingContextEnum

Sorunun geçerli olduğu raporlama bağlamı.

ItemIssueType

Sorun türü.

Alanlar
code

string

Ürün sorunları kapsamındaki code koda eşdeğer, sorunun hata kodu.
canonical_attribute

string

Özelliğe özgü sorunlar için standart özellik adı.

RelativeDemand

Bu türde alan yok.

Çok satanlar raporundaki bir ürün kümesi veya markanın göreli talebi.

RelativeDemandEnum

Göreli talep değerleri.

Sıralamalar
RELATIVE_DEMAND_ENUM_UNSPECIFIED Belirtilmedi.
VERY_LOW Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın talebinin% 0-5'i kadardır.
LOW Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın talebinin% 6-10'u kadardır.
MEDIUM Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın talebinin% 11-20'si kadardır.
HIGH Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın% 21-50'si kadar talep oluşturur.
VERY_HIGH Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın% 51-100'ü kadar talep oluşturur.

RelativeDemandChangeType

Bu türde alan yok.

Çok satanlar raporundaki bir ürün kümesinin veya markanın önceki döneme kıyasla göreli talebi.

RelativeDemandChangeTypeEnum

Göreli talep değişim türü değerleri.

Sıralamalar
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Belirtilmedi.
SINKER Göreli talep önceki dönemden daha düşük.
FLAT Göreli talep önceki döneme eşittir.
RISER Göreli talep önceki dönemden daha yüksek.

ReportGranularity

Bu türde alan yok.

Çok satanlar raporunun ayrıntı düzeyi. Çok satanlar raporları, bir haftalık ve bir aylık zaman aralığı üzerinden hesaplanır.

ReportGranularityEnum

Rapor ayrıntı düzeyi değerleri.

Sıralamalar
REPORT_GRANULARITY_ENUM_UNSPECIFIED Belirtilmedi.
WEEKLY Rapor bir haftalık zaman aralığında hesaplanmıştır.
MONTHLY Rapor bir aylık zaman aralığı boyunca hesaplanır.

ReportRow

Arama sorgusundan döndürülen sonuç satırı.

Yanıtta yalnızca sorgulanan tabloya karşılık gelen mesaj doldurulur. Doldurulan mesajda, yalnızca sorguda açıkça istenen alanlar doldurulur.

Alanlar
product_performance_view

ProductPerformanceView

product_performance_view tablosunda sorgu için kullanılabilecek alanlar
non_product_performance_view

NonProductPerformanceView

non_product_performance_view tablosunda sorgu için kullanılabilecek alanlar
product_view

ProductView

product_view tablosunda sorgu için kullanılabilecek alanlar
price_competitiveness_product_view

PriceCompetitivenessProductView

price_competitiveness_product_view tablosunda sorgu için kullanılabilecek alanlar
price_insights_product_view

PriceInsightsProductView

price_insights_product_view tablosunda sorgu için kullanılabilecek alanlar
best_sellers_product_cluster_view

BestSellersProductClusterView

best_sellers_product_cluster_view tablosunda sorgu için kullanılabilecek alanlar
best_sellers_brand_view

BestSellersBrandView

best_sellers_brand_view tablosunda sorgu için kullanılabilecek alanlar
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view tablosunda sorgu için kullanılabilecek alanlar
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view tablosunda sorgu için kullanılabilecek alanlar
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view tablosunda sorgu için kullanılabilecek alanlar

SearchRequest

ReportService.Search yöntemi için mesaj isteyin.

Alanlar
parent

string

Zorunlu. Aramayı yapan hesabın kimliği. Bağımsız bir hesap veya MCA alt hesabı olmalıdır. Biçim: accounts/{account}
query

string

Zorunlu. Alınacak bir raporu tanımlayan sorgu.

Sorgunuzu nasıl oluşturacağınızla ilgili ayrıntılar için Sorgu Dili kılavuzuna bakın. Kullanılabilir tabloların ve alanların tam listesi için Kullanılabilir alanlarına bakın.
page_size

int32

İsteğe bağlı. Tek bir sayfada alınacak ReportRows sayısı. Varsayılan olarak 1.000 değerine ayarlanır. 5000'in üzerindeki değerler 5000'e zorlanır.
page_token

string

İsteğe bağlı. Alınacak sayfanın jetonu. Belirtilmezse, sonuçların ilk sayfası döndürülür. Bir sonraki sonuç sayfasını istemek için önceki yanıtta next_page_token öğesinden alınan değer kullanılmalıdır.

SearchResponse

ReportService.Search yöntemi için yanıt mesajı.

Alanlar
results[]

ReportRow

Arama sorgusuyla eşleşen satırlar.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilecek jeton. Atlanırsa sonraki sayfa bulunmaz.

TrafficSource

Bu türde alan yok.

Görünürlük rekabeti raporundaki gösterimlerin trafik kaynağı.

TrafficSourceEnum

Trafik kaynağı değerleri.

Sıralamalar
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Belirtilmedi.
ORGANIC Organik trafik.
ADS Reklamlardan gelen trafiktir.
ALL Organik trafik ve reklam trafiği.