Merchant API menawarkan laporan performa, misalnya
ProductPerformanceView
.
Halaman ini menjelaskan struktur laporan performa.
Metrik
Anda dapat membuat kueri untuk metrik (misalnya, clicks
dan impressions
) yang ingin ditampilkan. Anda harus menambahkan filter pada rentang tanggal untuk membuat kueri
data performa ke layanan Laporan.
Berikut contoh kueri yang menampilkan satu baris, dengan jumlah total klik dalam rentang tanggal yang ditentukan:
SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'
Anda harus menentukan data yang ingin ditampilkan. Karakter pengganti (misalnya, SELECT
*
) menampilkan error.
Contoh respons berikut menunjukkan bahwa penjual telah mendapatkan total 4.440 klik, di semua produk, di semua metode pemasaran, antara 1 Desember 2020 dan 21 Desember 2020.
{
"results": [
{
"productPerformanceView": {
"clicks": "4,440"
}
}
]
}
Segmen
Anda dapat menggunakan MCQL untuk membuat kueri kolom segmen. Kolom segmen dapat berupa atribut produk (misalnya, offerId
, brand
, dan category
) atau atribut peristiwa (misalnya date
dan marketingMethod
).
Kolom segmen berfungsi mirip dengan GROUP BY
di SQL. Kolom segmen membagi metrik yang dipilih, dengan mengelompokkan berdasarkan setiap segmen dalam klausa SELECT
.
Berikut ini contoh kueri yang menampilkan klik per hari, dalam urutan menurun menurut clicks
, dalam kondisi tambahan untuk rentang tanggal. Hanya baris yang setidaknya
satu metrik yang diminta bukan nol yang ditampilkan.
SELECT
date,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC
Contoh respons berikut menunjukkan bahwa penjual memiliki 1.546 klik di semua produk, di semua metode pemasaran, pada 1 Desember 2020, dan 829 klik di semua produk, di semua metode pemasaran, pada 2 Desember 2020. Penjual tidak memiliki klik pada 3 Desember 2020, sehingga tidak ada yang ditampilkan untuk tanggal tersebut.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}