يتيح صندوق تحميل الخلاصة العامة تحميل أنواع متعددة من الخلاصات إلى صندوق تحميل واحد لكل بيئة. سيشرح هذا الدليل كيفية استخدام صندوق البريد الإلكتروني العميق العام وسيقدّم روابط إلى الدليل المناسب للخلاصة المعنية التي تخطّط لاستخدامها.
(يُرجى الرجوع إلى القسم تصدير الخلاصات (من البداية إلى النهاية) أو الخلاصات (مبتدئ) في المستندات).يعتمد صندوق التحميل "عام" على وجود عمليتَي تحميل منفصلتين:
- ملف الواصف: يصف نوع الخلاصة الذي ستستخدمه جارٍ التحميل
- ملفات الخلاصة: محتوى الخلاصة الفعلية
تنظيم حقل الوصف
يتم تحميل ملف الوصف لإعلام نظامنا بنوع الخلاصة الذي تستخدمه. جديدة. يتيح لنا ذلك التحقّق من صحة الخلاصة ومعالجتها بشكل صحيح. يجب تحميل ملف الوصف قبل محتوى الخلاصة، ويجب أن يستوفي متطلبات التسمية التالية:
- يجب استخدام امتداد الملف
.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 ميغابايت (بعد الضغط).
- يجب أن يكون كل حجم ملف بيانات تم فك ضغطه أقل من 2 غيغابايت.
- لن تحتاج معظم عمليات الدمج إلى استخدام شريحة واحدة فقط. يجب استخدام أقل عدد ممكن من الشرائح. الحد الأقصى لعدد الأجزاء في الخلاصة هو 1000 جزء.
- لا يلزم إرسال السجلات الفردية المرسلة في جزء واحد في جزء واحد رقم الجزء في الخلاصات المستقبلية.
- للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء، لجعل حجم كل ملف من الملفات متشابهًا.
- استخدِم gzip لضغط الخلاصات إذا لزم الأمر. ومع ذلك، عليك إجراء ذلك لكل جزء فردي من الخلاصة.
تحديد المشاكل وحلّها
بعد تحميل ملفاتك (ملف الوصف وملف الخلاصة)، انتقِل إلى لوحة بيانات سجلّ الخلاصات (المستندات) في "بوابة الشركاء" (انتقِل إلى السجلّ > الخلاصات) لمتابعة مستوى تقدّم نقل الخلاصة.
ابحث عن الرمز name الذي أدخلته في ملف الوصف في عمود "اسم الخلاصة" للعثور على خلاصتك.
بعد نقل بيانات الخلاصة (الحالة هي Success أو Fail)، يمكنك النقر على
صفها للاطّلاع على تفاصيل الأخطاء والتحذيرات.