Reporting API

Reporting API ช่วยให้ผู้ขายโต้ตอบกับข้อมูลประสิทธิภาพได้ แบบเป็นโปรแกรมผ่านภาษาการค้นหาของ Merchant Center ซึ่งคล้ายกับความสามารถในการสร้างรายงานที่กำหนดเองใน Merchant Center โดยตรง Reporting API มีประโยชน์ดังนี้

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

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

• เมตริกที่จะแสดงผล (เช่น การคลิก การแสดงผล)
• มิติข้อมูลที่จะใช้แบ่งกลุ่มข้อมูล (เช่น OfferId, Date)
• เงื่อนไขที่ต้องเป็นไปตาม (เช่น การคลิก > 100)

ภาษาการค้นหาของ Reporting API สามารถค้นหา Content API for Shopping เพื่อหา เมตริกประสิทธิภาพ (การคลิก การแสดงผล) ซึ่งอาจแบ่งกลุ่มตาม มิติข้อมูลต่างๆ (แอตทริบิวต์เหตุการณ์ที่รายงาน เช่น โปรแกรมและวันที่ รวมถึงแอตทริบิวต์ผลิตภัณฑ์ เช่น แบรนด์ หมวดหมู่ ฯลฯ) โดยใช้เมธอด Search ในบริการ Reports

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

ค้นหาเมตริก

คุณสามารถค้นหาเมตริก (การคลิก การแสดงผล CTR ฯลฯ) ที่ต้องการ ให้แสดง คุณต้องเพิ่มตัวกรองในช่วงวันที่เพื่อค้นหาบริการรายงาน การค้นหาตัวอย่างด้านล่างจะแสดงผลแถวเดียว ซึ่งคือจำนวนรวม ของการคลิกภายในเงื่อนไขช่วงวันที่ที่เพิ่ม

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

ตัวอย่างการตอบกลับ

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

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

ค้นหากลุ่ม

นอกจากเมตริกแล้ว คุณยังค้นหาส่วนได้ด้วย ซึ่งอาจเป็นแอตทริบิวต์ของ ผลิตภัณฑ์ (offer_id, brand, category ฯลฯ) หรือแอตทริบิวต์ของเหตุการณ์ที่รายงาน (date, program) เหตุการณ์ที่รายงานคือการแสดงผลหรือคลิกสำหรับ ผลิตภัณฑ์

กลุ่มทํางานคล้ายกับ GROUP BY ใน SQL กลุ่มจะแยกเมตริกที่เลือก โดยจัดกลุ่มตามแต่ละกลุ่มในSELECT clause การค้นหาตัวอย่างด้านล่าง จะแสดงผลการคลิกต่อวัน โดยจัดเรียงตามการคลิกจากมากไปน้อยภายในเงื่อนไขที่เพิ่ม ของช่วงวันที่ ระบบจะแสดงเฉพาะแถวที่มีเมตริกที่ขออย่างน้อย 1 รายการที่ไม่ใช่ 0

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

ตัวอย่างการตอบกลับ

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

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}