سرور SFTP با فید عمومی (Generic feed SFTP server) امکان آپلود چندین نوع فید را در یک سرور SFTP واحد برای هر محیط فراهم میکند. این راهنما نحوه استفاده از سرور SFTP عمومی را بررسی کرده و پیوندهایی به راهنمای مناسب برای فید مربوطه که قصد استفاده از آن را دارید، ارائه میدهد.
(لطفاً به بخش «خروجیگیری فیدها (از ابتدا تا انتها)» یا «خوراکها (آغازین) » در مستندات مراجعه کنید.)سرور عمومی 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 برای فید پیشنهادات با دو شارد در زیر موجود است:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}ساختاردهی محتوای فید
پس از آپلود فایل توصیفگر، تمام فایلهای فید مربوط به نوع داده فید مربوط به فایل پیکربندی فید که توسط فایل توصیفگر شما نامگذاری شده است را آپلود خواهید کرد. نام فایلها و مکانهای مسیر (نسبتاً در سرور SFTP) باید دقیقاً با آنچه در فیلد data_file گنجانده شده است، مطابقت داشته باشند. اگر هر فایلی وجود نداشته باشد، نام نادرستی داشته باشد یا در مکان دیگری آپلود شده باشد، کل فید پردازش نخواهد شد.
محتویات این فایلهای داده فید باید با مشخصات مربوط به فید که در فایل توصیفگر مشخص شده است، مطابقت داشته باشد.
نام هر فایل فید باید منحصر به فرد باشد و نمیتوان از آن در آپلودهای مختلف دوباره استفاده کرد. توصیه میکنیم مهر زمان تولید و شماره شارد (شناسه افزایشی) را در نام فایل لحاظ کنید.
- مثال: offers_1524606581_1.json
اندازه فایلهای فید و تعداد دفعات آپلود
- حجم فایل فید را (پس از فشردهسازی) کمتر از ۲۰۰ مگابایت نگه دارید.
- حجم هر فایل دادهی از حالت فشرده خارج شده باید کمتر از ۲ گیگابایت باشد.
- بیشتر ادغامها فقط به یک Shard نیاز دارند. شما باید تا حد امکان از Shardهای کمتری استفاده کنید. حداکثر ۱۰۰۰ Shard در هر Feed وجود دارد.
- رکوردهای تکی که در یک شارد ارسال میشوند، نیازی نیست در فیدهای بعدی نیز در همان شماره شارد ارسال شوند.
- برای عملکرد بهتر، دادهها را به طور مساوی بین Shardها تقسیم کنید تا اندازه همه فایلهای Shard مشابه باشد.
- در صورت لزوم، از gzip برای فشردهسازی فیدها استفاده کنید. با این حال، این کار را برای هر تکه فید به صورت جداگانه انجام دهید.
عیبیابی و اشکالزدایی
پس از آپلود فایلهای خود (فایلهای توصیفگر و فید)، برای پیگیری پیشرفت دریافت فید خود، به بخش «نمایشگر مصرف» ( مستندات ) در پورتال شرکا (به مسیر مصرف > تاریخچه ) بروید.
برای یافتن فید خود، name را که در فایل توصیفگر وارد کردهاید، در ستون «نام فید» جستجو کنید.
پس از دریافت فید (وضعیت Success یا Fail ) میتوانید روی ردیف آن کلیک کنید تا جزئیات خطاها و هشدارها را مشاهده کنید.