Method: accounts.reports.search

Mengambil laporan yang ditentukan oleh kueri penelusuran. Respons mungkin berisi lebih sedikit baris daripada yang ditentukan oleh pageSize. Andalkan nextPageToken untuk menentukan apakah ada lebih banyak baris yang akan diminta.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. ID akun yang melakukan panggilan. Harus berupa akun mandiri atau sub-akun MCA. Format: accounts/{account}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Kolom
query

string

Wajib. Kueri yang menentukan laporan yang akan diambil.

Untuk mengetahui detail tentang cara membuat kueri, lihat panduan Bahasa Kueri. Untuk mengetahui daftar lengkap tabel dan kolom yang tersedia, lihat Kolom yang tersedia.

pageSize

integer

Opsional. Jumlah ReportRows yang akan diambil dalam satu halaman. Default-nya adalah 1.000. Nilai di atas 5.000 akan dikonversi menjadi 5.000.

pageToken

string

Opsional. Token halaman yang akan diambil. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan. Untuk meminta halaman hasil berikutnya, nilai yang diperoleh dari nextPageToken dalam respons sebelumnya harus digunakan.

Isi respons

Pesan respons untuk metode ReportService.Search.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Kolom
results[]

object (ReportRow)

Baris yang cocok dengan kueri penelusuran.

nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika dihilangkan, maka tidak ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ReportRow

Baris hasil yang ditampilkan dari kueri penelusuran.

Hanya pesan yang sesuai dengan tabel yang dikueri yang diisi dalam respons. Dalam pesan yang diisi, hanya kolom yang diminta secara eksplisit dalam kueri yang akan diisi.

Representasi JSON
{
  "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)
  }
}
Kolom
productPerformanceView

object (ProductPerformanceView)

Kolom yang tersedia untuk kueri di tabel productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Kolom yang tersedia untuk kueri di tabel nonProductPerformanceView.

productView

object (ProductView)

Kolom yang tersedia untuk kueri di tabel productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Kolom yang tersedia untuk kueri di tabel priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Kolom yang tersedia untuk kueri di tabel priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Kolom tersedia untuk kueri di tabel bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Kolom yang tersedia untuk kueri di tabel bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Kolom yang tersedia untuk kueri di tabel competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Kolom yang tersedia untuk kueri di tabel competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Kolom tersedia untuk kueri di tabel competitiveVisibilityBenchmarkView.

ProductPerformanceView

Kolom tersedia untuk kueri di tabel productPerformanceView.

Data performa produk untuk akun Anda, termasuk metrik performa (misalnya, clicks) dan dimensi yang sesuai dengan segmentasi metrik performa (misalnya, offerId). Nilai dimensi produk, seperti offerId, mencerminkan status produk pada saat tayangan iklan.

Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih minimal satu kolom metrik.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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
}
Kolom
date

object (Date)

Tanggal dalam zona waktu penjual tempat metrik berlaku. Segmen.

Kondisi pada date diperlukan dalam klausa WHERE.

week

object (Date)

Hari pertama dalam seminggu (Senin) dari tanggal metrik di zona waktu penjual. Segmen.

conversionValue

object (Price)

Nilai konversi yang diatribusikan ke produk, yang dilaporkan pada tanggal konversi. Metrik.

Hanya tersedia untuk sumber traffic FREE.

marketingMethod

enum (MarketingMethodEnum)

Metode pemasaran yang berlaku untuk metrik. Segmen.

customerCountryCode

string

Kode negara tempat pelanggan berada pada saat peristiwa terjadi. Ditampilkan dalam format ISO 3166. Segmen.

Jika negara pelanggan tidak dapat ditentukan, kode 'ZZ' khusus akan ditampilkan.

offerId

string

ID produk yang diberikan penjual. Segmen.

title

string

Judul produk. Segmen.

brand

string

Merek produk. Segmen.

categoryL1

string

Kategori produk (level 1) dalam taksonomi produk Google. Segmen.

categoryL2

string

Kategori produk (level 2) dalam taksonomi produk Google. Segmen.

categoryL3

string

Kategori produk (tingkat 3) dalam taksonomi produk Google. Segmen.

categoryL4

string

Kategori produk (level 4) dalam taksonomi produk Google. Segmen.

categoryL5

string

Kategori produk (level 5) dalam taksonomi produk Google. Segmen.

productTypeL1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri. Segmen.

productTypeL2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri. Segmen.

productTypeL3

string

Jenis produk (tingkat 3) dalam taksonomi produk penjual sendiri. Segmen.

productTypeL4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri. Segmen.

productTypeL5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri. Segmen.

customLabel0

string

Label kustom 0 untuk pengelompokan produk kustom. Segmen.

customLabel1

string

Label kustom 1 untuk pengelompokan produk kustom. Segmen.

customLabel2

string

Label kustom 2 untuk pengelompokan produk kustom. Segmen.

customLabel3

string

Label khusus 3 untuk pengelompokan produk secara khusus. Segmen.

customLabel4

string

Label kustom 4 untuk pengelompokan produk kustom. Segmen.

clicks

string (int64 format)

Jumlah klik. Metrik.

impressions

string (int64 format)

Frekuensi produk penjual ditampilkan. Metrik.

clickThroughRate

number

Rasio klik-tayang - jumlah klik yang diterima produk penjual (klik) dibagi dengan frekuensi produk ditampilkan (tayangan). Metrik.

conversions

number

Jumlah konversi yang diatribusikan ke produk, yang dilaporkan pada tanggal konversi. Bergantung pada model atribusi, konversi mungkin didistribusikan ke beberapa klik, yang memberikan kredit masing-masing untuk setiap klik. Metrik ini adalah jumlah dari semua kredit tersebut. Metrik.

Hanya tersedia untuk sumber traffic FREE.

conversionRate

number

Jumlah konversi dibagi dengan jumlah klik, yang dilaporkan pada tanggal tayangan. Metrik.

Hanya tersedia untuk sumber traffic FREE.

MarketingMethodEnum

Nilai metode pemasaran.

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED Tidak ditentukan.
ORGANIC Pemasaran organik.
ADS Pemasaran berbasis iklan.

NonProductPerformanceView

Kolom yang tersedia untuk kueri di tabel nonProductPerformanceView.

Data performa pada gambar dan link toko online yang mengarah ke halaman non-produk Anda. Hal ini mencakup metrik performa (misalnya, clicks) dan dimensi yang digunakan untuk menyegmentasikan metrik performa (misalnya, date).

Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih minimal satu kolom metrik.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Kolom
date

object (Date)

Tanggal dalam zona waktu penjual tempat metrik berlaku. Segmen.

Kondisi pada date diperlukan dalam klausa WHERE.

week

object (Date)

Hari pertama dalam seminggu (Senin) dari tanggal metrik di zona waktu penjual. Segmen.

clicks

string (int64 format)

Jumlah klik pada gambar dan link toko online yang mengarah ke halaman non-produk Anda. Metrik.

impressions

string (int64 format)

Frekuensi gambar dan link toko online yang mengarah ke halaman non-produk Anda ditampilkan. Metrik.

clickThroughRate

number

Rasio klik-tayang - jumlah klik (clicks) dibagi dengan jumlah tayangan (impressions) gambar dan link toko online yang mengarah ke halaman non-produk Anda. Metrik.

ProductView

Kolom tersedia untuk kueri di tabel productView.

Produk dalam inventaris saat ini. Produk dalam tabel ini sama dengan di sub-API Produk, tetapi tidak semua atribut produk dari sub-API Produk tersedia untuk kueri dalam tabel ini. Berbeda dengan sub-API Produk, tabel ini memungkinkan pemfilteran daftar produk yang ditampilkan berdasarkan atribut produk. Untuk mengambil satu produk berdasarkan id atau mencantumkan semua produk, sub-API Produk harus digunakan.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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
}
Kolom
price

object (Price)

Harga produk. Tidak ada jika informasi tentang harga produk tidak tersedia.

gtin[]

string

Daftar Nomor Barang Perdagangan Global (GTIN) produk.

creationTime

string (Timestamp format)

Waktu penjual membuat produk dalam detik stempel waktu.

expirationDate

object (Date)

Tanggal habis masa berlaku untuk produk, yang ditentukan saat penyisipan.

itemIssues[]

object (ItemIssue)

Daftar masalah item untuk produk.

Kolom ini tidak dapat digunakan untuk mengurutkan hasil.

Hanya atribut yang dipilih dari kolom ini (misalnya, itemIssues.severity.aggregated_severity) yang dapat digunakan untuk memfilter hasil.

clickPotential

enum (ClickPotential)

Perkiraan potensi performa dibandingkan dengan produk penjual yang berperforma tertinggi.

id

string

ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Metode Merchant API yang beroperasi pada produk menggunakan ini sebagai parameter name.

Wajib ada dalam klausa SELECT.

channel

enum (ChannelEnum)

Saluran produk. Dapat berupa ONLINE atau LOCAL.

languageCode

string

Kode bahasa produk dalam format BCP 47.

feedLabel

string

Label feed produk.

offerId

string

ID produk yang diberikan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (tingkat 1) dalam taksonomi produk Google.

categoryL2

string

Kategori produk (level 2) di taksonomi produk Google.

categoryL3

string

Kategori produk (level 3) di taksonomi produk Google.

categoryL4

string

Kategori produk (tingkat 4) dalam taksonomi produk Google.

categoryL5

string

Kategori produk (level 5) di taksonomi produk Google.

productTypeL1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.

productTypeL2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri.

productTypeL3

string

Jenis produk (tingkat 3) di taksonomi produk milik penjual.

productTypeL4

string

Jenis produk (tingkat 4) di taksonomi produk milik penjual.

productTypeL5

string

Jenis produk (tingkat 5) di taksonomi produk milik penjual.

condition

string

Kondisi produk.

availability

string

Ketersediaan produk.

shippingLabel

string

Label pengiriman yang dinormalisasi yang ditentukan di sumber data.

itemGroupId

string

ID kelompok item yang diberikan oleh penjual untuk mengelompokkan varian.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Status gabungan.

clickPotentialRank

string (int64 format)

Peringkat produk berdasarkan potensi kliknya. Produk dengan clickPotentialRank 1 memiliki potensi klik tertinggi di antara produk penjual yang memenuhi kondisi kueri penelusuran.

AggregatedReportingContextStatus

Status produk yang digabungkan untuk semua konteks pelaporan.

Berikut adalah contoh cara penghitungan status gabungan:

Listingan gratis Iklan Shopping Status
Disetujui Disetujui VALID
Disetujui Tertunda VALID
Disetujui Tidak disetujui ELIGIBLE_LIMITED
Tertunda Tertunda TERTUNDA
Tidak disetujui Tidak disetujui NOT_ELIGIBLE_OR_DISAPPROVED
Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Tidak ditentukan.
NOT_ELIGIBLE_OR_DISAPPROVED Produk tidak memenuhi syarat atau tidak disetujui untuk semua konteks pelaporan.
PENDING Status produk tertunda di semua konteks pelaporan.
ELIGIBLE_LIMITED Produk memenuhi syarat untuk beberapa (tetapi tidak semua) konteks pelaporan.
ELIGIBLE Produk memenuhi syarat untuk semua konteks pelaporan.

ItemIssue

Masalah item yang terkait dengan produk.

Representasi JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Kolom
type

object (ItemIssueType)

Jenis masalah item.

severity

object (ItemIssueSeverity)

Tingkat keparahan masalah item.

resolution

enum (ItemIssueResolution)

Penyelesaian masalah item.

ItemIssueType

Jenis masalah.

Representasi JSON
{
  "code": string,
  "canonicalAttribute": string
}
Kolom
code

string

Kode error masalah, setara dengan code dari Masalah produk.

canonicalAttribute

string

Nama atribut kanonis untuk masalah khusus atribut.

ItemIssueSeverity

Bagaimana masalah tersebut memengaruhi penayangan produk.

Representasi JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Kolom
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Tingkat keparahan masalah sesuai konteks pelaporan.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Tingkat keparahan masalah gabungan untuk semua konteks pelaporan yang terpengaruh.

Kolom ini dapat digunakan untuk memfilter hasil.

IssueSeverityPerReportingContext

Tingkat keparahan masalah sesuai konteks pelaporan.

Representasi JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Kolom
disapprovedCountries[]

string

Daftar negara yang tidak disetujui dalam konteks pelaporan, yang direpresentasikan dalam format ISO 3166.

demotedCountries[]

string

Daftar negara yang diturunkan peringkatnya dalam konteks pelaporan, yang direpresentasikan dalam format ISO 3166.

reportingContext

enum (ReportingContextEnum)

Konteks pelaporan tempat masalah diterapkan.

AggregatedIssueSeverity

Tingkat keparahan masalah yang digabungkan untuk semua konteks pelaporan.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Tidak ditentukan.
DISAPPROVED Masalah menolak produk setidaknya dalam satu konteks pelaporan.
DEMOTED Masalah akan mendemosikan produk di semua konteks pelaporan yang terpengaruh.
PENDING Penyelesaian masalah adalah PENDING_PROCESSING.

ItemIssueResolution

Cara menyelesaikan masalah.

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Tidak ditentukan.
MERCHANT_ACTION Penjual harus memperbaiki masalah tersebut.
PENDING_PROCESSING Masalah ini akan diselesaikan secara otomatis (misalnya, crawl gambar) atau melalui peninjauan Google. Anda tidak perlu melakukan tindakan apa pun saat ini. Penyelesaian dapat menyebabkan masalah lain (misalnya, jika crawling gagal).

ClickPotential

Potensi klik produk memperkirakan potensi performanya dibandingkan dengan produk penjual yang berperforma tertinggi. Potensi klik suatu produk membantu penjual memprioritaskan produk mana yang harus diperbaiki dan membantu mereka memahami performa produk terhadap potensinya.

Enum
CLICK_POTENTIAL_UNSPECIFIED Dampak klik yang diprediksi tidak diketahui.
LOW Berpotensi menerima jumlah klik yang rendah dibandingkan dengan produk penjual yang memiliki performa tertinggi.
MEDIUM Berpotensi menerima jumlah klik yang sedang dibandingkan dengan produk penjual yang memiliki performa tertinggi.
HIGH Berpotensi menerima jumlah klik yang serupa dengan produk penjual berperforma tertinggi.

PriceCompetitivenessProductView

Kolom yang tersedia untuk kueri di tabel priceCompetitivenessProductView.

Laporan Persaingan harga.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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
}
Kolom
price

object (Price)

Harga produk saat ini.

benchmarkPrice

object (Price)

Patokan harga terbaru yang tersedia untuk katalog produk di negara patokan.

reportCountryCode

string

Negara tolok ukur harga. Ditampilkan dalam format ISO 3166.

Wajib ada dalam klausa SELECT.

id

string

ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Dapat digunakan untuk menggabungkan data dengan tabel productView.

Wajib ada dalam klausa SELECT.

offerId

string

ID produk yang disediakan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (level 1) di taksonomi produk Google.

categoryL2

string

Kategori produk (level 2) di taksonomi produk Google.

categoryL3

string

Kategori produk (level 3) di taksonomi produk Google.

categoryL4

string

Kategori produk (level 4) di taksonomi produk Google.

categoryL5

string

Kategori produk (level 5) di taksonomi produk Google.

productTypeL1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.

productTypeL2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri.

productTypeL3

string

Jenis produk (tingkat 3) di taksonomi produk milik penjual.

productTypeL4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri.

productTypeL5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri.

PriceInsightsProductView

Kolom yang tersedia untuk kueri di tabel priceInsightsProductView.

Laporan Analisis harga.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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
}
Kolom
price

object (Price)

Harga produk saat ini.

suggestedPrice

object (Price)

Harga terbaru yang disarankan untuk produk.

effectiveness

enum (Effectiveness)

Prediksi efektivitas penerapan saran harga, dikelompokkan.

id

string

ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Dapat digunakan untuk menggabungkan data dengan tabel productView.

Wajib ada dalam klausa SELECT.

offerId

string

ID produk yang disediakan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (level 1) di taksonomi produk Google.

categoryL2

string

Kategori produk (tingkat 2) dalam taksonomi produk Google.

categoryL3

string

Kategori produk (level 3) di taksonomi produk Google.

categoryL4

string

Kategori produk (tingkat 4) dalam taksonomi produk Google.

categoryL5

string

Kategori produk (tingkat 5) dalam taksonomi produk Google.

productTypeL1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.

productTypeL2

string

Jenis produk (tingkat 2) di taksonomi produk milik penjual.

productTypeL3

string

Jenis produk (tingkat 3) dalam taksonomi produk penjual sendiri.

productTypeL4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri.

productTypeL5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri.

predictedImpressionsChangeFraction

number

Prediksi perubahan tayangan sebagai pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan tayangan iklan sebesar 5%.

predictedClicksChangeFraction

number

Prediksi perubahan klik sebagai bagian kecil setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan klik sebesar 5%.

predictedConversionsChangeFraction

number

Prediksi perubahan konversi sebagai pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan konversi sebesar 5%).

Efektivitas

Bucket efektivitas yang diprediksi.

Efektivitas menunjukkan produk mana yang paling diuntungkan dari perubahan harga. Rating ini mempertimbangkan peningkatan performa yang diprediksi dengan menyesuaikan harga promo dan selisih antara harga saat ini dan harga yang disarankan. Saran harga dengan efektivitas HIGH diprediksi akan mendorong peningkatan performa terbesar.

Enum
EFFECTIVENESS_UNSPECIFIED Efektivitas tidak diketahui.
LOW Efektivitasnya rendah.
MEDIUM Efektivitasnya sedang.
HIGH Efektivitasnya tinggi.

BestSellersProductClusterView

Kolom yang tersedia untuk kueri di tabel bestSellersProductClusterView.

Laporan Terlaris dengan cluster produk teratas. Cluster produk adalah pengelompokan untuk berbagai penawaran dan varian yang mewakili produk yang sama, misalnya, Google Pixel 7.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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)
}
Kolom
reportDate

object (Date)

Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari berikut:

  • Hari pertama dalam seminggu (Senin) untuk laporan mingguan,
  • Hari pertama setiap bulan untuk laporan bulanan.

Wajib ada dalam klausa SELECT. Jika kondisi WHERE pada reportDate tidak ditentukan dalam kueri, laporan mingguan atau bulanan terbaru yang tersedia akan ditampilkan.

variantGtins[]

string

GTIN contoh varian cluster produk.

reportGranularity

enum (ReportGranularityEnum)

Perincian laporan. Peringkat dapat dilakukan selama jangka waktu seminggu atau sebulan.

Wajib ada dalam klausa SELECT. Kondisi pada reportGranularity diperlukan dalam klausa WHERE.

reportCountryCode

string

Negara tempat peringkat dihitung. Ditampilkan dalam format ISO 3166.

Wajib dalam klausa SELECT. Kondisi pada reportCountryCode diperlukan dalam klausa WHERE.

reportCategoryId

string (int64 format)

ID kategori produk Google untuk menghitung peringkat, yang diwakili dalam taksonomi produk Google.

Wajib dalam klausa SELECT. Jika kondisi WHERE pada reportCategoryId tidak ditentukan dalam kueri, peringkat untuk semua kategori tingkat teratas akan ditampilkan.

title

string

Judul cluster produk.

brand

string

Merek cluster produk.

categoryL1

string

Kategori produk (level 1) dari cluster produk, yang diwakili dalam taksonomi produk Google.

categoryL2

string

Kategori produk (tingkat 2) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.

categoryL3

string

Kategori produk (tingkat 3) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.

categoryL4

string

Kategori produk (tingkat 4) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.

categoryL5

string

Kategori produk (level 5) dari cluster produk, yang diwakili dalam taksonomi produk Google.

inventoryStatus

enum (InventoryStatus)

Apakah cluster produk adalah IN_STOCK di sumber data produk Anda di setidaknya salah satu negara, OUT_OF_STOCK di sumber data produk Anda di semua negara, atau NOT_IN_INVENTORY sama sekali.

Kolom ini tidak mempertimbangkan filter negara laporan Terlaris.

brandInventoryStatus

enum (InventoryStatus)

Apakah minimal ada satu produk dari merek yang saat ini IN_STOCK di sumber data produk Anda di minimal salah satu negara, semua produk berstatus OUT_OF_STOCK di sumber data produk Anda di semua negara, atau NOT_IN_INVENTORY.

Kolom ini tidak mempertimbangkan filter negara laporan Terlaris.

rank

string (int64 format)

Popularitas cluster produk di platform Iklan dan organik, dalam kategori dan negara yang dipilih, berdasarkan perkiraan jumlah unit yang terjual.

previousRank

string (int64 format)

Peringkat popularitas pada minggu atau bulan sebelumnya.

relativeDemand

enum (RelativeDemandEnum)

Estimasi permintaan dalam kaitannya dengan cluster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama.

previousRelativeDemand

enum (RelativeDemandEnum)

Estimasi permintaan dalam kaitannya dengan cluster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Perubahan estimasi permintaan. Apakah naik, turun, atau tetap datar.

ReportGranularityEnum

Melaporkan nilai perincian.

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Tidak ditentukan.
WEEKLY Laporan dikomputasi selama jangka waktu seminggu.
MONTHLY Laporan dihitung selama jangka waktu satu bulan.

InventoryStatus

Status cluster atau merek produk di inventaris Anda.

Enum
INVENTORY_STATUS_UNSPECIFIED Tidak ditentukan.
IN_STOCK Anda memiliki produk untuk cluster produk atau merek ini yang tersedia.
OUT_OF_STOCK Anda memiliki produk untuk cluster produk atau merek ini di inventaris, tetapi saat ini stoknya habis.
NOT_IN_INVENTORY Anda tidak memiliki produk untuk merek atau cluster produk ini dalam inventaris.

RelativeDemandEnum

Nilai permintaan relatif.

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Tidak ditentukan.
VERY_LOW Permintaan adalah 0-5% dari permintaan cluster atau merek produk dengan peringkat tertinggi.
LOW Permintaannya adalah 6-10% dari permintaan cluster produk atau merek terpopuler.
MEDIUM Permintaan adalah 11-20% dari permintaan cluster atau merek produk dengan peringkat tertinggi.
HIGH Permintaannya adalah 21-50% dari permintaan cluster produk atau merek terpopuler.
VERY_HIGH Permintaan adalah 51-100% dari permintaan cluster atau merek produk dengan peringkat tertinggi.

RelativeDemandChangeTypeEnum

Nilai jenis perubahan permintaan relatif.

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Tidak ditentukan.
SINKER Permintaan relatif lebih rendah dari jangka waktu sebelumnya.
FLAT Permintaan relatif sama dengan jangka waktu sebelumnya.
RISER Permintaan relatif lebih tinggi dari jangka waktu sebelumnya.

BestSellersBrandView

Kolom yang tersedia untuk kueri di tabel bestSellersBrandView.

Laporan Item terlaris dengan merek ternama.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "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)
}
Kolom
reportDate

object (Date)

Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari berikut:

  • Hari pertama dalam seminggu (Senin) untuk laporan mingguan,
  • Hari pertama setiap bulan untuk laporan bulanan.

Wajib ada dalam klausa SELECT. Jika kondisi WHERE di reportDate tidak ditentukan dalam kueri, laporan mingguan atau bulanan terbaru yang tersedia akan ditampilkan.

reportGranularity

enum (ReportGranularityEnum)

Tingkat perincian laporan. Peringkat dapat dilakukan selama jangka waktu seminggu atau sebulan.

Wajib ada dalam klausa SELECT. Kondisi pada reportGranularity diperlukan dalam klausa WHERE.

reportCountryCode

string

Negara tempat peringkat dihitung. Ditampilkan dalam format ISO 3166.

Wajib dalam klausa SELECT. Kondisi pada reportCountryCode diperlukan dalam klausa WHERE.

reportCategoryId

string (int64 format)

ID kategori produk Google untuk menghitung peringkat, yang diwakili dalam taksonomi produk Google.

Wajib ada dalam klausa SELECT. Jika kondisi WHERE di reportCategoryId tidak ditentukan dalam kueri, peringkat untuk semua kategori level teratas akan ditampilkan.

brand

string

Nama brand.

rank

string (int64 format)

Popularitas merek di Iklan dan platform organik, dalam kategori dan negara yang dipilih, berdasarkan estimasi jumlah unit yang terjual.

previousRank

string (int64 format)

Peringkat popularitas dalam minggu atau bulan sebelumnya.

relativeDemand

enum (RelativeDemandEnum)

Estimasi permintaan dalam kaitannya dengan merek berperingkat popularitas tertinggi dalam kategori dan negara yang sama.

previousRelativeDemand

enum (RelativeDemandEnum)

Estimasi permintaan dalam kaitannya dengan merek berperingkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Perubahan estimasi permintaan. Apakah naik, turun, atau tetap datar.

CompetitiveVisibilityCompetitorView

Kolom tersedia untuk kueri di tabel competitiveVisibilityCompetitorView.

Laporan Visibilitas kompetitif dengan bisnis yang memiliki visibilitas serupa.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

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

object (Date)

Tanggal baris ini.

Kondisi pada date diperlukan dalam klausa WHERE.

domain

string

Domain pesaing atau domain Anda, jika 'isYourDomain' bernilai benar.

Wajib ada dalam klausa SELECT. Tidak dapat difilter dalam klausa 'WHERE'.

isYourDomain

boolean

Benar jika baris ini berisi data untuk domain Anda.

Tidak dapat difilter dalam klausa 'WHERE'.

reportCountryCode

string

Negara tempat tayangan muncul.

Wajib dalam klausa SELECT. Kondisi pada reportCountryCode diperlukan dalam klausa WHERE.

reportCategoryId

string (int64 format)

ID kategori produk Google untuk menghitung laporan, yang diwakili dalam taksonomi produk Google.

Wajib ada dalam klausa SELECT. Kondisi pada reportCategoryId diperlukan dalam klausa WHERE.

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib ada dalam klausa SELECT.

rank

string (int64 format)

Posisi domain dalam peringkat bisnis serupa untuk kunci yang dipilih (date, reportCategoryId, reportCountryCode, trafficSource) berdasarkan tayangan. 1 adalah yang tertinggi.

Tidak dapat difilter pada klausa 'WHERE'.

adsOrganicRatio

number

Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka dibulatkan dan dikelompokkan.

Tidak dapat difilter dalam klausa 'WHERE'.

pageOverlapRate

number

Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama.

Tidak dapat difilter dalam klausa 'WHERE'.

higherPositionRate

number

Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman dibandingkan dengan penawaran Anda.

Tidak dapat difilter dalam klausa 'WHERE'.

relativeVisibility

number

Visibilitas relatif menunjukkan seberapa sering penawaran pesaing Anda ditampilkan dibandingkan dengan penawaran Anda. Dengan kata lain, visibilitas relatif adalah jumlah tayangan yang ditampilkan dari retailer pesaing dibagi dengan jumlah tayangan Anda yang ditampilkan selama rentang waktu yang dipilih untuk kategori produk dan negara yang dipilih.

Tidak dapat difilter dalam klausa 'WHERE'.

TrafficSourceEnum

Nilai sumber traffic.

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Tidak ditentukan.
ORGANIC Traffic organik.
ADS Traffic dari iklan.
ALL Traffic organik dan iklan.

CompetitiveVisibilityTopMerchantView

Kolom yang tersedia untuk kueri di tabel competitiveVisibilityTopMerchantView.

Laporan Visibilitas kompetitif dengan bisnis yang memiliki visibilitas tertinggi.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

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

object (Date)

Tanggal baris ini.

Tidak dapat dipilih di klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.

domain

string

Domain pesaing atau domain Anda, jika 'isYourDomain' bernilai benar.

Wajib ada dalam klausa SELECT. Tidak dapat difilter dalam klausa 'WHERE'.

isYourDomain

boolean

Benar jika baris ini berisi data untuk domain Anda.

Tidak dapat difilter dalam klausa 'WHERE'.

reportCountryCode

string

Negara tempat tayangan muncul.

Wajib ada dalam klausa SELECT. Kondisi pada reportCountryCode diperlukan dalam klausa WHERE.

reportCategoryId

string (int64 format)

ID kategori produk Google untuk menghitung laporan, yang diwakili dalam taksonomi produk Google.

Wajib dalam klausa SELECT. Kondisi pada reportCategoryId diperlukan dalam klausa WHERE.

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib ada dalam klausa SELECT.

rank

string (int64 format)

Posisi domain dalam peringkat penjual teratas untuk kunci yang dipilih (date, reportCategoryId, reportCountryCode, trafficSource) berdasarkan tayangan. 1 adalah yang tertinggi.

Tidak dapat difilter pada klausa 'WHERE'.

adsOrganicRatio

number

Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka dibulatkan dan dikelompokkan.

Tidak dapat difilter dalam klausa 'WHERE'.

pageOverlapRate

number

Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama.

Tidak dapat difilter dalam klausa 'WHERE'.

higherPositionRate

number

Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman dibandingkan dengan penawaran Anda.

Tidak dapat difilter pada klausa 'WHERE'.

CompetitiveVisibilityBenchmarkView

Kolom yang tersedia untuk kueri di tabel competitiveVisibilityBenchmarkView.

Laporan Visibilitas kompetitif dengan tolok ukur kategori.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Representasi JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Kolom
date

object (Date)

Tanggal baris ini.

Wajib dalam klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.

reportCountryCode

string

Negara tempat tayangan muncul.

Wajib ada dalam klausa SELECT. Kondisi pada reportCountryCode diperlukan dalam klausa WHERE.

reportCategoryId

string (int64 format)

ID kategori produk Google untuk menghitung laporan, yang diwakili dalam taksonomi produk Google.

Wajib dalam klausa SELECT. Kondisi pada reportCategoryId diperlukan dalam klausa WHERE.

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib ada dalam klausa SELECT.

yourDomainVisibilityTrend

number

Perubahan visibilitas berdasarkan tayangan untuk domain Anda sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan non-nol).

Tidak dapat difilter dalam klausa 'WHERE'.

categoryBenchmarkVisibilityTrend

number

Perubahan visibilitas berdasarkan tayangan sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan iklan selain nol) untuk sekumpulan penjual dengan visibilitas tertinggi yang mendekati pasar.

Tidak dapat difilter dalam klausa 'WHERE'.