เริ่มจากสินค้าเดียว: คู่มือ SKU.md สำหรับร้าน Shopify, SHOPLINE, WooCommerce และ BigCommerce
เรื่องราวเกี่ยวกับ v1.0.0
เปรียบเทียบเงื่อนไขการเผยแพร่ของแต่ละแพลตฟอร์ม และเริ่มโครงการเล็กด้วยการสร้าง ตรวจ และยืนยันไฟล์ SKU.md ของสินค้าเดียว
การเตรียมความรู้สินค้าสำหรับเอเจนต์ช้อปปิ้งไม่ต้องเริ่มจากการสร้างร้านใหม่ ผู้ขาย Shopify, SHOPLINE, WooCommerce และ BigCommerce เริ่มด้วยสินค้าเดียว รวบรวมข้อมูลจริง ตรวจวิธีให้บริการไฟล์ แล้วค่อยตัดสินใจขยายได้
SKU.md v1.0.0 เป็นรูปแบบเปิดที่ตรวจสอบได้ ช่วยเสริมหน้าสินค้า ข้อมูลแบบมีโครงสร้าง และ Feed ของช่องทาง ระบบสต็อก ชำระเงิน และคำสั่งซื้อยังรับผิดชอบธุรกรรมสด แนวทางต่อไปนี้มีไว้ประเมิน ไม่ใช่คำกล่าวว่าทั้งสี่แพลตฟอร์มรองรับ SKU.md โดยตรงแล้ว
ตรวจสิ่งที่ร้านให้บริการได้ก่อน
ความถูกต้องของเนื้อหากับการส่งไฟล์ออนไลน์เป็นคนละงาน ฝ่ายร้านจัดสเปก ตัวเลือก ข้อจำกัด และแหล่งข้อมูล ส่วนผู้พัฒนาหรือผู้ให้บริการตรวจการตอบสนองจริงบนโดเมนร้าน
ตารางอิงเอกสารทางการ แต่ไม่ใช่ใบรับรองร้านใดร้านหนึ่ง ต้องดูโฮสติ้ง สิทธิ์ และผลทดสอบด้วย การอัปโหลดไฟล์ได้อย่างเดียวไม่พอ
| แพลตฟอร์ม | ส่วนที่ควบคุมได้ | เงื่อนไขที่ต้องยืนยัน | จุดตรวจ |
|---|---|---|---|
| Shopify | เนื้อหาธีม หรือเส้นทางของหน้าร้านที่ดูแลเองตามสถาปัตยกรรม | คำนำหน้าจำกัดของ App Proxy ไม่เท่ากับควบคุมรากได้ | URL ตอบ Markdown ไม่ใช่ HTML ธีม |
| SHOPLINE | ข้อมูลสินค้าและการเปลี่ยนเส้นทางที่อนุญาต | การเปลี่ยนเส้นทางไม่พิสูจน์ความสอดคล้อง ต้องยืนยันการส่งจาก origin เดียวกัน | ปลายทาง เนื้อหา และสายการเปลี่ยนเส้นทาง |
| WooCommerce | เส้นทาง WordPress หรือไฟล์สถิตตามสิทธิ์โฮสติ้ง | ต้องสร้างคำตอบที่ถูกต้อง ไม่ใช่เพิ่มกฎ rewrite อย่างเดียว | สถานะ ชนิดเนื้อหา แคช และข้อมูลจริง |
| BigCommerce | เทมเพลต Stencil หรือเส้นทางหน้าร้านที่ดูแลเอง | เทมเพลตหน้าไม่ได้พิสูจน์ว่ารากตอบ Markdown | แยกหน้า HTML ออกจากไฟล์ |
นี่เป็นข้อสรุปเชิงการนำไปใช้จากความสามารถแพลตฟอร์ม หากยังไม่มีทางส่งที่เหมาะ ให้ปรับข้อมูลสินค้าแล้วขอผู้ให้บริการประเมิน ไม่จำเป็นต้องเปลี่ยนแพลตฟอร์มเพียงเพื่อไฟล์เดียว
กติกาการค้นพบปัจจุบัน
ใช้เส้นทาง /sku.md ที่ตรงบนเว็บไซต์เดียวกันเป็นหลัก เฉพาะเมื่อได้ HTTP 404 ที่ชัดเจน ผู้ใช้ข้อมูลจึงตรวจประกาศหนึ่งรายการที่ไม่กำกวมบนหน้าแรกของ origin เดียวกันได้ เช่น
<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">ไฟล์ที่ประกาศต้องตรงข้อกำหนดด้วย รวมถึง HTTPS ที่ origin เดียวกัน และไม่มี query หรือ fragment การหมดเวลา ข้อผิดพลาดเซิร์ฟเวอร์ หรือเอกสารผิดรูปแบบไม่ใช่หลักฐานว่าไฟล์รากไม่มี
นี่เป็นเส้นทางที่มีเงื่อนไข ไม่ใช่เทคนิคที่ใช้ได้กับทุกธีม ต้องควบคุมและตรวจทั้งประกาศกับไฟล์ ลิงก์ดาวน์โหลด CDN หน้าแนะนำ HTML หรือการเปลี่ยนไปคนละ origin ไม่ได้ผ่านโดยอัตโนมัติ
เริ่มจากแคตตาล็อกขั้นต่ำ
นี่คือตัวอย่างร้านสมมติ เปลี่ยนชื่อ คำอธิบาย โดเมน และ URL แคตตาล็อกเป็นข้อมูลจริงก่อนสร้างและตรวจ ไฟล์รากเพียงอย่างเดียวไม่อ้างว่าอธิบายทุกคุณลักษณะของสินค้า
# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.
SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)
## Catalog
- [All products](https://www.example-outdoor.com/collections/all)เอกสารความรู้สินค้าเป็นส่วนที่เลือกเพิ่มได้ เมื่อเพิ่มรายการแรก ให้ลิงก์จากรากอย่างชัดเจน และใส่ลิงก์กลับแคตตาล็อก หน้าสินค้า และที่มาของข้อเท็จจริงแต่ละข้อ ระบุด้วยว่าใช้กับสินค้าทั้งหมดหรือตัวเลือกใด
ทดลองแบบตรวจได้ในห้าขั้นตอน
- เลือกสินค้า ใช้รายการที่มีเอกสารสาธารณะครบและมีคำถามเรื่องสเปกบ่อย ไม่ต้องเริ่มจากเก็บทั้งร้าน
- ตรวจข้อเท็จจริง เทียบตัวตน สเปก ข้อจำกัด และหลักฐานกับหน้าจริง ไม่เดาข้อมูลที่ยังไม่ทราบ
- สร้างและตรวจ ใช้เครื่องมือสร้างทำไฟล์ราก และเครื่องมือปรับปรุงสินค้าทบทวนคุณลักษณะ
- เผยแพร่และยืนยัน ให้ผู้รับผิดชอบร้านส่งไฟล์ แล้วตรวจ URL จริงด้วยตัวตรวจที่อยู่เผยแพร่ ส่วนความสัมพันธ์ระหว่างเอกสารสินค้ากับแคตตาล็อกต้องตรวจแยกต่างหาก
- กำหนดการดูแล ตั้งผู้รับผิดชอบ เก็บหลักฐาน และตรวจใหม่เมื่อสเปก ตัวเลือก หรือแหล่งข้อมูลเปลี่ยน
ตรวจ HTTPS สาธารณะ HTTP 200 เนื้อหา Markdown แบบ UTF-8 และชนิด text/markdown หรือ text/plain ที่อนุญาต รวมถึงการเปลี่ยนเส้นทางที่ปลอดภัย ความสัมพันธ์แคตตาล็อก และแหล่งข้อมูล การเห็นตัวอักษรในเบราว์เซอร์ไม่ได้พิสูจน์ว่าผ่านทุกชั้น
ตัดสินใจก่อนขยาย
โครงการทดลองควรตอบได้ว่าเข้าถึงไฟล์จริงหรือไม่ ข้อเท็จจริงมีที่มาหรือไม่ ขอบเขตตัวเลือกถูกต้องหรือไม่ และคำถามใดต้องส่งต่อระบบสด ตรวจสิ่งเหล่านี้ก่อนนับจำนวนไฟล์ที่สร้าง
SKU.md ไม่เข้าสู่ระบบหลังบ้าน ไม่เผยแพร่สินค้าอัตโนมัติ และไม่ส่งเข้าช่องทางช้อปปิ้งภายนอกเอง ผู้ขายเลือกสิ่งที่เผยแพร่ ส่วนการบริโภคข้อมูลโดย Agent ต้องตรวจแยก ราคา สต็อก และคำมั่นเรื่องจัดส่งยังอยู่ในระบบสด
เริ่มจากคู่มือเริ่มต้นแล้วส่งความรู้สินค้าที่ตรวจแล้วหนึ่งรายการให้ผู้ดูแลหน้าร้าน เป็นก้าวเล็กที่ชัดและช่วยพบปัญหาจริง