Ringkasan

Reporting API

Reporting API memungkinkan penjual berinteraksi dengan data performa mereka secara terprogram melalui Bahasa Kueri Merchant Center. Hal ini serupa 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 sistem pelaporan internal atau pihak ketiga mereka.
• Memungkinkan pengguna, partner pihak ketiga, dan agregator yang mengelola akun Merchant Center Pelaporan akses akun tengah.

Pengguna API dapat menetapkan data kinerja mana yang ingin mereka ambil di Telusuri respons panggilan, seperti:

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

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

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

Kueri untuk metrik

Anda dapat mengajukan kueri untuk metrik (Klik, Tayangan, CTR, dll.) yang Anda inginkan dikembalikan. Anda harus menambahkan filter pada rentang tanggal untuk mengkueri Laporan layanan. Contoh kueri di bawah ini mengembalikan satu baris: jumlah agregat klik dalam kondisi tambahan 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 telah mendapatkan 4.440 klik dijumlahkan menjadi satu dari seluruh produk mereka di semua tujuan di antara 1 Desember 2020 dan 21 Desember 2020.

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

Kueri untuk segmen

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

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

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 telah mendapatkan 1.546 klik di semua produk mereka di semua tujuan mereka pada 1 Desember 2020 dan 829 klik di semua produk mereka di semua tujuan mereka di 2 Desember 2020. Tidak ada objek yang akan dikembalikan untuk tanggal 3 Desember 2020 karena penjual tidak mendapatkan 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"
      }
    }
]}