Performance reports

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

Metrik

Anda dapat membuat kueri untuk metrik (misalnya, clicks dan impressions) yang ingin Anda tampilkan. Anda harus menambahkan filter pada rentang tanggal untuk membuat kueri layanan Laporan terkait data performa.

Berikut adalah contoh kueri yang menampilkan satu baris, dengan total jumlah klik dalam rentang tanggal yang ditentukan:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Anda harus menentukan data yang ingin ditampilkan. Karakter pengganti (misalnya, SELECT *) akan menampilkan error.

Contoh respons berikut menunjukkan bahwa penjual telah memperoleh total 4.440 klik di semua produk, di semua metode pemasaran, antara 1 Desember 2023 dan 21 Desember 2023.

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

Poin Penting: Jika Anda tidak memilih kolom segmen apa pun dalam kueri, Anda hanya akan menerima satu baris metrik.

Segmen

Anda dapat menggunakan kolom segmen untuk segmentasi dalam laporan performa. Misalnya, membuat kueri untuk marketing_method akan menampilkan laporan dengan baris untuk setiap metode pemasaran, dan metrik yang Anda tentukan untuk metode pemasaran tersebut dalam klausa SELECT.

Kolom segmen dapat berupa atribut produk (misalnya, offer_id, brand, dan category) atau atribut peristiwa (misalnya, date dan marketing_method).

Kolom segmen berfungsi mirip dengan GROUP BY di SQL. Kolom segmen membagi metrik yang dipilih, mengelompokkan menurut setiap segmen dalam klausa SELECT.

Berikut adalah contoh kueri yang menampilkan klik per hari, dalam urutan menurun menurut clicks, dalam kondisi rentang tanggal yang ditambahkan. Hanya baris yang setidaknya satu metrik yang diminta bernilai bukan nol yang ditampilkan.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

Contoh respons berikut menunjukkan bahwa penjual memperoleh 1.546 klik di semua produk, di semua metode pemasaran, pada 1 Desember 2023, dan 829 klik di semua produk, di semua metode pemasaran, pada 2 Desember 2023. Penjual tidak memiliki klik pada 3 Desember 2023, sehingga tidak ada yang ditampilkan untuk tanggal tersebut.

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

Poin Penting: Anda hanya dapat memilih kolom segmen tertentu jika Anda juga memilih metrik. Jika Anda tidak memilih metrik apa pun dalam kueri, Merchant Reports API akan menampilkan error.

Seperti laporan kustom di Merchant Center, Anda dapat menentukan beberapa segmen dalam kueri yang sama dengan Merchant Reports API.

Berikut contoh kueri yang menampilkan klik untuk semua produk di akun Anda selama periode 30 hari, yang disegmentasikan menurut marketing_method dan offer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

Respons dari kueri ini menyertakan baris untuk setiap kombinasi offer_id dan marketing_method, dengan jumlah klik untuk kombinasi tersebut:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Perhatian: Karena baris baru ditampilkan untuk setiap kombinasi kolom segmen dalam klausa SELECT, jumlah total baris dalam respons Anda akan meningkat secara eksponensial dengan setiap kolom segmen tambahan.

Kategori dan tipe produk

Bahasa Kueri Merchant Center mendukung segmentasi metrik menurut dua grup atribut yang dapat Anda tentukan untuk mengatur inventaris:

Tingkat kategori

Kategori dari taksonomi produk Google. Google dapat menetapkan kategori secara otomatis ke produk Anda jika tidak ada kategori yang diberikan, atau lebih menyempurnakan kategori yang diberikan.

Tingkat jenis produk

Jenis produk yang Anda tetapkan berdasarkan kategorisasi Anda. Tidak seperti tingkat kategori, tidak ada kumpulan nilai yang didukung dan telah ditetapkan sebelumnya.

Atribut kategori dan tipe produk disusun dalam hierarki dengan beberapa tingkat. Spesifikasi produk memisahkan setiap tingkat dengan karakter >, tetapi Anda memilih setiap tingkat hierarki secara terpisah dalam laporan.

Misalnya, pertimbangkan produk dengan tingkat jenis produk berikut:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Laporan menampilkan setiap tingkat di kolomnya sendiri:

Segmen	Nilai
product_type_l1	Home & Garden
product_type_l2	Kitchen & Dining
product_type_l3	Kitchen Appliances
product_type_l4	Refrigerators

Metrik mata uang dan harga

Metrik harga, seperti conversion_value, ditampilkan menggunakan jenis Price. Jika metrik tersedia dalam beberapa mata uang, nilai untuk setiap mata uang ditampilkan dalam baris terpisah. Misalnya, kueri berikut:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

menampilkan hasil berikut:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Jika Anda meminta metrik harga dan non-harga dalam kueri, metrik harga akan ditampilkan dalam baris hasil terpisah dari metrik non-harga, satu baris hasil per kode mata uang. Misalnya, kueri berikut:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

akan menampilkan respons berikut:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Semua kolom yang Anda pilih akan ditampilkan dalam respons, meskipun nilainya masih nilai default atau nol.

Untuk mengetahui informasi selengkapnya tentang kolom yang tersedia untuk kueri, lihat Kolom dalam tabel productPerformanceView.