ดรอปบ็อกซ์ฟีดทั่วไปช่วยให้อัปโหลดฟีดหลายประเภทไปยังดรอปบ็อกซ์เดียวต่อสภาพแวดล้อมได้ คู่มือนี้จะแนะนำวิธีใช้ดรอปบ็อกซ์ทั่วไปและให้ลิงก์ไปยังคำแนะนำที่เหมาะสมสำหรับฟีดที่คุณวางแผนจะใช้
(โปรดดูส่วนการส่งออกฟีด (ปลายทางถึงปลายทาง) หรือฟีด (เริ่มต้น) ในเอกสารประกอบ)ดรอปบ็อกซ์ทั่วไปจะมีการอัปโหลดแยกกัน 2 รายการ ดังนี้
- ไฟล์ข้อบ่งชี้: อธิบายประเภทฟีดที่คุณจะอัปโหลด
- ไฟล์ฟีด: เนื้อหาของฟีดจริง
การจัดโครงสร้างช่องข้อบ่งชี้
ระบบจะอัปโหลดไฟล์ข้อบ่งชี้เพื่อให้ระบบของเราทราบถึงประเภทฟีดที่คุณกำลังอัปโหลด ซึ่งจะช่วยให้เราตรวจสอบและประมวลผลฟีดได้อย่างถูกต้อง คุณควรอัปโหลดไฟล์ข้อบ่งชี้ก่อนเนื้อหาฟีดและต้องเป็นไปตามข้อกำหนดในการตั้งชื่อต่อไปนี้
- ใช้นามสกุลไฟล์ .filesetdesc.json
- ชื่อไฟล์ตัวบ่งชี้แต่ละชื่อไฟล์ต้องไม่ซ้ำกัน และไม่สามารถใช้ซ้ำในการอัปโหลดได้ เราขอแนะนำให้ใส่การประทับเวลาการสร้างในชื่อไฟล์
- ตัวอย่าง: Offers_1524606581.filesetdesc.json
message FilesetDescriptor { // The timestamp at which this feed was generated, in Unix time format // (seconds since the epoch). (required) int64 generation_timestamp = 1; // Identifies the name of this feed. (required) string name = 2; // Paths (relative to the dropbox root) specifying data files included in this // feed. (required) repeated string data_file = 3; }
ค่าที่เป็นไปได้สำหรับช่อง name
ได้แก่
ตัวอย่างไฟล์ข้อบ่งชี้ JSON สำหรับฟีดข้อเสนอที่มีชาร์ด 2 รายการมีดังนี้
{ "generation_timestamp": 1524606581, "name": "promote.offer", "data_file": [ "offers_1524606581_1.json", "offers_1524606581_2.json" ] }
การจัดโครงสร้างเนื้อหาฟีด
หลังจากอัปโหลดไฟล์ข้อบ่งชี้แล้ว คุณจะต้องอัปโหลดไฟล์ฟีดทั้งหมดสำหรับประเภทข้อมูลฟีดที่สอดคล้องกับไฟล์การกำหนดค่าฟีดที่ตั้งชื่อตามไฟล์ข้อบ่งชี้ ชื่อไฟล์และตำแหน่งเส้นทาง (สัมพัทธ์ภายในดรอปบ็อกซ์) ต้องตรงกับสิ่งที่รวมอยู่ในช่อง data_file
ทุกประการ หากไฟล์ใดหายไป ตั้งชื่อไม่ถูกต้อง หรืออัปโหลดไปยังตำแหน่งอื่น ระบบจะไม่ประมวลผลฟีดทั้งฟีด
เนื้อหาของไฟล์ข้อมูลฟีดเหล่านี้ต้องเป็นไปตามข้อกำหนดที่เกี่ยวข้องของฟีดซึ่งระบุไว้ในไฟล์ข้อบ่งชี้
ชื่อไฟล์ฟีดแต่ละไฟล์ต้องไม่ซ้ำกันและไม่สามารถใช้ซ้ำในการอัปโหลดได้ เราขอแนะนำให้ใส่การประทับเวลาการสร้างและหมายเลขชาร์ด (รหัสที่เพิ่มขึ้น) ในชื่อไฟล์
- ตัวอย่าง: Offers_1524606581_1.json
ขนาดไฟล์ฟีดและความถี่ในการอัปโหลด
- รักษาขนาดไฟล์ฟีดให้ต่ำกว่า 200 MB (หลังการบีบอัด)
- การผสานรวมส่วนใหญ่จะต้องใช้ชาร์ดเดี่ยวเท่านั้น คุณควรใช้ชาร์ดให้น้อยที่สุดเท่าที่จะทำได้ มีชาร์ดได้สูงสุด 1,000 ชาร์ดต่อฟีด
- ระเบียนแต่ละรายการที่ส่งในชาร์ดเดียวไม่จำเป็นต้องส่งด้วยหมายเลขชาร์ดเดียวกันในฟีดในอนาคต
- เพื่อประสิทธิภาพที่ดีขึ้น ให้แบ่งข้อมูลระหว่างชาร์ดเท่าๆ กัน เพื่อทำให้ไฟล์ชาร์ดทั้งหมดมีขนาดใกล้เคียงกัน
- หากจำเป็น ให้ใช้ gzip เพื่อบีบอัดฟีด แต่ให้ทำตามชาร์ดฟีดแต่ละรายการ
การแก้ปัญหาและการแก้ไขข้อบกพร่อง
หลังจากอัปโหลดไฟล์ (คำอธิบายและไฟล์ฟีด) ให้ไปที่หน้าแดชบอร์ดประวัติฟีด (เอกสารประกอบ) บนพอร์ทัลพาร์ทเนอร์ (ไปที่ประวัติ > ฟีด) เพื่อติดตามความคืบหน้าของการนำเข้าฟีด
มองหา name
ที่คุณป้อนไว้ในไฟล์ข้อบ่งชี้ในคอลัมน์ "ชื่อฟีด" เพื่อค้นหาฟีด
เมื่อระบบนำเข้าฟีด (สถานะคือ Success
หรือ Fail
) คุณจะคลิกแถวเพื่อดูรายละเอียดของข้อผิดพลาดและคำเตือนได้