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 guna mendapatkan data performa.

Berikut adalah contoh kueri yang menampilkan satu baris, dengan jumlah total 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": "4440"
      }
    }
  ]
}

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, dengan mengelompokkan berdasarkan setiap segmen dalam klausa SELECT.

Berikut adalah contoh kueri yang menampilkan klik per hari, dalam urutan menurun berdasarkan clicks, dalam kondisi rentang tanggal yang ditambahkan. Hanya baris yang setidaknya satu metrik yang diminta 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 memperoleh klik pada 3 Desember 2023, sehingga tidak ada data 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"
      }
    }
  ]
}

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

Berikut adalah 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 mencakup 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"
      }
    }
  ]
}

Kategori dan jenis produk

Merchant Center Query Language 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 menyempurnakan lebih lanjut kategori yang diberikan.

Tingkat jenis produk

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

Atribut kategori dan jenis produk diatur 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:

Metrik mata uang dan harga

Metrik harga, seperti conversion_value, direpresentasikan menggunakan jenis Price. Jika metrik tersedia dalam beberapa mata uang, nilai untuk setiap mata uang akan 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'

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 merupakan nilai default atau nol.

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