Anda dapat menggunakan Merchant Reports API untuk melihat data performa, memfilter produk berdasarkan 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 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 Bahasa Kueri Merchant Center 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
product_view
Merchant Reports API untuk menampilkan tampilan filter dari data produk Anda, termasuk status produk. Misalnya, Anda dapat membuat kueri product_view untuk mencantumkan produk yang bermasalah, 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 kolom berikut:
status_per_reporting_contextitem_issues
Anda dapat mengurutkan respons berdasarkan semua kolom yang tersedia, kecuali:
gtinstatus_per_reporting_contextitem_issues
Anda dapat memeriksa kolom aggregated_reporting_context_status untuk memahami
kelayakan produk secara keseluruhan. Kolom ini menggabungkan status di semua konteks pelaporan produk.
Berikut adalah contoh yang menampilkan produk Anda dengan status gabungan
ELIGIBLE_LIMITED, yang berarti produk tersebut memenuhi syarat untuk ditayangkan di setidaknya satu, tetapi tidak
semua, konteks pelaporan yang ditargetkan. Anda dapat meminta status produk mendetail per konteks pelaporan dan masalah produk untuk menyelidiki lebih lanjut. 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,
status_per_reporting_context,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'
Berikut adalah contoh respons dari kueri sebelumnya:
{
"results": [
{
"productView": {
"id": "en~US~id0",
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
"statusPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"approvedCountries": [
"US"
]
}
]
"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"
}
]
}
}
]
}
Anda dapat menggunakan filter pada reporting_context dalam klausa WHERE untuk melihat detail produk untuk konteks pelaporan tertentu. Saat Anda memfilter menurut
reporting_context, aggregated_reporting_context_status dihitung hanya berdasarkan
konteks pelaporan yang dipilih, dan status_per_reporting_context serta
item_issues hanya menampilkan detail untuk konteks tersebut.
Untuk mengetahui informasi selengkapnya tentang kolom yang tersedia untuk kueri, lihat
Kolom dalam tabel product_view.
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 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,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversions_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.