Package google.shopping.merchant.reports.v1beta

Dizin

ReportService

Ürünleriniz, performansları ve Google'daki rekabet ortamları hakkında rapor ve analizler almak için kullanılan hizmet.

Arama

rpc Search(SearchRequest) returns (SearchResponse)

Bir arama sorgusuyla tanımlanan raporu alır. Yanıt, page_size tarafından belirtilenden daha az satır içerebilir. İstenecek başka satır olup olmadığını belirlemek için next_page_token değerini 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ı makaleyi inceleyin.

BestSellersBrandView

best_sellers_brand_view tablosunda sorgulanabilir alanlar.

En popüler markaları içeren Ç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 aşağıdakilerden yalnızca 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 gereklidir. Sorguda report_date üzerinde bir WHERE koşulu belirtilmezse mevcut 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 ay boyunca yapılabilir.

SELECT yan tümcesinde gereklidir. WHERE ifadesinde report_granularity için koşul gereklidir.
report_country_code

string

Sıralamanın hesaplandığı ülke. ISO 3166 biçiminde temsil edilir.

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

int64

Sıralama hesaplanırken kullanılan Google ürün kategorisi kimliği. Google ürün sınıflandırmasında gösterilir.

SELECT yan tümcesinde gereklidir. Sorguda report_category_id üzerinde 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

Satılan tahmini birim sayısına göre, seçilen kategori ve ülkede reklamlar ile organik yüzeylerde markanın popülerliği.
previous_rank

int64

Önceki hafta veya aydaki popülerlik sıralaması.
relative_demand

RelativeDemandEnum

Aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip markayla ilişkili olarak alınan 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 markayla ilişkili olarak alınan tahmini talep.
relative_demand_change

RelativeDemandChangeTypeEnum

Tahmini talepte değişiklik. Artış, düşüş veya sabit kalma durumu.

BestSellersProductClusterView

best_sellers_product_cluster_view tablosunda sorgulanabilir alanlar.

En popüler ürün kümelerini içeren Çok satanlar raporu. Ürün kümesi, aynı ürünü (ör. Google Pixel 7) temsil eden farklı teklif ve varyantların gruplandırılmasıdır.

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 aşağıdakilerden yalnızca 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 üzerinde bir WHERE koşulu belirtilmezse mevcut 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 ay boyunca yapılabilir.

SELECT yan tümcesinde gereklidir. WHERE ifadesinde report_granularity için koşul gereklidir.
report_country_code

string

Sıralamanın hesaplandığı ülke. ISO 3166 biçiminde temsil edilir.

SELECT yan tümcesinde zorunludur. WHERE yan tümcesinde report_country_code koşulu gereklidir.
report_category_id

int64

Sıralama hesaplanırken kullanılan Google ürün kategorisi kimliği. Google ürün sınıflandırmasında gösterilir.

SELECT yan tümcesinde gereklidir. 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ığı.
brand

string

Ürün kümesinin markasıdır.
category_l1

string

Google ürün sınıflandırmasında temsil edilen ürün kümesinin ürün kategorisi (1. seviye).
category_l2

string

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

string

Google ürün sınıflandırmasında temsil edilen ürün kümesinin ürün kategorisi (3. seviye).
category_l4

string

Google ürün sınıflandırmasında temsil edilen ürün kümesinin ürün kategorisi (4. seviye).
category_l5

string

Ürün kümesinin ürün kategorisi (5. seviye), Google ürün sınıflandırmasında temsil edilir.
inventory_status

InventoryStatus

Ürün kümesinin, ülkelerden en az birinde ürün veri kaynağınızda IN_STOCK, tüm ülkelerde ürün veri kaynağınızda OUT_OF_STOCK veya hiç NOT_IN_INVENTORY olup olmadığı.

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

InventoryStatus

Ürün verilerinizin kaynağında, ülkelerden en az birinde markanın şu anda IN_STOCK olan en az bir ürünü olup olmadığı, tüm ürünler tüm ülkelerde OUT_OF_STOCK veya NOT_IN_INVENTORY olup olmadığı.

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

int64

Tahmini satılan birim sayısına göre, seçilen kategori ve ülkedeki reklamlar ile organik yüzeylerde ürün kümesinin popülerliği.
previous_rank

int64

Önceki hafta veya aydaki popülerlik sıralaması.
relative_demand

RelativeDemandEnum

Aynı kategori ve ülkede en yüksek popülerlik sıralamasına sahip ürün kümesiyle ilişkili olarak alınan 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 kümesiyle ilişkili olarak alınan tahmini talep.
relative_demand_change

RelativeDemandChangeTypeEnum

Tahmini talepte değişiklik. Artış, düşüş veya sabit kalma durumu.

InventoryStatus

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

Sıralamalar
INVENTORY_STATUS_UNSPECIFIED Belirtilmedi.
IN_STOCK Bu ürün kümesi veya markaya ait bir ürününüz stokta olmalıdır.
OUT_OF_STOCK Envanterinizde bu ürün kümesi veya marka için bir ürününüz var ancak ürün şu anda stokta değil.
NOT_IN_INVENTORY Envanterinizde bu ürün kümesi veya marka için bir ürününüz yok.

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view tablosunda sorgulanabilir alanlar.

Kategori karşılaştırmasını 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 zorunludur. WHERE ifadesinde date alanında bir koşul gereklidir.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde report_country_code ile ilgili bir koşul gereklidir.
report_category_id

int64

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

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde report_category_id ile ilgili bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.
your_domain_visibility_trend

double

Seçilen zaman aralığının başlangıcına (veya sıfır olmayan gösterimlerin olduğu ilk güne) göre alan adınıza ilişkin gösterimlere dayalı olarak görünürlükteki değişiklik.

"WHERE" yan tümcesinde filtrelenemez.
category_benchmark_visibility_trend

double

Pazara en yakın görünürlük değerine sahip bir grup satıcı için, seçilen zaman aralığının başlangıcına (veya sıfır olmayan gösterim sayısına sahip ilk güne) göre gösterim sayısına dayalı görünürlükteki değişim.

"WHERE" yan tümcesinde filtrelenemez.

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view tablosunda sorgulanabilir alanlar.

Benzer görünürlüğe sahip işletmelerin yer aldığı 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 yan tümcesinde date ile ilgili bir koşul gereklidir.
domain

string

"is_alan_adiniz" doğru ise rakibinizin veya alan adınızın alan adı.

SELECT yan tümcesinde gereklidir. "WHERE" yan tümcesinde filtrelenemez.
is_your_domain

bool

Bu satır, alanınıza ait veriler içeriyorsa doğru değerini alır.

"WHERE" yan tümcesinde filtrelenemez.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde gereklidir. WHERE ifadesinde report_country_code alanında bir koşul gereklidir.
report_category_id

int64

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

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde report_category_id ile ilgili bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.
rank

int64

Gösterimlere göre, seçili anahtarlar (date, report_category_id, report_country_code, traffic_source) için benzer işletmeler sıralamasında alanın konumu. 1 en yüksek puandır.

"WHERE" yan tümcesinde filtrelenemez.
ads_organic_ratio

double

Reklam / organik oranı, alanın organik trafiğe kıyasla Alışveriş reklamlarından gösterim alma sıklığını belirtir. Sayı yuvarlanır ve gruplandırılır.

"WHERE" yan tümcesinde filtrelenemez.
page_overlap_rate

double

Sayfa çakışma oranı, rakip perakendecilere ait tekliflerin tekliflerinizle aynı sayfada 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 kendi teklifinizden daha yüksek bir konuma ne sıklıkta yerleştirildiğini gösterir.

"WHERE" yan tümcesinde filtrelenemez.
relative_visibility

double

Göreli görünürlük, rakiplerinizin tekliflerinin kendi tekliflerinize kıyasla ne sıklıkta gösterildiğini belirtir. Başka bir deyişle, rakip bir perakendeciye ait gösterim sayısının, seçilen bir ürün kategorisi ve ülke için belirli bir zaman aralığında gösterilen gösterim sayısına bölünmesiyle elde edilen orandır.

"WHERE" yan tümcesinde filtrelenemez.

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view tablosunda sorgu için kullanılabilir alanlar.

En yüksek görünürlüğe sahip işletmenin yer aldığı 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 yan tümcesinde date ile ilgili bir koşul gereklidir.
domain

string

Rakibinizin alanı veya "is_your_domain" doğruysa alanınız.

SELECT yan tümcesinde gereklidir. "WHERE" yan tümcesinde filtrelenemez.
is_your_domain

bool

Bu satır, alanınıza ait veriler içeriyorsa doğru değerini alır.

"WHERE" yan tümcesinde filtrelenemez.
report_country_code

string

Gösterimlerin gösterildiği ülke.

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde report_country_code ile ilgili bir koşul gereklidir.
report_category_id

int64

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

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde report_category_id ile ilgili bir koşul gereklidir.
traffic_source

TrafficSourceEnum

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.
rank

int64

Gösterimlere göre, seçili anahtarlar (date, report_category_id, report_country_code, traffic_source) için en başarılı satıcılar sıralamasında alanın konumu. 1 en yüksek puandır.

"WHERE" yan tümcesinde filtrelenemez.
ads_organic_ratio

double

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

"WHERE" yan tümcesinde filtrelenemez.
page_overlap_rate

double

Sayfa çakışma oranı, rakip perakendeci tekliflerinin kendi tekliflerinizle birlikte ne sıklıkta aynı sayfada gösterildiğini belirtir.

"WHERE" yan tümcesinde filtrelenemez.
higher_position_rate

double

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

"WHERE" yan tümcesinde filtrelenemez.

MarketingMethod

Bu türde alan yoktur.

Ürünlerinizi Google'da tanıtmak için kullanılan pazarlama yöntemi (organik ve reklamlar).

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 sorgulanabilir 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 (ör. clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (ör. date) dahildir.

Sorgularda en az bir metrik alanı da seçilmeden segment alanları 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 diliminde tarih. Segment.

WHERE yan tümcesinde date koşulu gereklidir.
week

Date

Satıcının saat diliminde metrik tarihinin haftanın ilk günü (pazartesi). Segment.
clicks

int64

Ürünlerle ilgili olmayan sayfalarınıza yönlendiren resim ve online mağaza bağlantılarının aldığı tıklama sayısı. Metrik.
impressions

int64

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

double

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

PriceCompetitivenessProductView

price_competitiveness_product_view tablosunda sorgu için kullanılabilir 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 mevcut fiyatı.
benchmark_price

Price

Karşılaştırma ülkesindeki ürün kataloğu için mevcut en son fiyat karşılaştırması.
report_country_code

string

Fiyat karşılaştırmasının yapıldığı ülke. ISO 3166 biçiminde temsil edilir.

SELECT yan tümcesinde gereklidir.
id

string

Ürünün channel~languageCode~feedLabel~offerId biçiminde 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 ürün sınıflandırmasındaki ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasındaki ü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ında ürün türü (1. seviye).
product_type_l2

string

Satıcının kendi ürün sınıflandırmasında ü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ında ü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ılabilir 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 mevcut fiyatı.
suggested_price

Price

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

Effectiveness

Fiyat önerisinin uygulanmasının tahmini etkisi (gruplandırılmış).
id

string

Ürünün REST kimliği (channel~languageCode~feedLabel~offerId biçiminde). 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 ürün sınıflandırmasındaki ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasındaki ü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ında ürün türü (1. seviye).
product_type_l2

string

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

string

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

string

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

string

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

double

Önerilen fiyatın mevcut etkin fiyata göre uygulanmasının ardından gösterimlerdeki tahmini değişiklik (kesirli değer). Örneğin 0,05, gösterimlerde tahmini% 5 artıştır.
predicted_clicks_change_fraction

double

Önerilen fiyatın mevcut etkin fiyata göre uygulanmasının ardından tıklama sayısındaki tahmini değişim (kesirli değer). Örneğin, 0,05, tıklama sayısındaki tahmini% 5'lik bir artıştır.
predicted_conversions_change_fraction

double

Önerilen fiyatın mevcut etkin fiyata göre uygulanmasının ardından dönüşümlerdeki tahmini değişiklik, kesirli değer olarak. Örneğin, 0,05, dönüşümlerde% 5'lik bir artış tahminidir).

Etki

Tahmini etkinlik grubu.

Etki düzeyi, fiyat değişikliklerinden en çok fayda sağlayacak ürünleri gösterir. Bu puan, indirimli fiyatın ayarlanmasıyla tahmin edilen performans artışını ve mevcut fiyat ile önerilen fiyat arasındaki farkı dikkate alır. HIGH etki düzeyine sahip fiyat önerilerinin, performansta en büyük artışı sağlayacağı tahmin edilir.

Sıralamalar
EFFECTIVENESS_UNSPECIFIED Etkinliği bilinmiyor.
LOW Etkinlik düşük.
MEDIUM Etki düzeyi ortadır.
HIGH Etki düzeyi yüksektir.

ProductPerformanceView

product_performance_view tablosunda sorgu için kullanılabilir alanlar.

Performans metrikleri (ör. clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (ör. offer_id) dahil olmak üzere hesabınızla ilgili ürün performansı verileri. offer_id gibi ürün boyutlarının değerleri, bir ürünün gösterim sırasındaki durumunu yansıtır.

Sorgularda en az bir metrik alanı da seçilmeden segment alanları 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 diliminde tarih. Segment.

WHERE yan tümcesinde date koşulu gereklidir.
week

Date

Satıcının saat diliminde metrik tarihinin haftanın ilk günü (pazartesi). Segment.
conversion_value

Price

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

Yalnızca FREE trafik kaynağında 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 temsil edilir. 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 ürün sınıflandırmasındaki ürün kategorisi (1. seviye). Segment.
category_l2

string

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

string

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

string

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

string

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

string

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

string

Satıcının kendi ürün sınıflandırmasında ü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ında ürün türü (4. seviye). Segment.
product_type_l5

string

Satıcının kendi ürün sınıflandırmasında ü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ının ürünlerinin gösterilme sayısı. Metrik.
click_through_rate

double

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

double

Ürünle ilişkilendirilen ve dönüşüm tarihinde raporlanan dönüşüm sayısı. İlişkilendirme modeline bağlı olarak, bir dönüşüm birden fazla tıklamaya dağıtılabilir. Bu durumda her tıklamaya kendi kredisi atanır. Bu metrik, söz konusu kredilerin tümünün toplamıdır. Metrik.

Yalnızca FREE trafik kaynağında kullanılabilir.
conversion_rate

double

Dönüşüm sayısının, gösterim tarihinde raporlanan tıklama sayısına bölünmesiyle elde edilen değer. Metrik.

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

ProductView

product_view tablosunda sorgulanabilir alanlar.

Mevcut envanterde bulunan ürünler. Bu tablodaki ürünler, Products alt API'sindeki ürünlerle aynıdır ancak Products alt API'sindeki tüm ürün özellikleri bu tabloda sorgulanabilir değildir. Ürünler alt API'sinin aksine bu tablo, döndürülen ürün listesini ürün özelliklerine göre filtrelemenize olanak tanır. id değerine göre tek bir ürünü almak veya tüm ürünleri listelemek için Products 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 mevcut değilse mevcut değildir.
gtin[]

string

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

Timestamp

Satıcının ürünü oluşturduğu zaman damgası (saniye cinsinden).
expiration_date

Date

Ürünün son kullanma tarihi; ekleme sırasında belirtilir.
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ünlerine kıyasla tahmini performans potansiyeli.
id

string

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

SELECT yan tümcesinde gereklidir.
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 ürün sınıflandırmasındaki ürün kategorisi (1. seviye).
category_l2

string

Google ürün sınıflandırmasındaki ü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'ın ü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ında ü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ında ürün türü (3. seviye).
product_type_l4

string

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

string

Satıcının kendi ürün sınıflandırmasında ü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önderi etiketi.
item_group_id

string

Satıcı tarafından varyantları gruplandırmak için 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 tüm raporlama bağlamları için birleştirilmiş durumu.

Toplu durumun nasıl hesaplandığına dair bir örnek aşağıda verilmiştir:

Ü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ı raporlama bağlamları için uygundur (ancak tüm bağlamlar için uygun değildir).
ELIGIBLE Ürün tüm raporlama bağlamları için uygundur.

ClickPotential

Bir ürünün tıklama potansiyeli, satıcının en iyi performans gösteren ürünlerine kıyasla performans potansiyelini tahmin eder. Ürünlerin tıklama potansiyeli, satıcıların düzeltilmesi gereken ürünleri önceliklendirmesine ve ürünlerin potansiyellerine göre nasıl performans gösterdiğini anlamalarına yardımcı olur.

Sıralamalar
CLICK_POTENTIAL_UNSPECIFIED Tahmin edilen tıklamaların etkisi bilinmiyor.
LOW Satıcının en iyi performans gösteren ürünlerine kıyasla düşük sayıda 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 ilgili öğ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 Sorun otomatik olarak (ör. resim taraması) veya Google incelemesi aracılığıyla çözülür. Satıcının şu anda herhangi bir işlem yapması gerekmez. Çözüm, başka bir soruna neden olabilir (ör. 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ı başına sorun önem derecesi.
aggregated_severity

AggregatedIssueSeverity

Etkilediği tüm raporlama bağlamları için sorunun toplu önem derecesi.

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

AggregatedIssueSeverity

Tüm raporlama bağlamları için birleştirilmiş sorun önem derecesi.

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

IssueSeverityPerReportingContext

Raporlama bağlamı başına sorun önem derecesi.

Alanlar
disapproved_countries[]

string

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

string

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

ReportingContextEnum

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

ItemIssueType

Sorun türü.

Alanlar
code

string

Sorunun hata kodu (Ürün sorunları bölümündeki code ile eşdeğerdir).
canonical_attribute

string

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

RelativeDemand

Bu türde alan yoktur.

Ç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ümesinin veya markanın talebinin% 0-5'i kadardır.
LOW Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın% 6-10'u kadardır.
MEDIUM Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın% 11-20'si kadardır.
HIGH Talep, en yüksek sıralamaya sahip ürün kümesi veya markanın% 21-50'si kadardır.
VERY_HIGH Talep, en yüksek sıralamaya sahip ürün kümesinin veya markanın talebinin% 51-100'ü kadardır.

RelativeDemandChangeType

Bu türde alan yoktur.

Ç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öneme kıyasla daha düşüktür.
FLAT Göreli talep, önceki döneme eşittir.
RISER Göreli talep, önceki döneme kıyasla daha yüksektir.

ReportGranularity

Bu türde alan yoktur.

Çok satanlar raporunun ayrıntı düzeyi. Çok satanlar raporları bir hafta ve bir ay zaman aralığında 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 hesaplanır.
MONTHLY Rapor, bir aylık zaman aralığında 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 iletide, yalnızca sorguda açıkça istenen alanlar doldurulur.

Alanlar
product_performance_view

ProductPerformanceView

product_performance_view tablosunda sorgu için kullanılabilir alanlar.
non_product_performance_view

NonProductPerformanceView

non_product_performance_view tablosunda sorgulanabilir alanlar.
product_view

ProductView

product_view tablosunda sorgulanabilir alanlar.
price_competitiveness_product_view

PriceCompetitivenessProductView

price_competitiveness_product_view tablosunda sorgu için kullanılabilir alanlar.
price_insights_product_view

PriceInsightsProductView

price_insights_product_view tablosunda sorgu için kullanılabilir alanlar.
best_sellers_product_cluster_view

BestSellersProductClusterView

best_sellers_product_cluster_view tablosunda sorgu için kullanılabilir alanlar.
best_sellers_brand_view

BestSellersBrandView

best_sellers_brand_view tablosunda sorgulanabilir alanlar.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view tablosunda sorgulanabilir alanlar.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view tablosunda sorgulanabilir alanlar.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view tablosunda sorgulanabilir alanlar.

SearchRequest

ReportService.Search yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Arama 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 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 tablo ve alanların tam listesi için Kullanılabilir alanlar bölümüne 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. 5.000'den yüksek değerler 5.000'e zorlanacaktır.
page_token

string

İsteğe bağlı. Alınacak sayfanın jetonu. Belirtilmemişse sonuçların ilk sayfası döndürülür. Sonraki sonuç sayfasını istemek için önceki yanıtta next_page_token işlevinden elde edilen 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önderilebilen jeton. Atlanırsa sonraki sayfalar olmaz.

TrafficSource

Bu türde alan yoktur.

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 ve reklam trafiği.