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