Performance reports

Merchant API menawarkan laporan performa, misalnya ProductPerformanceView Halaman ini menjelaskan struktur laporan performa.

Metrik

Anda dapat mengajukan kueri untuk metrik (misalnya, clicks dan impressions) yang Anda ingin dikembalikan. Anda harus menambahkan filter pada rentang tanggal untuk mengkueri Laporan untuk data performa.

Berikut ini 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 memiliki total 4.440 klik, di seluruh produk, di seluruh metode pemasaran, antara 1 Desember, 2020 sampai 21 Desember 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segmen

Anda dapat menggunakan MCQL untuk membuat kueri bidang segmen. Bidang segmen dapat atribut produk (misalnya, offerId, brand, dan category) atau peristiwa (misalnya, date dan marketingMethod).

Kolom segmen berfungsi mirip dengan GROUP BY di SQL. Bidang segmen memisahkan metrik yang dipilih, dikelompokkan berdasarkan setiap segmen dalam klausa SELECT.

Berikut ini contoh kueri yang mengembalikan klik per hari, dalam urutan menurun menurut clicks, dalam kondisi tambahan dari rentang tanggal. Hanya baris dengan minimal satu metrik yang diminta bukan nol.

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, dengan semua metode pemasaran, pada 1 Desember 2020, dan 829 klik di seluruh produk, di seluruh metode pemasaran, pada tanggal 2 Desember 2020. Penjual tidak memiliki klik pada tanggal 3 Desember 2020, jadi tidak ada yang dikembalikan untuk tanggal tersebut.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}