- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ReportRow
- ProductPerformanceView
- MarketingMethodEnum
- NonProductPerformanceView
- ProductView
- AggregatedReportingContextStatus
- ItemIssue
- ItemIssueType
- ItemIssueSeverity
- IssueSeverityPerReportingContext
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
- PriceInsightsProductView
- Efektivitas
- BestSellersProductClusterView
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
- CompetitiveVisibilityCompetitorView
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
- CompetitiveVisibilityBenchmarkView
- Cobalah!
Mengambil laporan yang ditentukan oleh kueri penelusuran. Respons mungkin berisi lebih sedikit baris dari 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 |
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 |
Wajib. Kueri yang menentukan laporan yang akan diambil. Untuk detail tentang cara membuat kueri, lihat panduan Bahasa Kueri. Untuk mengetahui daftar lengkap tabel dan kolom yang tersedia, lihat Kolom yang tersedia. |
pageSize |
Opsional. Jumlah |
pageToken |
Opsional. Token halaman yang akan diambil. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan. Untuk meminta halaman hasil berikutnya, nilai yang diperoleh dari |
Isi respons
Pesan respons untuk metode ReportService.Search
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"results": [
{
object ( |
Kolom | |
---|---|
results[] |
Baris yang cocok dengan kueri penelusuran. |
nextPageToken |
Token yang dapat dikirim sebagai |
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 akan diisi dalam respons. Dalam pesan yang terisi, hanya kolom yang diminta secara eksplisit dalam kueri yang diisi.
Representasi JSON |
---|
{ "productPerformanceView": { object ( |
Kolom | |
---|---|
productPerformanceView |
Kolom yang tersedia untuk kueri dalam tabel |
nonProductPerformanceView |
Kolom yang tersedia untuk kueri dalam tabel |
productView |
Kolom yang tersedia untuk kueri dalam tabel |
priceCompetitivenessProductView |
Kolom yang tersedia untuk kueri dalam tabel |
priceInsightsProductView |
Kolom yang tersedia untuk kueri dalam tabel |
bestSellersProductClusterView |
Kolom yang tersedia untuk kueri dalam tabel |
bestSellersBrandView |
Kolom yang tersedia untuk kueri dalam tabel |
competitiveVisibilityCompetitorView |
Kolom yang tersedia untuk kueri dalam tabel |
competitiveVisibilityTopMerchantView |
Kolom yang tersedia untuk kueri dalam tabel |
competitiveVisibilityBenchmarkView |
Kolom yang tersedia untuk kueri dalam tabel |
ProductPerformanceView
Kolom yang tersedia untuk kueri dalam 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.
Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih setidaknya satu kolom metrik.
Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.
Representasi JSON |
---|
{ "date": { object ( |
Kolom | |
---|---|
date |
Tanggal dalam zona waktu penjual tempat metrik diterapkan. Segmen. Kondisi pada |
week |
Hari pertama (Senin) tanggal metrik dalam zona waktu penjual. Segmen. |
conversionValue |
Nilai konversi yang diatribusikan ke produk, dilaporkan pada tanggal konversi. Metrik. Hanya tersedia untuk sumber traffic |
marketingMethod |
Metode pemasaran yang menerapkan metrik. Segmen. |
customerCountryCode |
Kode negara tempat pelanggan berada pada saat peristiwa. Diwakili dalam format ISO 3166. Segmen. Jika negara pelanggan tidak dapat ditentukan, pesan 'ZZ' khusus kode yang ditampilkan. |
offerId |
ID produk yang disediakan penjual. Segmen. |
title |
Judul produk. Segmen. |
brand |
Merek produk. Segmen. |
categoryL1 |
Kategori produk (tingkat 1) dalam taksonomi produk Google. Segmen. |
categoryL2 |
Kategori produk (tingkat 2) dalam taksonomi produk Google. Segmen. |
categoryL3 |
Kategori produk (tingkat 3) dalam taksonomi produk Google. Segmen. |
categoryL4 |
Kategori produk (tingkat 4) dalam taksonomi produk Google. Segmen. |
categoryL5 |
Kategori produk (tingkat 5) dalam taksonomi produk Google. Segmen. |
productTypeL1 |
Jenis produk (tingkat 1) di taksonomi produk milik penjual. Segmen. |
productTypeL2 |
Tipe produk (tingkat 2) di taksonomi produk milik penjual. Segmen. |
productTypeL3 |
Tipe produk (tingkat 3) di taksonomi produk milik penjual. Segmen. |
productTypeL4 |
Tipe produk (tingkat 4) di taksonomi produk milik penjual. Segmen. |
productTypeL5 |
Tipe produk (tingkat 5) di taksonomi produk milik penjual. Segmen. |
customLabel0 |
Label khusus 0 untuk pengelompokan produk secara khusus. Segmen. |
customLabel1 |
Label khusus 1 untuk pengelompokan produk secara khusus. Segmen. |
customLabel2 |
Label khusus 2 untuk pengelompokan produk secara khusus. Segmen. |
customLabel3 |
Label khusus 3 untuk pengelompokan produk secara khusus. Segmen. |
customLabel4 |
Label khusus 4 untuk pengelompokan produk secara khusus. Segmen. |
clicks |
Jumlah klik. Metrik. |
impressions |
Frekuensi produk penjual ditampilkan. Metrik. |
clickThroughRate |
Rasio klik-tayang - jumlah klik yang diterima produk penjual (klik) dibagi dengan frekuensi produk ditampilkan (tayangan). Metrik. |
conversions |
Jumlah konversi yang diatribusikan ke produk, dilaporkan pada tanggal konversi. Bergantung pada model atribusi, konversi mungkin didistribusikan ke beberapa klik, yang mana setiap klik mendapatkan kredit yang ditetapkan sendiri. Metrik ini adalah jumlah dari semua kredit tersebut. Metrik. Hanya tersedia untuk sumber traffic |
conversionRate |
Jumlah konversi dibagi jumlah klik, yang dilaporkan pada tanggal tayangan iklan. Metrik. Hanya tersedia untuk sumber traffic |
MarketingMethodEnum
Nilai metode pemasaran.
Enum | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
Tidak ditentukan. |
ORGANIC |
Pemasaran organik. |
ADS |
Pemasaran berbasis iklan. |
NonProductPerformanceView
Kolom yang tersedia untuk kueri dalam 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 sesuai dengan segmentasi metrik performa (misalnya, date
).
Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih setidaknya satu kolom metrik.
Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.
Representasi JSON |
---|
{ "date": { object ( |
Kolom | |
---|---|
date |
Tanggal dalam zona waktu penjual tempat metrik diterapkan. Segmen. Kondisi pada |
week |
Hari pertama (Senin) tanggal metrik dalam zona waktu penjual. Segmen. |
clicks |
Jumlah klik pada gambar dan link toko online yang mengarah ke halaman non-produk Anda. Metrik. |
impressions |
Frekuensi gambar dan link toko online yang mengarah ke halaman non-produk Anda ditampilkan. Metrik. |
clickThroughRate |
Rasio klik-tayang - jumlah klik ( |
ProductView
Kolom yang tersedia untuk kueri dalam tabel productView
.
Produk dalam inventaris saat ini. Produk dalam tabel ini sama seperti 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 untuk memfilter daftar produk yang ditampilkan berdasarkan atribut produk. Untuk mengambil satu produk paling lambat 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 ( |
Kolom | |
---|---|
price |
Harga produk. Tidak ada jika informasi tentang harga produk tidak tersedia. |
gtin[] |
Daftar Nomor Barang Perdagangan Global (GTIN) produk. |
creationTime |
Waktu penjual membuat produk dalam detik stempel waktu. |
expirationDate |
Tanggal habis masa berlaku untuk produk, yang ditentukan saat penyisipan. |
itemIssues[] |
Daftar masalah item untuk produk. Kolom ini tidak dapat digunakan untuk mengurutkan hasil. Hanya atribut yang dipilih dari kolom ini (misalnya, |
clickPotential |
Estimasi potensi performa dibandingkan dengan produk penjual dengan performa tertinggi. |
id |
ID REST produk, dalam bentuk Wajib dalam klausa |
channel |
Saluran produk. Dapat berupa |
languageCode |
Kode bahasa produk dalam format BCP 47. |
feedLabel |
Label feed produk. |
offerId |
ID produk yang disediakan penjual. |
title |
Judul produk. |
brand |
Merek produk. |
categoryL1 |
Kategori produk (tingkat 1) dalam taksonomi produk Google. |
categoryL2 |
Kategori produk (tingkat 2) dalam taksonomi produk Google. |
categoryL3 |
Kategori produk (tingkat 3) dalam taksonomi produk Google. |
categoryL4 |
Kategori produk (tingkat 4) dalam taksonomi produk Google. |
categoryL5 |
Kategori produk (tingkat 5) dalam taksonomi produk Google. |
productTypeL1 |
Jenis produk (tingkat 1) di taksonomi produk milik penjual. |
productTypeL2 |
Jenis produk (tingkat 2) di taksonomi produk milik penjual. |
productTypeL3 |
Jenis produk (tingkat 3) di taksonomi produk milik penjual. |
productTypeL4 |
Jenis produk (tingkat 4) di taksonomi produk milik penjual. |
productTypeL5 |
Jenis produk (tingkat 5) di taksonomi produk milik penjual. |
condition |
Kondisi produk. |
availability |
Ketersediaan produk. |
shippingLabel |
Label paket yang dinormalkan di sumber data. |
itemGroupId |
ID kelompok item yang diberikan oleh penjual untuk mengelompokkan varian. |
thumbnailLink |
Link ke gambar produk yang diproses, yang dihosting di infrastruktur Google. |
aggregatedReportingContextStatus |
Status gabungan. |
clickPotentialRank |
Peringkat produk berdasarkan potensi kliknya. Produk dengan |
AggregatedReportingContextStatus
Status produk yang digabungkan untuk semua konteks pelaporan.
Berikut 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 valid 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 ( |
Kolom | |
---|---|
type |
Jenis masalah item. |
severity |
Tingkat keparahan masalah item. |
resolution |
Penyelesaian masalah item. |
ItemIssueType
Jenis masalah.
Representasi JSON |
---|
{ "code": string, "canonicalAttribute": string } |
Kolom | |
---|---|
code |
Kode error masalah, setara dengan |
canonicalAttribute |
Nama atribut kanonis untuk masalah khusus atribut. |
ItemIssueSeverity
Bagaimana masalah tersebut memengaruhi penayangan produk.
Representasi JSON |
---|
{ "severityPerReportingContext": [ { object ( |
Kolom | |
---|---|
severityPerReportingContext[] |
Tingkat keparahan masalah sesuai konteks pelaporan. |
aggregatedSeverity |
Gabungan tingkat keparahan masalah 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 ( |
Kolom | |
---|---|
disapprovedCountries[] |
Daftar negara yang tidak disetujui dalam konteks pelaporan, yang direpresentasikan dalam format ISO 3166. |
demotedCountries[] |
Daftar negara yang didemosikan dalam konteks pelaporan, direpresentasikan dalam format ISO 3166. |
reportingContext |
Konteks pelaporan yang berlaku untuk masalah tersebut. |
AggregatedIssueSeverity
Gabungan tingkat keparahan masalah untuk semua konteks pelaporan.
Enum | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED |
Tidak ditentukan. |
DISAPPROVED |
Masalah menolak produk setidaknya dalam satu konteks pelaporan. |
DEMOTED |
Masalah mendemosikan produk di semua konteks pelaporan yang terpengaruh. |
PENDING |
Penyelesaian masalah adalah PENDING_PROCESSING . |
ItemIssueResolution
Cara mengatasi 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. Tidak ada tindakan yang perlu dilakukan penjual sekarang. Penyelesaian dapat menyebabkan masalah lain (misalnya, jika crawling gagal). |
ClickPotential
Potensi klik produk memperkirakan potensi performanya dibandingkan dengan produk penjual yang memiliki performa 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 |
Prediksi dampak klik yang tidak diketahui. |
LOW |
Berpotensi menerima jumlah klik yang rendah dibandingkan dengan produk penjual yang memiliki performa tertinggi. |
MEDIUM |
Berpotensi menerima jumlah klik 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 dalam tabel priceCompetitivenessProductView
.
Laporan Daya saing harga.
Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.
Representasi JSON |
---|
{ "price": { object ( |
Kolom | |
---|---|
price |
Harga produk saat ini. |
benchmarkPrice |
Tolok ukur harga terbaru yang tersedia untuk katalog produk di negara tolok ukur. |
reportCountryCode |
Negara tolok ukur harga. Diwakili dalam format ISO 3166. Wajib dalam klausa |
id |
ID REST produk, dalam bentuk Wajib dalam klausa |
offerId |
ID produk yang disediakan penjual. |
title |
Judul produk. |
brand |
Merek produk. |
categoryL1 |
Kategori produk (tingkat 1) dalam taksonomi produk Google. |
categoryL2 |
Kategori produk (tingkat 2) dalam taksonomi produk Google. |
categoryL3 |
Kategori produk (tingkat 3) dalam taksonomi produk Google. |
categoryL4 |
Kategori produk (tingkat 4) dalam taksonomi produk Google. |
categoryL5 |
Kategori produk (tingkat 5) dalam taksonomi produk Google. |
productTypeL1 |
Jenis produk (tingkat 1) di taksonomi produk milik penjual. |
productTypeL2 |
Jenis produk (tingkat 2) di taksonomi produk milik penjual. |
productTypeL3 |
Jenis produk (tingkat 3) di taksonomi produk milik penjual. |
productTypeL4 |
Jenis produk (tingkat 4) di taksonomi produk milik penjual. |
productTypeL5 |
Jenis produk (tingkat 5) di taksonomi produk milik penjual. |
PriceInsightsProductView
Kolom yang tersedia untuk kueri dalam tabel priceInsightsProductView
.
Laporan Analisis harga.
Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.
Representasi JSON |
---|
{ "price": { object ( |
Kolom | |
---|---|
price |
Harga produk saat ini. |
suggestedPrice |
Harga terbaru yang disarankan untuk produk. |
effectiveness |
Prediksi efektivitas penerapan saran harga, dikelompokkan. |
id |
ID REST produk, dalam bentuk Wajib dalam klausa |
offerId |
ID produk yang disediakan penjual. |
title |
Judul produk. |
brand |
Merek produk. |
categoryL1 |
Kategori produk (tingkat 1) dalam taksonomi produk Google. |
categoryL2 |
Kategori produk (tingkat 2) dalam taksonomi produk Google. |
categoryL3 |
Kategori produk (tingkat 3) dalam taksonomi produk Google. |
categoryL4 |
Kategori produk (tingkat 4) dalam taksonomi produk Google. |
categoryL5 |
Kategori produk (tingkat 5) dalam taksonomi produk Google. |
productTypeL1 |
Jenis produk (tingkat 1) di taksonomi produk milik penjual. |
productTypeL2 |
Jenis produk (tingkat 2) di taksonomi produk milik penjual. |
productTypeL3 |
Jenis produk (tingkat 3) di taksonomi produk milik penjual. |
productTypeL4 |
Jenis produk (tingkat 4) di taksonomi produk milik penjual. |
productTypeL5 |
Jenis produk (tingkat 5) di taksonomi produk milik penjual. |
predictedImpressionsChangeFraction |
Prediksi perubahan dalam tayangan sebagai pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan tayangan sebesar 5%. |
predictedClicksChangeFraction |
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 |
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 dalam tabel bestSellersProductClusterView
.
Laporan Item 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 ( |
Kolom | |
---|---|
reportDate |
Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari yang berikut:
Wajib dalam klausa |
variantGtins[] |
GTIN contoh varian cluster produk. |
reportGranularity |
Perincian laporan. Pemberian peringkat dapat dilakukan dalam jangka waktu seminggu atau sebulan. Wajib dalam klausa |
reportCountryCode |
Negara tempat peringkat dihitung. Diwakili dalam format ISO 3166. Wajib dalam klausa |
reportCategoryId |
ID kategori produk Google yang akan dihitung peringkatnya, yang direpresentasikan dalam taksonomi produk Google. Wajib dalam klausa |
title |
Judul cluster produk. |
brand |
Merek cluster produk. |
categoryL1 |
Kategori produk (tingkat 1) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google. |
categoryL2 |
Kategori produk (tingkat 2) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google. |
categoryL3 |
Kategori produk (tingkat 3) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google. |
categoryL4 |
Kategori produk (tingkat 4) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google. |
categoryL5 |
Kategori produk (tingkat 5) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google. |
inventoryStatus |
Apakah cluster produk Kolom ini tidak mempertimbangkan filter negara laporan Terlaris. |
brandInventoryStatus |
Apakah minimal ada satu produk dari merek yang saat ini Kolom ini tidak mempertimbangkan filter negara laporan Terlaris. |
rank |
Popularitas cluster produk di Google Ads dan platform organik, dalam kategori dan negara yang dipilih, berdasarkan estimasi jumlah unit yang terjual. |
previousRank |
Peringkat popularitas dalam minggu atau bulan sebelumnya. |
relativeDemand |
Estimasi permintaan dalam kaitannya dengan klaster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama. |
previousRelativeDemand |
Estimasi permintaan dalam kaitannya dengan klaster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya. |
relativeDemandChange |
Perubahan estimasi permintaan. Entah itu naik, tenggelam, atau tetap datar. |
ReportGranularityEnum
Nilai perincian laporan.
Enum | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED |
Tidak ditentukan. |
WEEKLY |
Laporan dikomputasi selama jangka waktu seminggu. |
MONTHLY |
Laporan dikomputasi selama jangka waktu sebulan. |
InventoryStatus
Status cluster produk atau merek di inventaris Anda.
Enum | |
---|---|
INVENTORY_STATUS_UNSPECIFIED |
Tidak ditentukan. |
IN_STOCK |
Anda memiliki stok produk untuk cluster produk atau merek ini. |
OUT_OF_STOCK |
Anda memiliki produk untuk cluster produk atau merek ini dalam inventaris, tetapi stoknya saat ini habis. |
NOT_IN_INVENTORY |
Anda tidak memiliki produk untuk cluster produk atau merek ini dalam inventaris. |
RelativeDemandEnum
Nilai permintaan relatif.
Enum | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED |
Tidak ditentukan. |
VERY_LOW |
Permintaannya adalah 0-5% dari permintaan cluster produk atau merek terpopuler. |
LOW |
Permintaannya adalah 6-10% dari permintaan cluster produk atau merek terpopuler. |
MEDIUM |
Permintaannya adalah 11-20% dari permintaan cluster produk atau merek terpopuler. |
HIGH |
Permintaannya adalah 21-50% dari permintaan cluster produk atau merek terpopuler. |
VERY_HIGH |
Permintaannya adalah 51-100% dari permintaan cluster produk atau merek terpopuler. |
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 daripada jangka waktu sebelumnya. |
BestSellersBrandView
Kolom 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 ( |
Kolom | |
---|---|
reportDate |
Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari yang berikut:
Wajib dalam klausa |
reportGranularity |
Perincian laporan. Pemberian peringkat dapat dilakukan dalam jangka waktu seminggu atau sebulan. Wajib dalam klausa |
reportCountryCode |
Negara tempat peringkat dihitung. Diwakili dalam format ISO 3166. Wajib dalam klausa |
reportCategoryId |
ID kategori produk Google yang akan dihitung peringkatnya, yang direpresentasikan dalam taksonomi produk Google. Wajib dalam klausa |
brand |
Nama brand. |
rank |
Popularitas merek di Iklan dan platform organik, dalam kategori dan negara yang dipilih, berdasarkan estimasi jumlah unit yang terjual. |
previousRank |
Peringkat popularitas dalam minggu atau bulan sebelumnya. |
relativeDemand |
Estimasi permintaan dalam kaitannya dengan merek yang memiliki peringkat popularitas tertinggi dalam kategori dan negara yang sama. |
previousRelativeDemand |
Estimasi permintaan dalam kaitannya dengan merek yang memiliki peringkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya. |
relativeDemandChange |
Perubahan estimasi permintaan. Entah itu naik, tenggelam, atau tetap datar. |
CompetitiveVisibilityCompetitorView
Kolom yang tersedia untuk kueri dalam 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 ( |
Kolom | |
---|---|
date |
Tanggal baris ini. Kondisi pada |
domain |
Domain pesaing atau domain Anda, jika 'isYourDomain' benar. Wajib dalam klausa |
isYourDomain |
True jika baris ini berisi data untuk domain Anda. Tidak dapat difilter di 'WHERE' . |
reportCountryCode |
Negara tempat tayangan muncul. Wajib dalam klausa |
reportCategoryId |
ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google. Wajib dalam klausa |
trafficSource |
Sumber traffic tayangan. Wajib dalam klausa |
rank |
Posisi domain dalam peringkat bisnis serupa untuk kunci yang dipilih ( Tidak dapat difilter di 'WHERE' . |
adsOrganicRatio |
Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka dibulatkan dan dikelompokkan. Tidak dapat difilter di 'WHERE' . |
pageOverlapRate |
Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama. Tidak dapat difilter di 'WHERE' . |
higherPositionRate |
Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman daripada penawaran Anda. Tidak dapat difilter di 'WHERE' . |
relativeVisibility |
Visibilitas relatif menunjukkan seberapa sering penawaran pesaing Anda ditampilkan dibandingkan dengan penawaran Anda. Dengan kata lain, ini 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 di '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 dalam 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 ( |
Kolom | |
---|---|
date |
Tanggal baris ini. Tidak dapat dipilih di klausa |
domain |
Domain pesaing atau domain Anda, jika 'isYourDomain' benar. Wajib dalam klausa |
isYourDomain |
True jika baris ini berisi data untuk domain Anda. Tidak dapat difilter di 'WHERE' . |
reportCountryCode |
Negara tempat tayangan muncul. Wajib dalam klausa |
reportCategoryId |
ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google. Wajib dalam klausa |
trafficSource |
Sumber traffic tayangan. Wajib dalam klausa |
rank |
Posisi domain pada peringkat penjual teratas untuk kunci yang dipilih ( Tidak dapat difilter di 'WHERE' . |
adsOrganicRatio |
Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka dibulatkan dan dikelompokkan. Tidak dapat difilter di 'WHERE' . |
pageOverlapRate |
Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama. Tidak dapat difilter di 'WHERE' . |
higherPositionRate |
Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman daripada penawaran Anda. Tidak dapat difilter di 'WHERE' . |
CompetitiveVisibilityBenchmarkView
Kolom yang tersedia untuk kueri dalam 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 ( |
Kolom | |
---|---|
date |
Tanggal baris ini. Wajib dalam klausa |
reportCountryCode |
Negara tempat tayangan muncul. Wajib dalam klausa |
reportCategoryId |
ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google. Wajib dalam klausa |
trafficSource |
Sumber traffic tayangan. Wajib dalam klausa |
yourDomainVisibilityTrend |
Perubahan visibilitas berdasarkan tayangan untuk domain Anda sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan bukan nol). Tidak dapat difilter di 'WHERE' . |
categoryBenchmarkVisibilityTrend |
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 di 'WHERE' . |