Segmentasi

Segmentasi, yang tersedia di laporan kustom Merchant Center, dapat diterapkan di Reporting API dengan menambahkan kolom yang sesuai ke kueri. Misalnya, membuat kueri untuk segments.program menghasilkan laporan dengan baris untuk setiap program (Iklan Shopping, Listingan produk gratis, dll.) yang menyertakan metrik (tayangan, klik, dll.) untuk program tersebut seperti yang ditentukan dalam klausa SELECT.

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

Contoh kueri berikut mengambil klik untuk semua produk di akun Anda selama periode 30 hari, yang dikelompokkan menurut program dan offer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Eksekusi

Klik Run untuk mencoba contoh di API Explorer. Setelah mengklik Jalankan, perbarui placeholder ID penjual ke ID penjual Anda di URL permintaan. Anda dapat mengubah kueri. Kueri lengkap harus tetap berada di satu baris agar dapat digunakan dengan Penjelajah API.

Hasil dari mengirim kueri ini ke reports.search adalah baris yang menentukan klik untuk setiap kombinasi offer_id dan program, seperti dalam contoh string JSON ini:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

Perhatian: Perlu diingat bahwa jumlah baris dapat meningkat secara eksponensial untuk setiap kolom segmen tambahan yang disertakan dalam kueri laporan Anda.

Kategori dan tipe produk

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

Tingkat kategori (segments.category_l1, segments.category_l2, dll.)

Kategori dari taksonomi produk Google. Google mungkin akan otomatis menetapkan kategori ke produk Anda jika tidak ada yang disediakan, atau lebih menyaring kategori yang disediakan.

Tingkat jenis produk (segments.product_type_l1, segments.product_type_l2, dll.)

Tipe produk yang Anda tetapkan berdasarkan kategorisasi Anda. Tidak seperti tingkat kategori, tidak ada kumpulan nilai yang didukung sebelumnya.

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

Misalnya, pertimbangkan produk dengan tingkat tipe produk berikut:

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

Laporan akan menampilkan setiap tingkat di kolomnya sendiri, seperti berikut:

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

Metrik mata uang dan harga

Kolom segments.currency_code di ReportRow menunjukkan mata uang yang digunakan untuk menampilkan metrik harga, seperti metrics.order_item_sales_micros. Karena hal ini penting untuk menafsirkan metrik ini dengan benar, ReportRow yang ditampilkan akan otomatis menyertakan segments.currency_code setiap kali Anda memilih salah satu metrik harga di bawah.

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

Catatan: Anda mungkin tetap perlu menyertakan segments.currency_code secara eksplisit dalam kueri untuk kejelasan dan konsistensi antara klausa SELECT dan setiap ReportRow dalam respons.

Metrik Beli dengan Google

Bahasa Kueri Merchant Center mendukung dua kategori metrik untuk pesanan Beli dengan Google: metrik tingkat item dan metrik tingkat pesanan.

metrik tingkat item

Metrik yang dihitung berdasarkan item dalam pesanan, dan terkait dengan dimensi produk item dalam setiap pesanan.

• metrics.item_days_to_ship
• metrics.item_fill_rate
• metrics.ordered_items
• metrics.ordered_item_sales_micros
• metrics.rejected_items
• metrics.returned_items
• metrics.return_rate
• metrics.returns_micros
• metrics.shipped_items
• metrics.shipped_item_sales_micros
• metrics.unshipped_items

metrik tingkat pesanan

Metrik yang dihitung per pesanan.

• metrics.aos
• metrics.aov_micros
• metrics.days_to_ship
• metrics.orders
• metrics.shipped_orders
• metrics.unshipped_orders

Metrik tingkat pesanan tidak terkait dengan dimensi produk dari item dalam setiap pesanan.

Anda dapat memilih metrik tingkat item yang dikombinasikan dengan segmen yang tersedia. Namun, memilih metrik tingkat pesanan yang dikombinasikan dengan salah satu segmen dimensi produk berikut akan gagal:

• segments.brand
• segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4, segments.category_l5
• segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4, segments.custom_label5
• segments.offer_id
• segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4, segments.product_type_l5
• segments.title

Cari tahu selengkapnya

Untuk mengetahui daftar lengkap segmen, lihat dokumentasi.