يتيح صندوق تحميل الخلاصة العامة تحميل أنواع متعددة من الخلاصات إلى صندوق تحميل واحد لكل بيئة. سيرشدك هذا الدليل إلى كيفية استخدام صندوق التحميل العام وسيوفر روابط إلى الدليل المناسب للخلاصة المعنية التي تريد استخدامها.
يعتمد صندوق التحميل العام على وجود عمليتَي تحميل منفصلتين:
- ملف الوصف: يصف نوع الخلاصة التي ستحمّلها
- ملفات الخلاصة: محتوى الخلاصة الفعلية
هيكلة حقل الواصف
يتم تحميل ملف الوصف لإعلام نظامنا بنوع الخلاصة التي تحمّلها. ويتيح لنا ذلك التحقق من الخلاصة ومعالجتها بشكل صحيح. يجب تحميل ملف الواصف قبل محتوى الخلاصة، كما يجب أن يستوفي متطلبات التسمية التالية:
- استخدام امتداد الملف .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 ما يلي:
- reservewithgoogle.conversion_data
في ما يلي مثال على ملف واصف بتنسيق JSON لخلاصة عروض تتضمّن جزأين:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
تنظيم محتوى الخلاصة
بعد تحميل ملف الوصف، سيتم تحميل جميع ملفات الخلاصة
لنوع بيانات الخلاصة المقابل لملف إعداد الخلاصة الذي يحمل
اسم ملف الوصف. ويجب أن تتطابق تمامًا أسماء الملفات ومواقع المسارات (النسبية داخل
صندوق التحميل) مع ما تم تضمينه في
الحقل data_file. إذا كان أي ملف غير متوفّر أو تمت تسميته بشكل غير صحيح أو
تم تحميله إلى موقع آخر، لن تتم معالجة الخلاصة بالكامل.
ويجب أن يتطابق محتوى ملفات بيانات الخلاصة هذه مع المواصفات ذات الصلة بالخلاصة التي تم تحديدها في ملف الوصف.
يجب أن يكون كل اسم ملف للخلاصة فريدًا ولا يمكن إعادة استخدامه في مختلف عمليات التحميل. وننصحك بتضمين الطابع الزمني للإنشاء ورقم الجزء (المعرّف المتزايد) في اسم الملف.
- مثال: offers_1524606581_1.json
أحجام ملفات الخلاصة ومعدّل التحميل
- يجب ألا يزيد حجم ملف الخلاصة عن 200 ميغابايت (بعد الضغط).
- ستحتاج معظم عمليات الدمج إلى استخدام جزء واحد فقط. يجب استخدام أقل عدد ممكن من الأجزاء. الحد الأقصى لعدد الأجزاء في الخلاصة الواحدة 1,000 جزء.
- ولا يجب إرسال السجلات الفردية التي يتم إرسالها في جزء واحد إلى رقم الجزء نفسه في الخلاصات المستقبلية.
- للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء لجعل جميع ملفات الأجزاء متشابهة في الحجم.
- ويمكنك استخدام gzip لضغط الخلاصات إذا لزم الأمر. ويجب تنفيذ ذلك مع كل جزء فردي من الخلاصة.
تحديد المشاكل وحلّها وتصحيح الأخطاء
بعد تحميل ملفاتك (ملفات الوصف وملفات الخلاصة)، انتقِل إلى لوحة بيانات سجلّ الخلاصات (المستندات) في "بوابة الشريك" (انتقِل إلى السجلّ > الخلاصات) لمتابعة مستوى تقدّم عملية عرض الخلاصة.
ابحث عن name التي أدخلتها في ملف الوصف في عمود "اسم الخلاصة" للعثور على خلاصتك.
بعد نقل الخلاصة (الحالة هي Success أو Fail)، يمكنك النقر على صفها للاطّلاع على تفاصيل الأخطاء والتحذيرات.