Method: accounts.reports.search

Arama sorgusu tarafından tanımlanmış bir raporu alır. Yanıt, pageSize tarafından belirtilenden daha az satır içerebilir. İstenecek daha fazla satır olup olmadığını belirlemek için nextPageToken metriğine güvenin.

HTTP isteği

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

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

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Alanlar
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 tabloların ve alanların tam listesi için Kullanılabilir alanlara bakın.

pageSize

integer

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

pageToken

string

İsteğe bağlı. Alınacak sayfanın jetonu. Belirtilmezse sonuçların ilk sayfası döndürülür. Sonraki sonuç sayfasını istemek için önceki yanıtta nextPageToken işlevinden elde edilen değer kullanılmalıdır.

Yanıt gövdesi

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

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Alanlar
results[]

object (ReportRow)

Arama sorgusuyla eşleşen satırlar.

nextPageToken

string

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

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

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.

JSON gösterimi
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Alanlar
productPerformanceView

object (ProductPerformanceView)

productPerformanceView tablosunda sorgu için kullanılabilir alanlar.

nonProductPerformanceView

object (NonProductPerformanceView)

nonProductPerformanceView tablosunda sorgu için kullanılabilir alanlar.

productView

object (ProductView)

productView tablosunda sorgu için kullanılabilir alanlar.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

priceCompetitivenessProductView tablosunda sorgu için kullanılabilir alanlar.

priceInsightsProductView

object (PriceInsightsProductView)

priceInsightsProductView tablosunda sorgu için kullanılabilir alanlar.

bestSellersProductClusterView

object (BestSellersProductClusterView)

bestSellersProductClusterView tablosunda sorgu için kullanılabilir alanlar.

bestSellersBrandView

object (BestSellersBrandView)

bestSellersBrandView tablosunda sorgu için kullanılabilir alanlar.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

competitiveVisibilityCompetitorView tablosunda sorgu için kullanılabilir alanlar.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

competitiveVisibilityTopMerchantView tablosunda sorgu için kullanılabilir alanlar.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

competitiveVisibilityBenchmarkView tablosunda sorgu için kullanılabilir alanlar.

ProductPerformanceView

productPerformanceView tablosunda sorgu için kullanılabilir alanlar.

Performans metrikleri (ör. clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (ör. offerId) dahil olmak üzere hesabınız için ürün performansı verileri. Ürün boyutlarının (ör. offerId) değerleri, ürünün gösterim anındaki durumunu yansıtır.

Segment alanları, en az bir metrik alanı seçilmeden sorgularda seçilemez.

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

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Alanlar
date

object (Date)

Metriklerin geçerli olduğu satıcı saat diliminde yer alan tarih. Segment.

WHERE ifadesinde date için koşul gereklidir.

week

object (Date)

Satıcı saat diliminde metriklerin tarihi için haftanın ilk günü (pazartesi). Segment.

conversionValue

object (Price)

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

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

marketingMethod

enum (MarketingMethodEnum)

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

customerCountryCode

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.

offerId

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.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

clicks

string (int64 format)

Tıklama sayısı. Metrik.

impressions

string (int64 format)

Satıcının ürünlerinin gösterilme sayısı. Metrik.

clickThroughRate

number

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

conversions

number

Dönüşüm tarihinde ürünle ilişkilendirilen dönüşümlerin 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ğı için kullanılabilir.

conversionRate

number

Gösterim tarihinde raporlanan dönüşüm sayısının tıklama sayısına bölümüdür. Metrik.

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

MarketingMethodEnum

Pazarlama yöntemi değerleri.

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

NonProductPerformanceView

nonProductPerformanceView tablosunda sorgu için kullanılabilir alanlar.

Ürün dışı sayfalarınıza yönlendiren resimler ve online mağaza bağlantılarındaki performans verileri. Buna performans metrikleri (ör. clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (ör. date) dahildir.

Segment alanları, en az bir metrik alanı seçilmeden sorgularda seçilemez.

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

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Alanlar
date

object (Date)

Metriklerin geçerli olduğu satıcı saat diliminde yer alan tarih. Segment.

WHERE ifadesinde date için koşul gereklidir.

week

object (Date)

Satıcı saat diliminde metriklerin tarihi için haftanın ilk günü (pazartesi). Segment.

clicks

string (int64 format)

Resimlerin ve online mağaza bağlantılarının ürün dışı sayfalarınıza yönlendiren tıklama sayısı. Metrik.

impressions

string (int64 format)

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

clickThroughRate

number

Tıklama oranı: Ürün dışı 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.

ProductView

productView tablosunda sorgu için kullanılabilir alanlar.

Geçerli envanterdeki ürünler. Bu tablodaki ürünler, Ürünler alt API'sindeki ürünlerle aynıdır ancak Ürünler alt API'sindeki tüm ürün özellikleri, bu tabloda sorgulanmak için kullanılamaz. Ü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.

JSON gösterimi
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Alanlar
price

object (Price)

Ürün fiyatı. Ürünün fiyatıyla ilgili bilgi mevcut değilse mevcut değil.

gtin[]

string

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

creationTime

string (Timestamp format)

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

expirationDate

object (Date)

Ürünün son kullanma tarihi; ekleme sırasında belirtilir.

itemIssues[]

object (ItemIssue)

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

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

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

clickPotential

enum (ClickPotential)

Satıcının en iyi performans gösteren ürünlerine kıyasla tahmini performans potansiyeli.

id

string

Ürünün REST kimliği (channel~languageCode~feedLabel~offerId biçiminde). Ürünler üzerinde çalışan Merchant API yöntemlerinde bu parametre, name parametresi olarak alınır.

SELECT yan tümcesinde zorunludur.

channel

enum (ChannelEnum)

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

languageCode

string

Ürünün BCP 47 biçiminde dil kodu.

feedLabel

string

Ürünün feed etiketi.

offerId

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ı.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

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.

shippingLabel

string

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

itemGroupId

string

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

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Birleştirilmiş durum.

clickPotentialRank

string (int64 format)

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

AggregatedReportingContextStatus

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

Aşağıda, toplam durumun nasıl hesaplandığına ilişkin bir örnek 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 uygun değil veya tüm raporlama bağlamları için onaylanmadı.
PENDING Ürünün durumu tüm raporlama bağlamlarında beklemede.
ELIGIBLE_LIMITED Ürün, yalnızca bazı raporlama bağlamları için uygun.
ELIGIBLE Ürün tüm raporlama bağlamları için uygundur.

ItemIssue

Ürünle ilgili öğe sorunu.

JSON gösterimi
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Alanlar
type

object (ItemIssueType)

Öğe sorunu türü.

severity

object (ItemIssueSeverity)

Öğe sorununun önem derecesi.

resolution

enum (ItemIssueResolution)

Öğe sorununun çözümü.

ItemIssueType

Sorun türü.

JSON gösterimi
{
  "code": string,
  "canonicalAttribute": string
}
Alanlar
code

string

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

canonicalAttribute

string

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

ItemIssueSeverity

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

JSON gösterimi
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Alanlar
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

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

aggregatedSeverity

enum (AggregatedIssueSeverity)

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

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

IssueSeverityPerReportingContext

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

JSON gösterimi
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Alanlar
disapprovedCountries[]

string

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

demotedCountries[]

string

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

reportingContext

enum (ReportingContextEnum)

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

AggregatedIssueSeverity

Tüm raporlama bağlamları için toplu sorunun ö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.

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 tarama) veya bir Google incelemesi aracılığıyla çözülür. Şu anda satıcının herhangi bir işlem yapması gerekmiyor. Çözüm, başka bir soruna neden olabilir (örneğin, tarama başarısız olursa).

ClickPotential

Bir ürünün tıklama potansiyeli, performans potansiyelini satıcının en iyi performans gösteren ürünleriyle karşılaştırarak tahmin eder. Ürünlerin tıklama potansiyeli, satıcıların hangi ürünleri düzelteceklerini önceliklendirmelerine ve ürünlerin 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 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.

PriceCompetitivenessProductView

priceCompetitivenessProductView 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.

JSON gösterimi
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Alanlar
price

object (Price)

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

benchmarkPrice

object (Price)

Karşılaştırma ülkesinde ürünün kataloğu için sunulan en güncel fiyat karşılaştırması.

reportCountryCode

string

Fiyat karşılaştırmasının ülkesi. ISO 3166 biçiminde gösterilir.

SELECT yan tümcesinde zorunludur.

id

string

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

SELECT yan tümcesinde zorunludur.

offerId

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ı.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

PriceInsightsProductView

priceInsightsProductView 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.

JSON gösterimi
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Alanlar
price

object (Price)

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

suggestedPrice

object (Price)

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

effectiveness

enum (Effectiveness)

Gruplandırılmış fiyat önerisinin uygulanmasının tahmini etkisi.

id

string

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

SELECT yan tümcesinde zorunludur.

offerId

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ı.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

predictedImpressionsChangeFraction

number

Önerilen fiyat sunulduktan sonra, mevcut etkin fiyata kıyasla gösterim sayısındaki tahmini değişimin oranı. Örneğin 0,05, gösterimlerde tahmini% 5 artıştır.

predictedClicksChangeFraction

number

Önerilen fiyat sunulduktan sonra, mevcut etkin fiyata kıyasla tıklama sayısındaki tahmini değişimin oranı. Örneğin 0,05, tıklamalarda tahmini% 5'lik bir artıştır.

predictedConversionsChangeFraction

number

Geçerli etkin fiyata kıyasla önerilen fiyat sunulduktan sonra, dönüşüm sayısındaki tahmini değişimin oranı. Örneğin 0,05 değeri, dönüşümlerde tahmini% 5'lik bir artıştır.)

Etki Düzeyi

Tahmini etkinlik grubu.

Etkinlik, fiyat değişikliklerinden en çok hangi ürünlerin fayda sağlayacağını 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üzeyi sunan fiyat önerilerinin, performansta en büyük artışı sağlayacağı tahmin ediliyor.

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

BestSellersProductClusterView

bestSellersProductClusterView tablosunda sorgu için kullanılabilir 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ı teklifler ve varyantlar için oluşturulan bir gruptur.

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

JSON gösterimi
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Alanlar
reportDate

object (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 reportDate için bir WHERE koşulu belirtilmezse en son haftalık veya aylık rapor döndürülür.

variantGtins[]

string

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

reportGranularity

enum (ReportGranularityEnum)

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

SELECT yan tümcesinde zorunludur. WHERE ifadesinde reportGranularity için koşul gereklidir.

reportCountryCode

string

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

SELECT yan tümcesinde zorunludur. WHERE ifadesinde reportCountryCode için koşul gereklidir.

reportCategoryId

string (int64 format)

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

SELECT yan tümcesinde zorunludur. Sorguda reportCategoryId 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ı.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum (InventoryStatus)

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

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

brandInventoryStatus

enum (InventoryStatus)

Ülkelerin en az birinde ürün verileri kaynağınızda şu anda IN_STOCK markasının en az bir ürünü olsa da tüm ürünler tüm ülkelerdeki ürün veri kaynağınızda OUT_OF_STOCK veya NOT_IN_INVENTORY değerine sahiptir.

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

rank

string (int64 format)

Ürün kümesinin, satılan tahmini birim sayısına göre seçilen kategori ve ülkede Ads ve organik yüzeylerdeki popülerliği.

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Tahmini talepteki değişim. Düşen, batan veya düz duran

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ığı üzerinden hesaplanır.

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 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 bir ürününüz yok.

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% 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ümesi veya markanın% 51-100'ü kadardır.

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şit.
RISER Göreli talep önceki dönemden daha yüksek.

BestSellersBrandView

bestSellersBrandView tablosunda sorgu için kullanılabilir 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.

JSON gösterimi
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Alanlar
reportDate

object (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 reportDate için bir WHERE koşulu belirtilmezse en son haftalık veya aylık rapor döndürülür.

reportGranularity

enum (ReportGranularityEnum)

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

SELECT yan tümcesinde zorunludur. WHERE ifadesinde reportGranularity için koşul gereklidir.

reportCountryCode

string

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

SELECT yan tümcesinde zorunludur. WHERE ifadesinde reportCountryCode için koşul gereklidir.

reportCategoryId

string (int64 format)

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

SELECT yan tümcesinde zorunludur. Sorguda reportCategoryId 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

string (int64 format)

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

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Tahmini talepteki değişim. Düşen, batan veya düz duran

CompetitiveVisibilityCompetitorView

competitiveVisibilityCompetitorView tablosunda sorgu için kullanılabilir alanlar.

Benzer görünürlüğe sahip 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.

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Alanlar
date

object (Date)

Bu satırın tarihi.

WHERE yan tümcesinde date için bir koşul gereklidir.

domain

string

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

SELECT yan tümcesinde zorunludur. "WHERE" yan tümcesinde filtrelenemez.

isYourDomain

boolean

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

"WHERE" yan tümcesinde filtrelenemez.

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.

rank

string (int64 format)

Gösterimlere göre seçilen anahtarlar için alanın benzer işletmeler sıralamasındaki konumu (date, reportCategoryId, reportCountryCode, trafficSource). 1 en yüksek değerdir.

"WHERE" yan tümcesinde filtrelenemez.

adsOrganicRatio

number

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.

pageOverlapRate

number

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

"WHERE" yan tümcesinde filtrelenemez.

higherPositionRate

number

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

"WHERE" yan tümcesinde filtrelenemez.

relativeVisibility

number

Göreli görünürlük, rakiplerinizin tekliflerinin sizin 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 değerdir.

"WHERE" yan tümcesinde filtrelenemez.

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.

CompetitiveVisibilityTopMerchantView

competitiveVisibilityTopMerchantView tablosunda sorgu için kullanılabilir alanlar.

En yüksek 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.

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Alanlar
date

object (Date)

Bu satırın tarihi.

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

domain

string

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

SELECT yan tümcesinde zorunludur. "WHERE" yan tümcesinde filtrelenemez.

isYourDomain

boolean

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

"WHERE" yan tümcesinde filtrelenemez.

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.

rank

string (int64 format)

Gösterimlere göre seçilen anahtarlar için (date, reportCategoryId, reportCountryCode, trafficSource) alanın en üst satıcı sıralamasındaki konumu. 1 en yüksek değerdir.

"WHERE" yan tümcesinde filtrelenemez.

adsOrganicRatio

number

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.

pageOverlapRate

number

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

"WHERE" yan tümcesinde filtrelenemez.

higherPositionRate

number

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

"WHERE" yan tümcesinde filtrelenemez.

CompetitiveVisibilityBenchmarkView

competitiveVisibilityBenchmarkView tablosunda sorgu için kullanılabilir 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.

JSON gösterimi
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Alanlar
date

object (Date)

Bu satırın tarihi.

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

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde zorunludur.

yourDomainVisibilityTrend

number

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.

categoryBenchmarkVisibilityTrend

number

Pazara yakın en yüksek görünürlüğe sahip satıcı grubu için seçilen zaman aralığının başlangıcına (veya sıfır olmayan gösterimlerin olduğu ilk güne) göre gösterimlere dayalı görünürlükteki değişiklik.

"WHERE" yan tümcesinde filtrelenemez.