استخدام صندوق إسقاط الخلاصة العامة

يتيح صندوق تحميل الخلاصة العامة تحميل أنواع متعددة من الخلاصات إلى صندوق تحميل واحد لكل بيئة. سيشرح هذا الدليل كيفية استخدام صندوق التحميل عام وتوفير الروابط للدليل المناسب للمحتوى التي تخطط لاستخدامها.

يعتمد صندوق التحميل "عام" على وجود عمليتَي تحميل منفصلتين:

1. ملف الواصف: يصف نوع الخلاصة الذي ستستخدمه جارٍ التحميل
2. ملفات الخلاصة: محتوى الخلاصة

هيكلة حقل الواصف

يتم تحميل ملف الوصف لإعلام نظامنا بنوع الخلاصة الذي تستخدمه. جديدة. يتيح لنا ذلك التحقّق من صحة الخلاصة ومعالجتها بشكل صحيح. تشير رسالة الأشكال البيانية أن يتم تحميل ملف الوصف قبل محتوى الخلاصة متطلبات التسمية التالية:

• استخدام امتداد الملف .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)، يمكنك النقر على صفّها للاطّلاع على تفاصيل الأخطاء والتحذيرات.