ภาพรวม

เราอยากแนะนำรุ่นเบต้าของ Merchant API ซึ่งเป็นเวอร์ชันใหม่ของ Content API for Shopping และอนาคต

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

Reporting API

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

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

ผู้ใช้ 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 ธันวาคม 2020 และ 21 ธันวาคม 2020

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

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

การค้นหากลุ่ม

นอกจากเมตริกแล้ว คุณยังสามารถค้นหากลุ่ม ซึ่งอาจเป็นแอตทริบิวต์ของ ผลิตภัณฑ์ (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"
      }
    }
]}

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