เซิร์ฟเวอร์ SFTP ของฟีดทั่วไปอนุญาตให้อัปโหลดฟีดหลายประเภทไปยังเซิร์ฟเวอร์ SFTP เดียวต่อสภาพแวดล้อม คู่มือนี้จะอธิบายวิธีใช้ เซิร์ฟเวอร์ SFTP ทั่วไป และระบุลิงก์ไปยังคู่มือที่เหมาะสมสำหรับฟีดที่เกี่ยวข้อง ที่คุณวางแผนจะใช้
(โปรดดูส่วน การส่งออกฟีด (ตั้งแต่ต้นจนจบ) หรือฟีด (เริ่มต้น) ในเอกสารประกอบ)เซิร์ฟเวอร์ SFTP ทั่วไปจะขึ้นอยู่กับการอัปโหลด 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 Shard มีดังนี้
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}การจัดโครงสร้างเนื้อหาฟีด
หลังจากอัปโหลดไฟล์ตัวอธิบายแล้ว คุณจะต้องอัปโหลดไฟล์ฟีดทั้งหมด
สำหรับประเภทข้อมูลฟีดที่สอดคล้องกับไฟล์การกำหนดค่าฟีดซึ่งตั้งชื่อตาม
ไฟล์ตัวอธิบาย ชื่อไฟล์และตำแหน่งเส้นทาง (สัมพันธ์ภายในเซิร์ฟเวอร์ SFTP) ต้องตรงกับที่รวมอยู่ในฟิลด์ data_file ทุกประการ หากไม่มีไฟล์ใด ไฟล์มีชื่อไม่ถูกต้อง หรือ
อัปโหลดไปยังตำแหน่งอื่น ระบบจะไม่ประมวลผลฟีดทั้งหมด
เนื้อหาของไฟล์ข้อมูลฟีดเหล่านี้ต้องเป็นไปตามข้อกำหนดที่เกี่ยวข้องของ ฟีดที่ระบุไว้ในไฟล์ตัวอธิบาย
ชื่อไฟล์ฟีดแต่ละชื่อต้องไม่ซ้ำกันและจะใช้ซ้ำในการอัปโหลดไม่ได้ เราขอแนะนำ ให้ใส่การประทับเวลาการสร้างและหมายเลข Shard (รหัสที่เพิ่มขึ้น) ในชื่อไฟล์
- ตัวอย่าง: offers_1524606581_1.json
ขนาดไฟล์ฟีดและความถี่ในการอัปโหลด
- ขนาดไฟล์ฟีดต้องไม่เกิน 200 MB (หลังจากบีบอัด)
- ไฟล์ข้อมูลที่คลายการบีบอัดแล้วแต่ละไฟล์ควรมีขนาดไม่เกิน 2 GB
- การผสานรวมส่วนใหญ่จะต้องใช้เพียง Shard เดียว คุณควรใช้ จำนวน Shard ให้น้อยที่สุด โดยมี Shard ได้สูงสุด 1,000 รายการต่อฟีด
- ไม่จำเป็นต้องส่งระเบียนแต่ละรายการที่ส่งใน Shard หนึ่งในหมายเลข Shard เดียวกันในฟีดในอนาคต
- แบ่งข้อมูลให้เท่ากันในชาร์ดเพื่อให้ไฟล์ชาร์ดทั้งหมดมีขนาดใกล้เคียงกันเพื่อประสิทธิภาพที่ดีขึ้น
- หากจำเป็น ให้ใช้ gzip เพื่อบีบอัดฟีด แต่ให้ทำสำหรับแต่ละ แต่ละส่วนของฟีด
การแก้ปัญหาและการแก้ไขข้อบกพร่อง
หลังจากอัปโหลดไฟล์ (ไฟล์ตัวอธิบายและฟีด) แล้ว ให้ไปที่ Ingestion Viewer (เอกสารประกอบ) ในพอร์ทัลพาร์ทเนอร์ (ไปที่การส่งผ่านข้อมูล > ประวัติ) เพื่อติดตามความคืบหน้าของการส่งผ่านข้อมูลฟีด
มองหา name ที่คุณป้อนในไฟล์ตัวอธิบายในคอลัมน์ "ชื่อฟีด" เพื่อค้นหาฟีด
เมื่อระบบส่งผ่านข้อมูลฟีดแล้ว (สถานะเป็น Success หรือ Fail) คุณจะคลิกแถวของฟีดเพื่อดูรายละเอียดของข้อผิดพลาดและคำเตือนได้