REST Resource: accounts.reports

Kaynak: 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.

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 sorgulanabilir alanlar.

nonProductPerformanceView

object (NonProductPerformanceView)

nonProductPerformanceView tablosunda sorgulanabilir alanlar.

productView

object (ProductView)

productView tablosunda sorgulanabilir alanlar.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

priceCompetitivenessProductView tablosunda sorgulanabilir alanlar.

priceInsightsProductView

object (PriceInsightsProductView)

priceInsightsProductView tablosunda sorgulanabilir alanlar.

bestSellersProductClusterView

object (BestSellersProductClusterView)

bestSellersProductClusterView tablosunda sorgulanabilir alanlar.

bestSellersBrandView

object (BestSellersBrandView)

bestSellersBrandView tablosunda sorgulanabilir alanlar.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

competitiveVisibilityCompetitorView tablosunda sorgulanabilir alanlar.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

competitiveVisibilityTopMerchantView tablosunda sorgulanabilir alanlar.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

competitiveVisibilityBenchmarkView tablosunda sorgulanabilir alanlar.

ProductPerformanceView

productPerformanceView tablosunda sorgulanabilir alanlar.

Performans metrikleri (ör. clicks) ve performans metriklerinin segmentlere ayrıldığı boyutlar (ör. offerId) dahil olmak üzere hesabınızla ilgili ürün performansı verileri. offerId 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.

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 tarih. Segment.

WHERE yan tümcesinde date koşulu gereklidir.

week

object (Date)

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

conversionValue

object (Price)

Ürüne ilişkilendirilen dönüşümlerin değeridir ve dönüşüm tarihinde raporlanır. Metrik.

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

Google ü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ında ürün türü (1. seviye). Segment.

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

Ürünlerin özel gruplandırılması 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ıklama sayısı), ürünlerin gösterilme sayısına (gösterim sayısı) bölünmesiyle elde edilir. Metrik.

conversions

number

Ü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, bu tür tüm kredilerin toplamıdır. Metrik.

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

conversionRate

number

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

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 tarih. Segment.

WHERE yan tümcesinde date koşulu gereklidir.

week

object (Date)

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

clicks

string (int64 format)

Ü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

string (int64 format)

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

clickThroughRate

number

Tıklama oranı: Tıklama sayısının (clicks), ürün dışı sayfalarınıza yönlendiren resim ve online mağaza bağlantılarının gösterim sayısına (impressions) bölümüdür. Metrik.

ProductView

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

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ı hakkında bilgi yoksa yok.

gtin[]

string

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

creationTime

string (Timestamp format)

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

expirationDate

object (Date)

Ürünün, eklenme sırasında belirtilen geçerlilik bitiş tarihi.

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 yalnızca bu alanın 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 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

enum (ChannelEnum)

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

languageCode

string

Ürünün BCP 47 biçimindeki 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 ürün sınıflandırmasındaki ürün kategorisi (1. seviye).

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

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.

shippingLabel

string

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

itemGroupId

string

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

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Toplu durum.

clickPotentialRank

string (int64 format)

Ürünün tıklama potansiyeline göre sıralaması. clickPotentialRank 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:

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

ItemIssue

Ürünle ilişkili öğ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ı başına sorun ö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ı başına sorun önem derecesi.

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

string

Raporlama bağlamında onaylanmayan ülkelerin ISO 3166 biçiminde temsil edilen listesi.

demotedCountries[]

string

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

reportingContext

enum (ReportingContextEnum)

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

AggregatedIssueSeverity

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

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

ItemIssueResolution

Sorunu giderme.

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

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.

PriceCompetitivenessProductView

priceCompetitivenessProductView tablosunda sorgulanabilir 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 mevcut fiyatı.

benchmarkPrice

object (Price)

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

reportCountryCode

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 productView tablosuyla birleştirmek için kullanılabilir.

SELECT yan tümcesinde gereklidir.

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

PriceInsightsProductView

priceInsightsProductView tablosunda sorgulanabilir 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 mevcut fiyatı.

suggestedPrice

object (Price)

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

effectiveness

enum (Effectiveness)

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

id

string

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

SELECT yan tümcesinde gereklidir.

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

predictedImpressionsChangeFraction

number

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

predictedClicksChangeFraction

number

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

predictedConversionsChangeFraction

number

Ö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 derecelendirmede, indirimli fiyatın ayarlanmasıyla tahmin edilen performans artışı ve geçerli fiyatınız ile önerilen fiyat arasındaki fark göz önünde bulundurulur. 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üşüktür.
MEDIUM Etki düzeyi ortadır.
HIGH Etki düzeyi yüksektir.

BestSellersProductClusterView

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

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 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 gereklidir. Sorguda reportDate üzerinde bir WHERE koşulu belirtilmezse mevcut 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 hafta veya bir ay boyunca yapılabilir.

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde reportGranularity koşulu gereklidir.

reportCountryCode

string

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

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde reportCountryCode koşulu gereklidir.

reportCategoryId

string (int64 format)

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 reportCategoryId üzerinde 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.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum (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.

brandInventoryStatus

enum (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 bu alanda hesaba katılmaz.

rank

string (int64 format)

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.

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 olarak alınan 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 kümesiyle ilişkili olarak alınan tahmini talep.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

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.

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.

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

RelativeDemandChangeTypeEnum

Göreli talep değişimi 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.

BestSellersBrandView

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

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 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 gereklidir. Sorguda reportDate üzerinde bir WHERE koşulu belirtilmezse mevcut en son haftalık veya aylık rapor döndürülür.

reportGranularity

enum (ReportGranularityEnum)

Raporun ayrıntı düzeyi. Sıralama, bir hafta veya bir ay boyunca yapılabilir.

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde reportGranularity koşulu gereklidir.

reportCountryCode

string

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

SELECT yan tümcesinde gereklidir. WHERE yan tümcesinde reportCountryCode koşulu gereklidir.

reportCategoryId

string (int64 format)

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 reportCategoryId ü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

string (int64 format)

Satılan tahmini birim sayısına göre, seçilen kategori ve ülkede reklamlar ile organik yüzeylerde markanın 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 ilişkili olarak alınan 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 ilişkili olarak alınan tahmini talep.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

CompetitiveVisibilityCompetitorView

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

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 ile ilgili bir koşul gereklidir.

domain

string

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

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

isYourDomain

boolean

Bu satır alanınızla ilgili veriler içeriyorsa doğru değerini döndürür.

"WHERE" yan tümcesinde filtrelenemez.

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.

rank

string (int64 format)

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

"WHERE" yan tümcesinde filtrelenemez.

adsOrganicRatio

number

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.

pageOverlapRate

number

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.

higherPositionRate

number

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.

relativeVisibility

number

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 perakendecinin 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ümüdür.

"WHERE" yan tümcesinde filtrelenemez.

TrafficSourceEnum

Trafik kaynağı değerleri.

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

CompetitiveVisibilityTopMerchantView

competitiveVisibilityTopMerchantView tablosunda sorgulanabilir 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.

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 ile ilgili bir koşul gereklidir.

domain

string

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

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

isYourDomain

boolean

Bu satır alanınızla ilgili veriler içeriyorsa doğru değerini döndürür.

"WHERE" yan tümcesinde filtrelenemez.

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.

rank

string (int64 format)

Gösterimlere göre, seçili anahtarlar (date, reportCategoryId, reportCountryCode, trafficSource) 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.

adsOrganicRatio

number

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.

pageOverlapRate

number

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.

higherPositionRate

number

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.

CompetitiveVisibilityBenchmarkView

competitiveVisibilityBenchmarkView tablosunda sorgulanabilir alanlar.

Kategori referansı 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 gereklidir. WHERE yan tümcesinde date ile ilgili bir koşul gereklidir.

reportCountryCode

string

Gösterimlerin gösterildiği ülke.

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

reportCategoryId

string (int64 format)

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

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

trafficSource

enum (TrafficSourceEnum)

Gösterimlerin trafik kaynağı.

SELECT yan tümcesinde gereklidir.

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ınız için gösterimlere dayalı görünürlükteki değişim.

"WHERE" yan tümcesinde filtrelenemez.

categoryBenchmarkVisibilityTrend

number

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.

Yöntemler

Bir arama sorgusuyla tanımlanan raporu alır.