Method: accounts.reports.search

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

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 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 5000 dikonversi menjadi 5000.

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 ini:

  • 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 (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 dalam tabel productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Kolom yang tersedia untuk kueri dalam tabel nonProductPerformanceView.

productView

object (ProductView)

Kolom yang tersedia untuk kueri dalam tabel productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Kolom yang tersedia untuk kueri dalam tabel priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Kolom yang tersedia untuk kueri dalam tabel priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Kolom yang tersedia untuk kueri dalam tabel bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Kolom yang tersedia untuk kueri dalam tabel bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Kolom yang tersedia untuk kueri dalam tabel competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Kolom yang tersedia untuk kueri dalam tabel competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Kolom yang tersedia untuk kueri dalam tabel competitiveVisibilityBenchmarkView.

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

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 (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 diterapkan. Segmen.

Kondisi pada date diperlukan dalam klausa WHERE.

week

object (Date)

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

conversionValue

object (Price)

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

Hanya tersedia untuk sumber traffic FREE.

marketingMethod

enum (MarketingMethodEnum)

Metode pemasaran yang menerapkan metrik. Segmen.

customerCountryCode

string

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

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

offerId

string

ID produk yang disediakan penjual. Segmen.

title

string

Judul produk. Segmen.

brand

string

Merek produk. Segmen.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Jenis produk (tingkat 1) di taksonomi produk milik penjual. Segmen.

productTypeL2

string

Tipe produk (tingkat 2) di taksonomi produk milik penjual. Segmen.

productTypeL3

string

Tipe produk (tingkat 3) di taksonomi produk milik penjual. Segmen.

productTypeL4

string

Tipe produk (tingkat 4) di taksonomi produk milik penjual. Segmen.

productTypeL5

string

Tipe produk (tingkat 5) di taksonomi produk milik penjual. Segmen.

customLabel0

string

Label khusus 0 untuk pengelompokan produk secara khusus. Segmen.

customLabel1

string

Label khusus 1 untuk pengelompokan produk secara khusus. Segmen.

customLabel2

string

Label khusus 2 untuk pengelompokan produk secara khusus. Segmen.

customLabel3

string

Label khusus 3 untuk pengelompokan produk secara khusus. Segmen.

customLabel4

string

Label khusus 4 untuk pengelompokan produk secara khusus. 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, 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 FREE.

conversionRate

number

Jumlah konversi dibagi jumlah klik, yang dilaporkan pada tanggal tayangan iklan. 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 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 (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Kolom
date

object (Date)

Tanggal dalam zona waktu penjual tempat metrik diterapkan. Segmen.

Kondisi pada date diperlukan dalam klausa WHERE.

week

object (Date)

Hari pertama (Senin) tanggal metrik dalam 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 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 (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)

Estimasi potensi performa dibandingkan dengan produk penjual dengan performa tertinggi.

id

string

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

Wajib 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 disediakan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (tingkat 1) dalam taksonomi produk Google.

categoryL2

string

Kategori produk (tingkat 2) dalam taksonomi produk Google.

categoryL3

string

Kategori produk (tingkat 3) dalam 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) di taksonomi produk milik penjual.

productTypeL2

string

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

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 paket yang dinormalkan 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 contoh cara penghitungan status gabungan:

Listingan gratis Iklan Shopping Status
Approved Approved VALID
Approved Tertunda VALID
Approved 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 (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 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)

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 (ReportingContextEnum)
}
Kolom
disapprovedCountries[]

string

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

demotedCountries[]

string

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

reportingContext

enum (ReportingContextEnum)

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

Tolok ukur harga terbaru yang tersedia untuk katalog produk di negara tolok ukur.

reportCountryCode

string

Negara tolok ukur harga. Diwakili dalam format ISO 3166.

Wajib dalam klausa SELECT.

id

string

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

Wajib dalam klausa SELECT.

offerId

string

ID produk yang disediakan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (tingkat 1) dalam taksonomi produk Google.

categoryL2

string

Kategori produk (tingkat 2) dalam taksonomi produk Google.

categoryL3

string

Kategori produk (tingkat 3) dalam 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) di taksonomi produk milik penjual.

productTypeL2

string

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

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.

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 (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 dalam klausa SELECT.

offerId

string

ID produk yang disediakan penjual.

title

string

Judul produk.

brand

string

Merek produk.

categoryL1

string

Kategori produk (tingkat 1) dalam taksonomi produk Google.

categoryL2

string

Kategori produk (tingkat 2) dalam taksonomi produk Google.

categoryL3

string

Kategori produk (tingkat 3) dalam 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) di taksonomi produk milik penjual.

productTypeL2

string

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

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.

predictedImpressionsChangeFraction

number

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

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 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 (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 yang berikut:

  • Hari pertama minggu ini (Senin) untuk laporan mingguan,
  • Hari pertama setiap bulan untuk laporan bulanan.

Wajib dalam klausa SELECT. Jika kondisi WHERE di 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. Pemberian peringkat dapat dilakukan dalam jangka waktu seminggu atau sebulan.

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

reportCountryCode

string

Negara tempat peringkat dihitung. Diwakili dalam format ISO 3166.

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

reportCategoryId

string (int64 format)

ID kategori produk Google yang akan dihitung peringkatnya, yang direpresentasikan dalam taksonomi produk Google.

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

title

string

Judul cluster produk.

brand

string

Merek cluster produk.

categoryL1

string

Kategori produk (tingkat 1) dari cluster produk, yang direpresentasikan 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 (tingkat 5) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.

inventoryStatus

enum (InventoryStatus)

Apakah cluster produk IN_STOCK di sumber data produk Anda di minimal 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 ditampilkan dalam nilai 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 Google Ads 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 klaster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama.

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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 yang tersedia untuk kueri dalam 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 yang berikut:

  • Hari pertama minggu ini (Senin) untuk laporan mingguan,
  • Hari pertama setiap bulan untuk laporan bulanan.

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

reportGranularity

enum (ReportGranularityEnum)

Perincian laporan. Pemberian peringkat dapat dilakukan dalam jangka waktu seminggu atau sebulan.

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

reportCountryCode

string

Negara tempat peringkat dihitung. Diwakili dalam format ISO 3166.

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

reportCategoryId

string (int64 format)

ID kategori produk Google yang akan dihitung peringkatnya, yang direpresentasikan dalam taksonomi produk Google.

Wajib 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 yang memiliki peringkat popularitas tertinggi dalam kategori dan negara yang sama.

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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 (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 wajib ada dalam klausa WHERE.

domain

string

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

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

isYourDomain

boolean

True jika baris ini berisi data untuk domain Anda.

Tidak dapat difilter pada klausa 'WHERE'.

reportCountryCode

string

Negara tempat tayangan muncul.

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

reportCategoryId

string (int64 format)

ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google.

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

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib 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 pada 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 pada klausa 'WHERE'.

higherPositionRate

number

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

Tidak dapat difilter pada klausa 'WHERE'.

relativeVisibility

number

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 pada 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 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 (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 wajib ada dalam klausa WHERE.

domain

string

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

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

isYourDomain

boolean

True jika baris ini berisi data untuk domain Anda.

Tidak dapat difilter pada klausa 'WHERE'.

reportCountryCode

string

Negara tempat tayangan muncul.

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

reportCategoryId

string (int64 format)

ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google.

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

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib dalam klausa SELECT.

rank

string (int64 format)

Posisi domain pada 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 pada 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 pada klausa 'WHERE'.

higherPositionRate

number

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

Tidak dapat difilter pada klausa '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 (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 wajib ada dalam klausa WHERE.

reportCountryCode

string

Negara tempat tayangan muncul.

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

reportCategoryId

string (int64 format)

ID kategori produk Google yang akan dihitung laporannya, yang direpresentasikan dalam taksonomi produk Google.

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

trafficSource

enum (TrafficSourceEnum)

Sumber traffic tayangan.

Wajib dalam klausa SELECT.

yourDomainVisibilityTrend

number

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

Tidak dapat difilter pada 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 pada klausa 'WHERE'.