Ringkasan

Reporting API

Reporting API memungkinkan penjual berinteraksi dengan data performa mereka secara terprogram melalui Merchant Center Query Language. Hal ini mirip dengan kemampuan untuk membuat laporan kustom langsung di Merchant Center. Reporting API memiliki manfaat berikut:

  • Memungkinkan penjual besar mengimpor data performa untuk listingan produk ke dalam sistem pelaporan internal atau pihak ketiga mereka.
  • Memungkinkan pengguna, partner pihak ketiga, dan agregator yang mengelola akun Merchant Center mengakses pelaporan.

Pengguna API dapat menentukan data performa yang ingin diambil dalam respons panggilan Penelusuran, seperti:

  • Metrik yang akan ditampilkan (misalnya: Klik, Tayangan)
  • Dimensi untuk menyegmentasikan data (misalnya: OfferId, Date)
  • Kondisi yang perlu dipenuhi (misalnya: Klik > 100)

Bahasa kueri Reporting API dapat mengkueri Content API for Shopping untuk metrik performa (klik, tayangan), yang mungkin disegmentasikan menurut berbagai dimensi (atribut peristiwa yang dilaporkan seperti program dan tanggal, serta atribut produk seperti merek, kategori, dll.), menggunakan metode Search di layanan Reports.

Hasil dari kueri ke layanan Reports adalah daftar instance ReportRow, dengan setiap ReportRow mewakili nilai metrik yang diminta untuk segmen yang Anda tentukan dalam kueri. Jika tidak ada segmen yang ditentukan, satu baris akan ditampilkan dengan metrik yang digabungkan di semua segmen. Jika tidak, jika segmen apa pun diminta bersama metrik, respons akan menampilkan satu baris untuk setiap tuple segmen unik. Anda dapat memilih beberapa segmen dan beberapa metrik dalam satu kueri.

Membuat kueri untuk metrik

Anda dapat membuat kueri untuk metrik (Klik, Tayangan, CTR, dll.) yang ingin ditampilkan. Anda harus menambahkan filter pada rentang tanggal untuk membuat kueri layanan Laporan. Contoh kueri di bawah menampilkan satu baris: jumlah klik agregat dalam kondisi yang ditambahkan dari rentang tanggal.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

Contoh respons

Contoh respons kode JSON di bawah menunjukkan bahwa penjual ini memiliki 4.440 klik yang dijumlahkan di semua produknya di semua tujuannya antara 1 Desember 2020 dan 21 Desember 2020.

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

Membuat kueri untuk segmen

Bersama dengan metrik, Anda juga dapat membuat kueri untuk segmen, yang dapat berupa atribut produk (offer_id, brand, category, dll.) atau atribut peristiwa yang dilaporkan (date, program). Peristiwa yang dilaporkan adalah tayangan atau klik untuk produk.

Segmen berfungsi mirip dengan GROUP BY di SQL. Segmen membagi metrik yang dipilih, yang dikelompokkan menurut setiap segmen dalam klausa SELECT. Contoh kueri di bawah ini menampilkan klik per hari, yang diurutkan berdasarkan klik menurun dalam kondisi yang ditambahkan dari rentang tanggal. Hanya baris yang setidaknya memiliki satu metrik yang diminta yang bukan nol yang akan ditampilkan.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

Contoh respons

Contoh respons kode JSON di bawah menunjukkan bahwa penjual ini memiliki 1.546 klik di semua produknya di semua tujuan pada 1 Desember 2020 dan 829 klik di semua produknya di semua tujuan pada 2 Desember 2020. Tidak ada objek yang akan ditampilkan untuk 3 Desember 2020 karena penjual tidak memiliki klik pada hari tersebut.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}
Berikutnya
Tata bahasa kueri