سرور SFTP فید عمومی امکان بارگذاری چندین نوع فید را در یک سرور SFTP واحد برای هر محیط فراهم می‌کند. این راهنما نحوه استفاده از سرور SFTP عمومی را توضیح می‌دهد و پیوندهایی به راهنمای مناسب برای فید مربوطه که قصد استفاده از آن را دارید ارائه می‌دهد.
(لطفاً به بخش صادر کردن فیدها (سرتاسر) یا فیدها (شروع‌کننده) در اسناد مراجعه کنید).سرور SFTP عمومی به وجود دو بارگذاری جداگانه متکی است:
- فایل توصیف‌گر: نوع فیدی را که بارگذاری خواهید کرد توصیف می‌کند
- فایل(های) فید: محتوای فید واقعی
درحال ساختاربندی فیلد توصیف‌گر
فایل توصیف‌گر بارگذاری می‌شود تا به سیستم ما اطلاع دهد که چه نوع فیدی را بارگذاری می‌کنید. این کار به ما امکان می‌دهد فید را به‌درستی اعتبارسنجی و پردازش کنیم. فایل توصیف‌کننده باید قبل‌از محتوای فید بارگذاری شود و باید از این الزامات نام‌گذاری پیروی کند:
- باید از پسوند فایل
.filesetdesc.jsonبرای فایل توصیف‌گر استفاده کنید. - نام هر فایل توصیف‌گر باید یکتا باشد و نمی‌توان آن را در بارگذاری‌های دیگر دوباره استفاده کرد. توصیه می‌کنیم مُهر زمان تولید و نام فید را در نام فایل بگنجانید.
- مثال: offers_1524606581.filesetdesc.json
- هر فایل توصیف‌گر باید همه فایل‌های داده را در جدیدترین فید برای نام فید مربوطه فهرست کند.
message FilesetDescriptor { option features.(pb.java).nest_in_file_class = YES; // 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 [features.(pb.cpp).string_type = STRING]; // Paths (relative to the dropbox root) specifying data files included in this // feed. (required) repeated string data_file = 3 [features.(pb.cpp).string_type = STRING]; }
مقادیر ممکن برای فیلد name عبارتند از:
- reservewithgoogle.entity
- google.offer
نمونه فایل توصیف‌گر JSON برای فید پیشنهادهای ویژه با دو قطعه در زیر دردسترس است:
{
"generation_timestamp": 1524606581,
"name": "google.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}درحال ساختاربندی محتوای فید
پس‌از بارگذاری فایل توصیف‌گر، سپس همه فایل‌های جارزن را برای نوع داده جارزن مربوط به فایل پیکربندی جارزن که توسط فایل توصیف‌گر شما نام‌گذاری شده است بارگذاری خواهید کرد. نام فایل‌ها و مکان‌های مسیر (مرتبط در سرور SFTP) باید دقیقاً با آنچه در فیلد data_file گنجانده شده است مطابقت داشته باشد. اگر فایلی وجود نداشته باشد، نام‌گذاری آن نادرست باشد، یا در مکان دیگری بارگذاری شده باشد، کل فید پردازش نخواهد شد.
محتوای این فایل‌های داده فید باید با مشخصات مربوط به فیدی که در فایل توصیف‌گر مشخص شده است مطابقت داشته باشد.
نام هر فایل فید باید یکتا باشد و نمی‌توان از آن در بارگذاری‌های دیگر استفاده کرد. توصیه می‌کنیم مُهر زمان تولید و شماره قطعه (شناسه افزایشی) را در نام فایل بگنجانید.
- مثال: offers_1524606581_1.json
اندازه فایل فید و تناوب بارگذاری
- اندازه فایل فید را زیر ۲۰۰ مگابایت (پس‌از فشرده‌سازی) نگه دارید.
- اندازه هر فایل داده از حالت فشرده خارج‌شده باید کمتر از ۲ گیگابایت باشد.
- اکثر ادغام‌ها فقط به استفاده از یک قطعه نیاز دارند. باید از کمترین تعداد ممکن تکه‌ها استفاده کنید. حداکثر ۱۰۰۰ قطعه برای هر فید وجود دارد.
- سوابق فردی ارسال‌شده در یک قطعه لازم نیست در فیدهای آینده در همان شماره قطعه ارسال شوند.
- برای عملکرد بهتر، داده‌ها را به‌طور مساوی بین قطعات تقسیم کنید تا همه فایل‌های قطعه ازنظر اندازه مشابه باشند.
- درصورت لزوم، از gzip برای فشرده‌سازی فیدها استفاده کنید. بااین‌حال، این کار را برای هر بخش فید جداگانه انجام دهید.
عیب‌یابی و اشکال‌زدایی
پس‌از بارگذاری فایل‌هایتان (فایل‌های توصیف‌گر و فید)، به نمایشگر جذب (اسناد) در «پورتال شریک» بروید (به جذب > سابقه بروید) تا پیشرفت جذب فیدتان را دنبال کنید.
برای پیدا کردن فیدتان، name را که در فایل توصیف‌گر وارد کرده‌اید در ستون «نام فید» جستجو کنید.
وقتی جارزن دریافت شد (وضعیت Success یا Fail است) می‌توانید روی ردیف آن کلیک کنید تا جزئیات خطاها و هشدارها را ببینید.