Performance reports

Merchant API มีรายงานประสิทธิภาพ เช่น product_performance_view หน้านี้จะอธิบายโครงสร้างของรายงานประสิทธิภาพ

เมตริก

คุณค้นหาเมตริก (เช่น clicks และ impressions) ที่ต้องการให้แสดงผลได้ คุณต้องเพิ่มตัวกรองในช่วงวันที่เพื่อค้นหาข้อมูลประสิทธิภาพในบริการรายงาน

ต่อไปนี้คือตัวอย่างคําค้นหาที่แสดงผลแถวเดียวพร้อมจํานวนคลิกทั้งหมด ภายในช่วงวันที่ที่ระบุ

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

คุณต้องระบุข้อมูลที่ต้องการให้แสดง ไวลด์การ์ด (เช่น SELECT *) จะแสดงผลข้อผิดพลาด

คำตอบตัวอย่างต่อไปนี้แสดงให้เห็นว่าผู้ขายมียอดคลิกรวม 4,440 ครั้งในผลิตภัณฑ์ทั้งหมดและวิธีการทางการตลาดทั้งหมดระหว่างวันที่ 1 ธันวาคม 2023 ถึงวันที่ 21 ธันวาคม 2023 

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

กลุ่ม

คุณใช้ฟิลด์กลุ่มเพื่อ การแบ่งกลุ่มในรายงาน ประสิทธิภาพได้ ตัวอย่างเช่น การค้นหา marketing_method จะแสดงรายงานที่มีแถวสำหรับ แต่ละวิธีทางการตลาด และเมตริกที่คุณ ระบุสําหรับวิธีทางการตลาดนั้นในอนุประโยค SELECT

ฟิลด์กลุ่มอาจเป็นแอตทริบิวต์ผลิตภัณฑ์ (เช่น offer_id, brand และ category) หรือแอตทริบิวต์เหตุการณ์ (เช่น date และ marketing_method)

ฟิลด์กลุ่มจะทําหน้าที่คล้ายกับ GROUP BY ใน SQL ฟิลด์กลุ่มจะแยกเมตริกที่เลือก โดยจัดกลุ่มตามแต่ละกลุ่มในSELECT

นี่คือตัวอย่างการค้นหาที่แสดงผลการคลิกต่อวันตามลำดับจากมากไปน้อยโดยclicksภายในเงื่อนไขช่วงวันที่ที่เพิ่ม ระบบจะแสดงเฉพาะแถวที่มีเมตริกที่ขออย่างน้อย 1 รายการซึ่งไม่ใช่ 0

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

การตอบกลับตัวอย่างต่อไปนี้แสดงให้เห็นว่าผู้ขายมียอดคลิก 1,546 ครั้งใน ผลิตภัณฑ์ทั้งหมดในวิธีทางการตลาดทั้งหมดในวันที่ 1 ธันวาคม 2023 และมียอดคลิก 829 ครั้งใน ผลิตภัณฑ์ทั้งหมดในวิธีทางการตลาดทั้งหมดในวันที่ 2 ธันวาคม 2023 ผู้ขายไม่มีการคลิกในวันที่ 3 ธันวาคม 2023 จึงไม่มีการแสดงผลใดๆ สำหรับวันที่ดังกล่าว 

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

เช่นเดียวกับรายงานที่กำหนดเองใน Merchant Center คุณสามารถระบุกลุ่มหลายกลุ่ม ในคำค้นหาเดียวกันด้วย Merchant Reports API

นี่คือตัวอย่างการค้นหาที่แสดงผลการคลิกสำหรับผลิตภัณฑ์ทั้งหมดในบัญชี ในช่วง 30 วัน โดยแบ่งกลุ่มตาม marketing_method และ offer_id

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

คำตอบจากคำค้นหานี้จะมีแถวสำหรับแต่ละชุดค่าผสมของ offer_id และ marketing_method พร้อมจำนวนคลิกสำหรับชุดค่าผสมนั้น

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

หมวดหมู่และประเภทผลิตภัณฑ์

ภาษาการค้นหา Merchant Center รองรับการแบ่งกลุ่ม เมตริกตามแอตทริบิวต์ 2 กลุ่มที่คุณกำหนดเพื่อจัดระเบียบ สินค้าคงคลังได้ ดังนี้

ระดับหมวดหมู่
หมวดหมู่จากการจัดหมวดหมู่ผลิตภัณฑ์ของ Google Google อาจ กำหนดหมวดหมู่ให้กับผลิตภัณฑ์โดยอัตโนมัติหากไม่มีการระบุหมวดหมู่ หรือ ปรับแต่งหมวดหมู่ที่ระบุเพิ่มเติม
ระดับประเภทผลิตภัณฑ์
ประเภทผลิตภัณฑ์ที่คุณกำหนดตาม การจัดหมวดหมู่ ซึ่งต่างจาก ระดับหมวดหมู่ที่ไม่มีชุดค่าที่รองรับซึ่งกำหนดไว้ล่วงหน้า

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

ตัวอย่างเช่น ลองพิจารณาผลิตภัณฑ์ที่มีระดับประเภทผลิตภัณฑ์ต่อไปนี้

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

รายงานจะแสดงแต่ละระดับในฟิลด์ของตัวเอง

กลุ่ม ค่า
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

เมตริกสกุลเงินและราคา

เมตริกราคา เช่น conversion_value จะแสดงโดยใช้ Price ประเภท หากเมตริกมีให้บริการในหลายสกุลเงิน ระบบจะแสดงค่าของแต่ละสกุลเงินในแถวแยกกัน ตัวอย่างเช่น คำค้นหาต่อไปนี้

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

จะแสดงผลลัพธ์ต่อไปนี้

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

หากคุณขอทั้งเมตริกราคาและเมตริกที่ไม่ใช่ราคาในการค้นหา ระบบจะแสดงเมตริกราคาในแถวผลลัพธ์แยกต่างหากจากเมตริกที่ไม่ใช่ราคา โดยมีแถวผลลัพธ์ 1 แถวต่อรหัสสกุลเงิน ตัวอย่างเช่น คำค้นหาต่อไปนี้

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

จะแสดงการตอบกลับต่อไปนี้

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

ระบบจะแสดงช่องทั้งหมดที่คุณเลือกในการตอบกลับ แม้ว่าค่าของช่องจะยังคงเป็นค่าเริ่มต้นหรือ 0 ก็ตาม

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ใช้ได้สำหรับการค้นหาได้ที่ฟิลด์ในตาราง productPerformanceView