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 ditampilkan. Anda harus menambahkan filter pada rentang tanggal untuk membuat kueri layanan Laporan untuk 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 memiliki 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 tidak memilih kolom segmen apa pun dalam kueri, Anda hanya akan menerima satu baris metrik.

Segmen

Anda dapat menggunakan kolom segmen untuk segmentasi di 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, yang dikelompokkan menurut setiap segmen dalam klausa SELECT.

Berikut adalah contoh kueri yang menampilkan klik per hari, dalam urutan menurun menurut clicks, dalam kondisi yang ditambahkan dari rentang tanggal. Hanya baris yang setidaknya memiliki satu metrik yang diminta yang 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 memiliki 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 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 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 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 jenis produk

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

Tingkat kategori

Kategori dari taksonomi produk Google. Google mungkin menetapkan kategori secara otomatis ke produk Anda jika tidak ada yang diberikan, atau meningkatkan kualitas 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 disusun dalam hierarki dengan beberapa tingkat. Spesifikasi produk memisahkan setiap level dengan karakter >, tetapi Anda memilih setiap level 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, 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'

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