دراپ باکس فید عمومی امکان آپلود چندین نوع فید را در یک دراپ باکس واحد در هر محیط فراهم می کند. این راهنما نحوه استفاده از دراپ باکس عمومی را توضیح می‌دهد و پیوندهایی به راهنمای مناسب برای فید مربوطه که قصد استفاده از آن را دارید ارائه می‌دهد.
(لطفاً به بخش صادرات فیدها (پایان به انتها) یا فیدها (شروع کننده) اسناد مراجعه کنید).دراپ باکس عمومی به وجود دو آپلود جداگانه متکی است:
- فایل توصیفگر: توضیح می دهد که چه نوع فید را آپلود خواهید کرد
- فایل(های) فید: محتوای فید واقعی
ساختار فیلد توصیفگر
فایل توصیفگر آپلود می شود تا به سیستم ما اطلاع دهد که چه نوع فید را آپلود می کنید. این به ما امکان می دهد فید را به درستی تأیید و پردازش کنیم. فایل توصیفگر باید قبل از محتوای فید آپلود شود و باید این الزامات نامگذاری را رعایت کند:
- برای فایل توصیفگر باید از پسوند فایل
.filesetdesc.jsonاستفاده کنید. - هر نام فایل توصیفگر باید منحصربه‌فرد باشد و نمی‌توان آن را دوباره در بارگذاری‌ها استفاده کرد. توصیه می کنیم مهر زمان تولید و نام فید را در نام فایل اضافه کنید.
- مثال: offer_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 گنجانده شده است مطابقت داشته باشد. اگر فایلی مفقود باشد، نام نامناسبی داشته باشد، یا در مکان دیگری آپلود شود، کل فید پردازش نخواهد شد.
محتویات این فایل های داده فید باید با مشخصات مربوطه فید که در فایل توصیفگر مشخص شده است مطابقت داشته باشد.
هر نام فایل فید باید منحصربه‌فرد باشد و نمی‌توان از آن در سراسر آپلودها استفاده کرد. توصیه می کنیم مهر زمان تولید و شماره قطعه (شناسه افزایشی) را در نام فایل اضافه کنید.
- مثال: offer_1524606581_1.json
اندازه فایل خوراک و تعداد دفعات آپلود
- اندازه فایل فید را زیر 200 مگابایت نگه دارید (پس از فشرده سازی).
- اندازه هر فایل داده از حالت فشرده باید کمتر از 2 گیگابایت باشد.
- اکثر ادغام ها فقط نیاز به استفاده از یک قطعه دارند. شما باید تا حد امکان از خرده های کوچک استفاده کنید. حداکثر 1000 خرده در هر خوراک وجود دارد.
- رکوردهای فردی که در یک قطعه ارسال می شوند نیازی به ارسال با همان شماره خرده در فیدهای بعدی ندارند.
- برای عملکرد بهتر، داده ها را به طور مساوی بین خرده ها تقسیم کنید تا همه فایل های خرد شده از نظر اندازه مشابه باشند.
- در صورت لزوم، از gzip برای فشرده سازی فیدها استفاده کنید. با این حال، این کار را برای هر خرده خوراک جداگانه انجام دهید.
عیب یابی و رفع اشکال
پس از آپلود فایل‌های خود (فایل‌های توصیفگر و فید) به داشبورد تاریخچه فید ( مستندات ) در پورتال شریک بروید (به History > Feeds بروید) تا پیشرفت دریافت فید خود را دنبال کنید.
به دنبال name که وارد کرده‌اید در فایل توصیفگر در ستون "نام فید" بگردید تا فید خود را پیدا کنید.
هنگامی که فید خورده شد (وضعیت Success یا Fail است) می توانید روی ردیف آن کلیک کنید تا جزئیات خطاها و هشدارها را ببینید.