Mengevaluasi produk Anda

Anda dapat menggunakan Merchant Reports API untuk melihat data performa, memfilter produk menurut atribut tertentu, dan meningkatkan kualitas harga.

Mengukur performa

Anda dapat mengambil metrik performa untuk akun Anda dengan Merchant Reports API product_performance_view.

Persyaratan

Untuk mengambil laporan ini, Anda harus memiliki peran Performa dan insight.

Untuk menetapkan peran Performa dan insight kepada pengguna yang sudah ada, buat permintaan patch dan tetapkan hak akses PERFORMANCE_REPORTING kepada pengguna. Permintaan berikut menunjukkan cara membuat permintaan patch untuk menetapkan hak akses PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Ganti kode berikut:

  • {ACCOUNT_ID}: ID unik akun Merchant Center.
  • {EMAIL_ID}: Alamat email pengguna yang ingin Anda beri peran.

Contoh kueri

Kueri berikut mengambil impressions, clicks, dan click_through_rate untuk semua produk di akun Anda selama periode 30 hari tertentu. Untuk membuat permintaan, teruskan pernyataan Merchant Center Query Language berikut ke metode accounts.reports.search:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Untuk mengetahui informasi selengkapnya tentang laporan performa, lihat panduan Laporan performa.

Filter produk

Anda dapat menggunakan Merchant Reports API product_view untuk menampilkan tampilan data produk yang difilter, termasuk status produk. Misalnya, Anda dapat membuat kueri product_view untuk mencantumkan produk yang memiliki masalah, atau untuk mendapatkan daftar produk baru dan memverifikasi penayangan.

Anda harus menyertakan kolom id dalam klausa SELECT kueri Anda. id memiliki nilai yang sama dengan REST ID produk.

Anda dapat memfilter berdasarkan semua kolom yang tersedia, kecuali item_issues. Anda dapat mengurutkan respons berdasarkan semua kolom yang tersedia, kecuali kolom berikut:

  • gtin
  • item_issues

Berikut adalah contoh yang menampilkan produk Anda dengan status NOT_ELIGIBLE_OR_DISAPPROVED. Untuk membuat permintaan, teruskan pernyataan Merchant Center Query Language berikut ke metode accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Berikut adalah contoh respons dari kueri sebelumnya:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

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

Meningkatkan kualitas harga

Anda dapat menggunakan tampilan analisis harga untuk melihat harga promo yang disarankan untuk produk Anda, dan prediksi performa yang dapat diharapkan jika Anda memperbarui harga produk. Menggunakan laporan analisis harga dapat membantu Anda menetapkan harga produk secara lebih efektif.

Untuk mengetahui informasi selengkapnya, lihat Meningkatkan harga produk dengan laporan analisis harga.

Kueri price_insights_product_view untuk melihat harga promo yang disarankan untuk produk Anda.

Berikut contoh yang dapat Anda gunakan untuk melihat harga promo yang disarankan untuk produk Anda. Untuk membuat permintaan, teruskan pernyataan Bahasa Kueri Merchant Center berikut ke metode accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view

Berikut adalah contoh respons dari kueri sebelumnya:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "en~US~12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "price" {
          "amountMicros": "124990000",
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "135680000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "price" {
          "amountMicros": "119990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "125440000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "price" {
          "amountMicros": "84990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "82000000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}

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