Performance reports

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"
      }
    }
  ]
}