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