Mengevaluasi produk Anda

Anda dapat menggunakan Merchant Reports API untuk melihat data performa, memfilter produk menurut atribut tertentu, dan meningkatkan 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 memberi akun peran performa dan insight, patch resource User untuk akun dengan hak akses PERFORMANCE_REPORTING. Untuk melakukannya, ganti seluruh resource User dengan accounts.v1beta.accounts.users.patch.

Untuk menghindari kehilangan informasi, panggil accounts.v1beta.accounts.users.get untuk mendapatkan resource User lengkap, lalu berikan semua kolom dalam permintaan accounts.v1beta.accounts.users.patch Anda.

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 informasi selengkapnya tentang laporan performa, lihat panduan Laporan performa.

Filter produk

Anda dapat menggunakan product_view Merchant Reports API 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 ID REST 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": "online~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 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.

Buat kueri price_insights_product_view untuk melihat saran harga promo produk Anda.

Berikut adalah contoh yang dapat Anda gunakan untuk melihat saran harga promo untuk produk Anda. Untuk membuat permintaan, teruskan pernyataan Merchant Center Query Language 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": "online~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": "online~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": "online~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.