คุณสามารถใช้ Merchant Reports API เพื่อดูข้อมูลประสิทธิภาพ กรองผลิตภัณฑ์ตามแอตทริบิวต์ที่เฉพาะเจาะจง และปรับปรุงราคา
วัดประสิทธิภาพ
คุณสามารถดึงข้อมูลเมตริกประสิทธิภาพสำหรับบัญชีได้ด้วย Merchant Reports API product_performance_view
ข้อกำหนด
หากต้องการเรียกดูรายงานนี้ คุณจะต้องมีบทบาทประสิทธิภาพและข้อมูลเชิงลึก
หากต้องการมอบหมายบทบาทประสิทธิภาพและข้อมูลเชิงลึกให้กับผู้ใช้ที่มีอยู่ ให้สร้างคำขอแพตช์และมอบหมายสิทธิ์การเข้าถึง PERFORMANCE_REPORTING ให้กับผู้ใช้ คำขอต่อไปนี้แสดงวิธีสร้างคำขอแพตช์สำหรับการกำหนดสิทธิ์เข้าถึง PERFORMANCE_REPORTING
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}
{
"accessRights": [
"PERFORMANCE_REPORTING"
]
}
แทนที่ค่าต่อไปนี้
- {ACCOUNT_ID}: ตัวระบุที่ไม่ซ้ำกันของบัญชี Merchant Center
- {EMAIL_ID}: อีเมลของผู้ใช้ที่คุณต้องการมอบหมายบทบาทให้
ตัวอย่างการค้นหา
การค้นหาต่อไปนี้จะดึงข้อมูล impressions, clicks และ click_through_rate สำหรับสินค้าทั้งหมดในบัญชีของคุณในช่วงระยะเวลา 30 วันที่เฉพาะเจาะจง หากต้องการส่งคำขอ ให้ส่งคำสั่ง Merchant Center Query Language ต่อไปนี้ไปยังเมธอด accounts.reports.search
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานประสิทธิภาพได้ในคู่มือรายงานประสิทธิภาพ
กรองผลิตภัณฑ์
คุณสามารถใช้ product_view ของ Merchant Reports API เพื่อแสดงมุมมองตัวกรองของข้อมูลผลิตภัณฑ์ รวมถึงสถานะผลิตภัณฑ์ ตัวอย่างเช่น คุณสามารถค้นหา product_view เพื่อแสดงรายการผลิตภัณฑ์ที่มีปัญหา หรือเพื่อดูรายการผลิตภัณฑ์ใหม่และยืนยันการแสดงผล
คุณต้องใส่ช่อง id ในส่วนคำสั่ง SELECT ของคำค้นหา id มีค่าเดียวกับ REST ID ของสินค้า
คุณกรองตามช่องที่ใช้ได้ทั้งหมดได้ ยกเว้นช่องต่อไปนี้
status_per_reporting_contextitem_issues
คุณจัดเรียงการตอบกลับตามฟิลด์ที่มีอยู่ทั้งหมดได้ ยกเว้นฟิลด์ต่อไปนี้
gtinstatus_per_reporting_contextitem_issues
คุณสามารถตรวจสอบช่อง aggregated_reporting_context_status เพื่อทำความเข้าใจการมีสิทธิ์โดยรวมของผลิตภัณฑ์ ช่องนี้จะรวบรวมสถานะในบริบทการรายงานทั้งหมดของผลิตภัณฑ์
ต่อไปนี้คือตัวอย่างที่แสดงผลผลิตภัณฑ์ที่มีสถานะรวมเป็น ELIGIBLE_LIMITED ซึ่งหมายความว่าผลิตภัณฑ์มีสิทธิ์แสดงในบริบทการรายงานที่กำหนดเป้าหมายอย่างน้อย 1 รายการ แต่ไม่ใช่ทั้งหมด คุณสามารถขอสถานะสินค้าโดยละเอียดตามบริบทการรายงานและปัญหาเกี่ยวกับสินค้าเพื่อตรวจสอบเพิ่มเติมได้ หากต้องการส่งคำขอ ให้ส่งคำสั่ง Merchant Center Query Language ต่อไปนี้ไปยังเมธอด 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'
ตัวอย่างการตอบกลับจากการค้นหาก่อนหน้ามีดังนี้
{
"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"
}
]
}
}
]
}
คุณสามารถใช้ตัวกรองใน reporting_context ในส่วนคำสั่ง WHERE เพื่อดูรายละเอียดสินค้าสำหรับบริบทการรายงานที่เฉพาะเจาะจงได้ เมื่อคุณกรองตาม reporting_context ระบบจะคำนวณ aggregated_reporting_context_status โดยอิงตามบริบทการรายงานที่เลือกเท่านั้น และ status_per_reporting_context และ item_issues จะแสดงรายละเอียดสำหรับบริบทนั้นเท่านั้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องที่ใช้ค้นหาได้ที่ช่องในตาราง product_view
ปรับปรุงการกำหนดราคา
คุณสามารถใช้มุมมองข้อมูลเชิงลึกด้านราคาเพื่อดูราคาลดที่แนะนำสำหรับผลิตภัณฑ์ และการคาดการณ์ประสิทธิภาพที่คุณจะได้รับหากอัปเดตราคาผลิตภัณฑ์ การใช้รายงานข้อมูลเชิงลึกด้านราคาช่วยให้คุณกำหนดราคาผลิตภัณฑ์ได้อย่างมีประสิทธิภาพยิ่งขึ้น
ดูข้อมูลเพิ่มเติมได้ที่ปรับปรุงการกำหนดราคาผลิตภัณฑ์ด้วยรายงานข้อมูลเชิงลึกด้านราคา
ค้นหา
price_insights_product_view
เพื่อดูราคาลดที่แนะนำสำหรับผลิตภัณฑ์
ต่อไปนี้คือตัวอย่างที่คุณใช้ดูราคาลดที่แนะนำสำหรับผลิตภัณฑ์ได้ หากต้องการส่งคำขอ ให้ส่งคำสั่ง Merchant Center Query Language ต่อไปนี้ไปยังเมธอด 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
ตัวอย่างการตอบกลับจากการค้นหาก่อนหน้ามีดังนี้
{
"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"
}
}
]
}
ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องที่ใช้ได้สำหรับการค้นหาได้ที่ช่องในตาราง priceInsightsProductView