Performance reports

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

เมตริก

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

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

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": "4440"
      }
    }
  ]
}

กลุ่ม

คุณสามารถใช้ ช่องกลุ่ม สำหรับการแบ่งกลุ่มในรายงานประสิทธิภาพ ตัวอย่างเช่น การค้นหา 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 Query Language รองรับการแบ่งกลุ่ม เมตริกตามแอตทริบิวต์ 2 กลุ่มที่คุณกำหนดขึ้นเพื่อจัดระเบียบ คลังโฆษณาได้

ระดับหมวดหมู่

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

ระดับประเภทสินค้า

ประเภทผลิตภัณฑ์ที่คุณกำหนดตามการจัดหมวดหมู่

ซึ่งแตกต่างจากระดับหมวดหมู่ตรงที่ไม่มีชุดค่าที่รองรับซึ่งกำหนดไว้ล่วงหน้า

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

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

Home & Garden > Kitchen & Dining > Kitchen Appliances > 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