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-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 Reports API เช่นเดียวกับรายงานที่กำหนดเองใน Merchant Center

ต่อไปนี้คือตัวอย่างการค้นหาที่แสดงจำนวนคลิกของผลิตภัณฑ์ทั้งหมดในบัญชีของคุณในช่วง 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 ก็ตาม