Halaman ini diterjemahkan oleh Cloud Translation API.

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 menetapkan peran Performa dan insight kepada pengguna yang 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 tetapkan 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 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": "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