ดรอปบ็อกซ์ฟีดทั่วไปอนุญาตให้อัปโหลดฟีดหลายประเภทไปยังดรอปบ็อกซ์ 1 ช่องต่อสภาพแวดล้อม 1 รายการ คู่มือนี้จะแนะนําวิธีใช้ดรอปบ็อกซ์ทั่วไปและให้ลิงก์ไปยังคู่มือที่เหมาะสมสําหรับฟีดที่คุณวางแผนจะใช้
(โปรดดูส่วนการส่งออกฟีด (จากต้นทางถึงปลายทาง) หรือฟีด (เริ่มต้น) ของเอกสารประกอบ)ดรอปบ็อกซ์ทั่วไปต้องอาศัยการอัปโหลด 2 รายการที่แยกกัน ดังนี้
- ไฟล์ข้อบ่งชี้: อธิบายประเภทฟีดที่คุณจะอัปโหลด
- ไฟล์ฟีด: เนื้อหาของฟีดจริง
โครงสร้างช่องข้อบ่งชี้
ไฟล์ตัวบ่งชี้จะอัปโหลดการแจ้งระบบของเราเกี่ยวกับประเภทฟีดที่คุณกําลังอัปโหลด วิธีนี้ช่วยให้เราตรวจสอบและประมวลผลฟีดได้อย่างถูกต้อง ต้องอัปโหลดไฟล์ข้อบ่งชี้ก่อนเนื้อหาฟีด และต้องเป็นไปตามข้อกําหนดการตั้งชื่อเหล่านี้
- ใช้นามสกุลไฟล์ .filesetDEV.json
- ชื่อไฟล์ตัวบ่งชี้แต่ละรายการต้องไม่ซ้ํากันและนํามาใช้ซ้ําในการอัปโหลดไม่ได้ เราขอแนะนําให้ใส่การประทับเวลาการสร้างไว้ในชื่อไฟล์
- ตัวอย่าง: Offers_1524606581.filesetDEV.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) คุณจะคลิกแถวของฟีดเพื่อดูรายละเอียดข้อผิดพลาดและคําเตือนได้