ดรอปบ็อกซ์ฟีดทั่วไปทำให้สามารถอัปโหลดฟีดได้หลายประเภทไปยัง ดรอปบ็อกซ์เดี่ยวต่อสภาพแวดล้อม คู่มือนี้จะอธิบายวิธีใช้ Dropbox ทั่วไปและแสดงลิงก์ไปยังคู่มือที่เหมาะสมสำหรับฟีดที่เกี่ยวข้องซึ่งคุณวางแผนจะใช้
(โปรดดู การส่งออกฟีด (ต้นทางถึงปลายทาง) หรือส่วนฟีด (เงื่อนไขเริ่มต้น) ของเอกสาร)กล่องจดหมายทั่วไปจะอาศัยการอัปโหลดแยกกัน 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 (หลังจากการบีบอัด)
- ไฟล์ข้อมูลที่บีบอัดแต่ละไฟล์ควรมีขนาดไม่เกิน 2 GB
- การผสานรวมส่วนใหญ่จะใช้ข้อมูลเพียงกลุ่มเดียว คุณควรใช้เป็น ชาร์ดน้อยที่สุดเท่าที่จะเป็นไปได้ 1 ฟีดมีข้อมูลได้สูงสุด 1,000 รายการ
- ระเบียนแต่ละรายการที่ส่งในสhard หนึ่งไม่จำเป็นต้องส่งในสhard หมายเลขเดียวกันในฟีดในอนาคต
- เพื่อประสิทธิภาพที่ดีขึ้น ให้แบ่งข้อมูลระหว่างชาร์ดให้เท่าๆ กันเพื่อให้ทั้งหมด ไฟล์ชาร์ดที่มีขนาดใกล้เคียงกัน
- หากจําเป็น ให้ใช้ Gzip เพื่อบีบอัดฟีด แต่ให้ดำเนินการกับแต่ละกลุ่มแชร์ของฟีด
การแก้ปัญหาและการแก้ไขข้อบกพร่อง
หลังจากอัปโหลดไฟล์ (ไฟล์ข้อบ่งชี้และไฟล์ฟีด) แล้ว ให้ไปที่แดชบอร์ดประวัติฟีด (เอกสารประกอบ) ในพอร์ทัลพาร์ทเนอร์ (ไปที่ประวัติ > ฟีด) เพื่อติดตามความคืบหน้าในการนำเข้าฟีด
มองหา name ที่คุณป้อนในไฟล์ข้อบ่งชี้ใน "ชื่อฟีด" เพื่อค้นหาฟีดของคุณ
เมื่อระบบนำเข้าฟีดแล้ว (สถานะคือ Success หรือ Fail) คุณจะคลิกแถวของฟีดเพื่อดูรายละเอียดของข้อผิดพลาดและคําเตือนได้