การใช้เซิร์ฟเวอร์ SFTP ทั่วไป

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

คำเตือน: คำแนะนำนี้ไม่มีผลกับเซิร์ฟเวอร์ SFTP ของผู้ขาย บริการ หรือความพร้อมจำหน่าย โดยจะมีผลกับเซิร์ฟเวอร์ SFTP ทั่วไปเท่านั้น

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

คำเตือน: คุณอาจต้องรีเซ็ตคีย์ SSH เพื่อเปิดใช้การอัปโหลดไปยังเซิร์ฟเวอร์ SFTP ของฟีดทั่วไป โดยดูข้อมูลได้ที่ การกำหนดค่าฟีดพอร์ทัลพาร์ทเนอร์ (เอกสารประกอบ)

เซิร์ฟเวอร์ SFTP ทั่วไปจะอาศัยการอัปโหลดแยกกัน 2 รายการ ได้แก่

1. ไฟล์คำอธิบาย: อธิบายประเภทฟีดที่จะอัปโหลด
2. ไฟล์ฟีด: เนื้อหาของฟีดจริง

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

การจัดโครงสร้างฟิลด์ตัวบ่งชี้

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

• คุณต้องใช้นามสกุลไฟล์ .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"
  ]
}

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

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

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

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

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

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

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

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

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

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

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