การใช้ดรอปบ็อกซ์ฟีดทั่วไป

ดรอปบ็อกซ์ฟีดทั่วไปช่วยให้คุณอัปโหลดฟีดหลายประเภทไปยังดรอปบ็อกซ์เดียวต่อสภาพแวดล้อมได้ คู่มือนี้จะอธิบายวิธีใช้ Dropbox ทั่วไปและแสดงลิงก์ไปยังคู่มือที่เหมาะสมสำหรับฟีดที่เกี่ยวข้องซึ่งคุณวางแผนจะใช้

กล่องจดหมายทั่วไปจะอาศัยการอัปโหลดแยกกัน 2 ครั้ง ดังนี้

1. ไฟล์คำอธิบาย: อธิบายประเภทฟีดที่จะอัปโหลด
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"
  ]
}

การจัดโครงสร้างเนื้อหาฟีด

หลังจากอัปโหลดไฟล์คําอธิบายแล้ว ให้อัปโหลดไฟล์ฟีดทั้งหมดสําหรับประเภทข้อมูลฟีดที่สอดคล้องกับไฟล์การกําหนดค่าฟีดที่ชื่อไฟล์คําอธิบาย ชื่อไฟล์และตำแหน่งเส้นทาง (แบบสัมพัทธ์ภายใน Dropbox) ต้องตรงกับสิ่งที่ระบุไว้ในช่อง data_file ทุกประการ หากไม่มีไฟล์ใดไฟล์หนึ่ง ชื่อไฟล์ไม่ถูกต้อง หรืออัปโหลดไปยังตำแหน่งอื่น ระบบจะไม่ประมวลผลฟีดทั้งหมด

เนื้อหาของไฟล์ข้อมูลฟีดเหล่านี้ต้องเป็นไปตามข้อกำหนดที่เกี่ยวข้องของฟีดที่ระบุไว้ในไฟล์ข้อบ่งชี้

ชื่อไฟล์ฟีดแต่ละชื่อต้องไม่ซ้ำกัน และจะใช้ซ้ำกันในการอัปโหลดไม่ได้ เราขอแนะนําให้ใส่การประทับเวลาการสร้างและหมายเลขกลุ่ม (รหัสที่เพิ่มขึ้น) ในชื่อไฟล์

• ตัวอย่าง: offers_1524606581_1.json

ขนาดไฟล์ฟีดและความถี่ในการอัปโหลด

• ไฟล์ฟีดต้องมีขนาดไม่เกิน 200 MB (หลังจากการบีบอัด)
• ไฟล์ข้อมูลที่คลายการบีบอัดแต่ละไฟล์ควรมีขนาดไม่เกิน 2 GB
• การผสานรวมส่วนใหญ่จะใช้ข้อมูลเพียงกลุ่มเดียว คุณควรใช้กลุ่มย่อยให้น้อยที่สุดเท่าที่จะทำได้ 1 ฟีดมีข้อมูลได้สูงสุด 1,000 รายการ
• ระเบียนแต่ละรายการที่ส่งในสhard หนึ่งไม่จำเป็นต้องส่งในสhard หมายเลขเดียวกันในฟีดในอนาคต
• แยกข้อมูลอย่างเท่าๆ กันในชาร์ดต่างๆ เพื่อให้ไฟล์ชาร์ดทั้งหมดมีขนาดใกล้เคียงกันเพื่อประสิทธิภาพที่ดียิ่งขึ้น
• หากจําเป็น ให้ใช้ Gzip เพื่อบีบอัดฟีด แต่ให้ดำเนินการกับแต่ละกลุ่มแชร์ของฟีด

การแก้ปัญหาและการแก้ไขข้อบกพร่อง

หลังจากอัปโหลดไฟล์ (ไฟล์ข้อบ่งชี้และไฟล์ฟีด) แล้ว ให้ไปที่แดชบอร์ดประวัติฟีด (เอกสารประกอบ) ในพอร์ทัลพาร์ทเนอร์ (ไปที่ประวัติ > ฟีด) เพื่อติดตามความคืบหน้าในการนำเข้าฟีด

มองหา name ที่คุณป้อนในไฟล์คำอธิบายในคอลัมน์ "ชื่อฟีด" เพื่อค้นหาฟีด

เมื่อระบบนำเข้าฟีดแล้ว (สถานะคือ Success หรือ Fail) คุณจะคลิกแถวของฟีดเพื่อดูรายละเอียดของข้อผิดพลาดและคําเตือนได้