জেনেরিক ফিড ড্রপবক্স পরিবেশ প্রতি একক ড্রপবক্সে একাধিক ফিড প্রকার আপলোড করার অনুমতি দেয়। এই নির্দেশিকাটি জেনেরিক ড্রপবক্স কীভাবে ব্যবহার করতে হয় এবং আপনি যে ফিডটি ব্যবহার করার পরিকল্পনা করছেন তার জন্য উপযুক্ত গাইডের লিঙ্ক প্রদান করবেন।
(দয়া করে ডকুমেন্টেশনের রপ্তানি ফিড (এন্ড-টু-এন্ড) বা ফিড (স্টার্টার) বিভাগ দেখুন)।জেনেরিক ড্রপবক্স দুটি পৃথক আপলোডের উপর নির্ভর করে:
- বর্ণনাকারী ফাইল: আপনি কি ধরনের ফিড আপলোড করবেন তা বর্ণনা করে
- ফিড ফাইল(গুলি): প্রকৃত ফিডের বিষয়বস্তু
বর্ণনাকারী ক্ষেত্রের গঠন
আপনি কি ধরনের ফিড আপলোড করছেন তা আমাদের সিস্টেমকে জানানোর জন্য বর্ণনাকারী ফাইলটি আপলোড করা হয়েছে। এটি আমাদের সঠিকভাবে ফিড যাচাই এবং প্রক্রিয়া করার অনুমতি দেয়। বর্ণনাকারী ফাইলটি ফিডের বিষয়বস্তুর আগে আপলোড করা উচিত এবং এই নামকরণের প্রয়োজনীয়তাগুলি অবশ্যই অনুসরণ করতে হবে:
- বর্ণনাকারী ফাইলের জন্য আপনাকে অবশ্যই
.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"
]
}ফিড বিষয়বস্তু গঠন
বর্ণনাকারী ফাইল আপলোড করার পরে, আপনি আপনার বর্ণনাকারী ফাইল দ্বারা নামযুক্ত ফিড কনফিগারেশন ফাইলের সাথে সম্পর্কিত ফিড ডেটা টাইপের জন্য সমস্ত ফিড ফাইল আপলোড করবেন। ফাইলের নাম এবং পাথের অবস্থানগুলি (ড্রপবক্সের মধ্যে আপেক্ষিক) অবশ্যই data_file ক্ষেত্রের মধ্যে যা অন্তর্ভুক্ত ছিল তার সাথে মিল থাকতে হবে। যদি কোনো ফাইল অনুপস্থিত থাকে, ভুলভাবে নাম দেওয়া হয় বা অন্য কোনো স্থানে আপলোড করা হয় তাহলে পুরো ফিডটি প্রসেস করা হবে না।
এই ফিড ডেটা ফাইলগুলির বিষয়বস্তুগুলিকে বর্ণনাকারী ফাইলে নির্দিষ্ট করা ফিডের প্রাসঙ্গিক বৈশিষ্ট্যের সাথে সঙ্গতিপূর্ণ হতে হবে।
প্রতিটি ফিড ফাইল ফাইলের নাম অনন্য হতে হবে এবং আপলোড জুড়ে পুনরায় ব্যবহার করা যাবে না। আমরা ফাইলের নামটিতে জেনারেশন টাইমস্ট্যাম্প এবং শার্ড নম্বর (ক্রমবর্ধমান আইডি) অন্তর্ভুক্ত করার পরামর্শ দিই।
- উদাহরণ: offers_1524606581_1.json
ফিড ফাইল মাপ এবং আপলোড ফ্রিকোয়েন্সি
- ফিড ফাইলের আকার 200 MB এর নিচে রাখুন (সংকোচনের পরে)।
- প্রতিটি ডিকম্প্রেসড ডেটা ফাইলের আকার 2 গিগাবাইটের কম হওয়া উচিত।
- বেশিরভাগ ইন্টিগ্রেশনের জন্য শুধুমাত্র একটি একক শার্ড ব্যবহার করতে হবে। আপনি যতটা সম্ভব কম shards ব্যবহার করা উচিত. ফিড প্রতি সর্বোচ্চ 1000 শার্ড আছে।
- এক শার্ডে পাঠানো পৃথক রেকর্ড ভবিষ্যতে ফিডে একই শার্ড নম্বরে পাঠানোর প্রয়োজন নেই।
- ভালো পারফরম্যান্সের জন্য, শার্ডগুলির মধ্যে সমানভাবে ডেটা বিভক্ত করুন, যাতে সমস্ত শার্ড ফাইলের আকার একই হয়৷
- প্রয়োজনে, ফিড সংকুচিত করতে gzip ব্যবহার করুন। যাইহোক, প্রতিটি পৃথক ফিড শার্ডের জন্য এটি করুন।
সমস্যা সমাধান এবং ডিবাগিং
আপনার ফাইল আপলোড করার পরে (বিবরণকারী এবং ফিড ফাইল) আপনার ফিড ইনজেশনের অগ্রগতি অনুসরণ করতে অংশীদার পোর্টালের ফিড ইতিহাস ড্যাশবোর্ডে ( ডকুমেন্টেশন ) যান ( ইতিহাস > ফিডগুলিতে নেভিগেট করুন)৷
আপনার ফিড খুঁজতে "ফিডের নাম" কলামে বর্ণনাকারী ফাইলে আপনি যে name ইনপুট করেছেন তা সন্ধান করুন।
একবার ফিড ইনজেস্ট হয়ে গেলে (স্ট্যাটাস হল Success বা Fail ) আপনি ত্রুটি ও সতর্কতার বিশদ বিবরণ দেখতে এর সারিতে ক্লিক করতে পারেন।