Mengevaluasi produk Anda

Anda dapat menggunakan Merchant Reports API untuk melihat data performa, memfilter produk berdasarkan atribut tertentu, dan memperbaiki harga.

Mengukur performa

Anda dapat menggunakan Merchant Reports API ProductPerformanceView untuk mengambil metrik performa untuk akun Anda.

Persyaratan

Anda memerlukan peran Performa dan insight untuk mengambil laporan ini.

Untuk memberikan peran Performa dan analisis ke akun, gunakan metode accounts.update Content API for Shopping untuk menetapkan kolom reportsManager ke true.

accounts.update menggantikan seluruh resource Account. Gunakan accounts.get untuk mendapatkan resource Account yang lengkap, lalu berikan semua kolom dalam permintaan accounts.update agar Anda tidak kehilangan informasi.

Contoh kueri

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

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Anda juga dapat menyegmentasikan metrik dalam kueri untuk mendapatkan laporan performa yang lebih terperinci.

Filter produk

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

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

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

• gtin
• itemIssues

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

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = '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 ProductView 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, 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.

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

Berikut adalah 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,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

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