ประเมินผลิตภัณฑ์

คุณสามารถใช้ Merchant Reports API เพื่อ ดูข้อมูลประสิทธิภาพ กรองผลิตภัณฑ์ตาม แอตทริบิวต์ที่เฉพาะเจาะจง และ ปรับปรุงการกำหนดราคา

วัดประสิทธิภาพ

คุณสามารถดึงข้อมูล เมตริกประสิทธิภาพ ของบัญชีได้ด้วย Merchant Reports API product_performance_view

ข้อกำหนด

หากต้องการดึงข้อมูลรายงานนี้ คุณจะต้องมีบทบาทผู้ใช้ที่มีสิทธิ์เข้าถึงรายงาน ประสิทธิภาพและข้อมูลเชิงลึก

หากต้องการมอบหมายบทบาทผู้ใช้ที่มีสิทธิ์เข้าถึงรายงานประสิทธิภาพและข้อมูลเชิงลึกให้กับผู้ใช้ที่มีอยู่ ให้สร้างคำขอ Patch และ มอบหมายสิทธิ์เข้าถึง PERFORMANCE_REPORTING ให้กับผู้ใช้ คำขอต่อไปนี้แสดงวิธีสร้างคำขอ Patch เพื่อมอบหมายสิทธิ์เข้าถึง 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'

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานประสิทธิภาพได้ที่ คู่มือรายงานประสิทธิภาพ

กรองผลิตภัณฑ์

คุณสามารถใช้ Merchant Reports API product_view เพื่อแสดงมุมมองที่กรองแล้วของข้อมูลสินค้า ซึ่งรวมถึงสถานะสินค้า ตัวอย่างเช่น คุณสามารถค้นหา product_view เพื่อแสดงรายการผลิตภัณฑ์ที่มีปัญหา หรือเพื่อรับรายการผลิตภัณฑ์ใหม่และยืนยันการแสดง

คุณต้องใส่ฟิลด์ id ในอนุประโยค SELECT ของการค้นหา id มีค่าเดียวกับรหัส REST ของผลิตภัณฑ์

คุณสามารถกรองตามฟิลด์ที่มีทั้งหมด ยกเว้นฟิลด์ต่อไปนี้,

• status_per_reporting_context
• item_issues

คุณสามารถจัดเรียงการตอบกลับตามฟิลด์ที่มีทั้งหมด ยกเว้นฟิลด์ต่อไปนี้

• gtin
• status_per_reporting_context
• item_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_conversion_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