জেনেরিক SFTP সার্ভার ব্যবহার করে

জেনেরিক ফিড SFTP সার্ভার প্রতিটি পরিবেশে একাধিক ফিড টাইপ আপলোড করার অনুমতি দেয়। এই নির্দেশিকাটি জেনেরিক SFTP সার্ভার কীভাবে ব্যবহার করবেন তা নিয়ে আলোচনা করবে এবং আপনি যে ফিডটি ব্যবহার করার পরিকল্পনা করছেন তার জন্য উপযুক্ত নির্দেশিকার লিঙ্ক প্রদান করবে।

জেনেরিক SFTP সার্ভার দুটি পৃথক আপলোডের উপর নির্ভর করে:

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 বর্ণনাকারী ফাইল নীচে পাওয়া যাবে:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

ফিডের বিষয়বস্তু গঠন করা

বর্ণনাকারী ফাইল আপলোড করার পর, আপনি আপনার বর্ণনাকারী ফাইল দ্বারা নামকরণ করা ফিড কনফিগারেশন ফাইলের সাথে সম্পর্কিত ফিড ডেটা টাইপের জন্য সমস্ত ফিড ফাইল আপলোড করবেন। ফাইলের নাম এবং পাথের অবস্থান (SFTP সার্ভারের মধ্যে সম্পর্কিত) অবশ্যই data_file ক্ষেত্রের মধ্যে অন্তর্ভুক্ত করা ফাইলের সাথে হুবহু মিলতে হবে। যদি কোনও ফাইল অনুপস্থিত থাকে, ভুলভাবে নামকরণ করা হয়, অথবা অন্য কোনও স্থানে আপলোড করা হয় তবে সম্পূর্ণ ফিড প্রক্রিয়া করা হবে না।

এই ফিড ডেটা ফাইলগুলির বিষয়বস্তু অবশ্যই বর্ণনাকারী ফাইলে নির্দিষ্ট করা ফিডের প্রাসঙ্গিক বৈশিষ্ট্যের সাথে সঙ্গতিপূর্ণ হতে হবে।

প্রতিটি ফিড ফাইলের ফাইলের নাম অবশ্যই অনন্য হতে হবে এবং আপলোড জুড়ে পুনরায় ব্যবহার করা যাবে না। আমরা ফাইলের নামে জেনারেশন টাইমস্ট্যাম্প এবং শার্ড নম্বর (ইনক্রিমেন্টাল আইডি) অন্তর্ভুক্ত করার পরামর্শ দিচ্ছি।

• উদাহরণ: offers_1524606581_1.json

ফিড ফাইলের আকার এবং আপলোড ফ্রিকোয়েন্সি

• ফিড ফাইলের আকার ২০০ মেগাবাইটের নিচে রাখুন (কম্প্রেশনের পরে)।
• প্রতিটি ডিকম্প্রেসড ডেটা ফাইলের আকার 2 জিবি-র কম হওয়া উচিত।
• বেশিরভাগ ইন্টিগ্রেশনের জন্য শুধুমাত্র একটি শার্ড ব্যবহার করতে হবে। আপনার যতটা সম্ভব কম শার্ড ব্যবহার করা উচিত। প্রতি ফিডে সর্বাধিক ১০০০ শার্ড ব্যবহার করা যাবে।
• একই শার্ডে পাঠানো পৃথক রেকর্ড ভবিষ্যতের ফিডে একই শার্ড নম্বরে পাঠানোর প্রয়োজন নেই।
• আরও ভালো পারফরম্যান্সের জন্য, সমস্ত শার্ড ফাইলের আকার একই রকম করার জন্য, ডাটাগুলিকে শার্ডগুলির মধ্যে সমানভাবে ভাগ করুন।
• প্রয়োজনে, ফিড কম্প্রেস করার জন্য gzip ব্যবহার করুন। তবে, প্রতিটি ফিড শার্ডের জন্য এটি করুন।

সমস্যা সমাধান এবং ডিবাগিং

আপনার ফাইলগুলি (বর্ণনাকারী এবং ফিড ফাইল) আপলোড করার পরে, আপনার ফিড ইনজেশনের অগ্রগতি অনুসরণ করতে পার্টনার পোর্টালের ইনজেশন ভিউয়ার ( ডকুমেন্টেশন ) এ যান ( ইনজেশন > ইতিহাসে নেভিগেট করুন)।

আপনার ফিডটি খুঁজে পেতে "ফিডের নাম" কলামে বর্ণনাকারী ফাইলে আপনার ইনপুট করা name সন্ধান করুন।

ফিডটি একবার ইনজেক্ট হয়ে গেলে (স্ট্যাটাস হল Success or Fail ), আপনি ত্রুটি এবং সতর্কতার বিবরণ দেখতে এর সারিতে ক্লিক করতে পারেন।