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 menggunakan Merchant Reports API product_performance_view untuk mengambil metrik performa untuk akun Anda.

Persyaratan

Anda memerlukan Peran performa dan insight untuk mengambil laporan ini.

Untuk memberi akun peran performa dan insight, patch resource User untuk akun dengan hak akses PERFORMANCE_REPORTING.

accounts.v1beta.accounts.users.patch menggantikan seluruh resource User. Untuk menghindari hilangnya 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'

Lihat panduan Laporan performa untuk mengetahui informasi selengkapnya tentang 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 ProductView
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"
          }
        ]
      }
    }
  ]
}

Lihat referensi product_view untuk mengetahui informasi selengkapnya tentang kolom dan perilaku tertentu.

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.

Lihat Meningkatkan harga produk dengan laporan analisis harga untuk mengetahui informasi selengkapnya.

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"
      }
    }
  ]
}