ภาพรวม

Reporting API

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

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

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

• เมตริกที่จะแสดง (เช่น การคลิก การแสดงผล)
• มิติข้อมูลที่จะแบ่งกลุ่มข้อมูล (เช่น OfferId, วันที่)
• เงื่อนไขที่ต้องปฏิบัติตาม (เช่น จำนวนคลิก > 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';

ประเด็นสำคัญ: คุณต้องระบุข้อมูลที่ต้องการให้แสดงอย่างชัดเจน ไวลด์การ์ดทั้งหมด (เช่น Select metrics.*) จะแสดงข้อผิดพลาด

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

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

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

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

การค้นหาสำหรับกลุ่ม

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

กลุ่มจะทํางานคล้ายกับ GROUP BY ใน SQL กลุ่มจะแยกเมตริกที่เลือก โดยจัดกลุ่มตามแต่ละส่วนในอนุประโยค SELECT ข้อความค้นหาตัวอย่างด้านล่างจะแสดงจำนวนคลิกต่อวัน โดยเรียงลำดับตามการคลิกจากมากไปหาน้อยภายในเงื่อนไขที่เพิ่มของช่วงวันที่ ระบบจะแสดงเฉพาะแถวที่มีเมตริกที่ขออย่างน้อย 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"
      }
    }
]}

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