استخدام خادم SFTP العام

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

يعتمد خادم بروتوكول النقل الآمن للملفات (SFTP) العام على عمليتَي تحميل منفصلتَين:

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"
  ]
}

تنظيم محتوى الخلاصة

بعد تحميل ملف الواصف، عليك تحميل جميع ملفات الخلاصة لنوع بيانات الخلاصة المتوافق مع ملف إعدادات الخلاصة الذي يحمل الاسم نفسه الذي يحمله ملف الواصف. يجب أن تتطابق أسماء الملفات ومواقع المسارات (ذات الصلة داخل خادم SFTP) تمامًا مع ما تم تضمينه في الحقل data_file. في حال كان أي ملف ناقصًا أو يحمل اسمًا غير صحيح أو تم تحميله إلى موقع مختلف، لن تتم معالجة الخلاصة بأكملها.

يجب أن يتوافق محتوى ملفات بيانات الخلاصة هذه مع المواصفات ذات الصلة بالخلاصة المحدّدة في ملف الواصف.

يجب أن يكون اسم ملف كل خلاصة فريدًا ولا يمكن إعادة استخدامه في عمليات التحميل المختلفة. ننصحك بتضمين الطابع الزمني للإنشاء ورقم التقسيم (رقم تعريف تزايدي) في اسم الملف.

• مثال: offers_1524606581_1.json

أحجام ملفات الخلاصة ومعدّل تكرار التحميل

• يجب أن يكون حجم ملف الخلاصة أقل من 200 ميغابايت (بعد الضغط).
• يجب أن يكون حجم كل ملف بيانات غير مضغوط أقل من 2 غيغابايت.
• لن تحتاج معظم عمليات الدمج إلى استخدام جزء واحد فقط. يجب استخدام أقل عدد ممكن من الأجزاء. الحدّ الأقصى هو 1,000 جزء لكل خلاصة.
• لا يلزم إرسال السجلات الفردية التي تم إرسالها في جزء واحد ضمن رقم الجزء نفسه في الخلاصات المستقبلية.
• للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء، وذلك لجعل جميع ملفات الأجزاء متشابهة في الحجم.
• استخدِم gzip لضغط الخلاصات عند الضرورة. ومع ذلك، يجب إجراء ذلك لكل جزء من أجزاء الخلاصة.

تحديد المشاكل وحلّها

بعد تحميل ملفاتك (ملفات الواصفات وملفات الخلاصة)، انتقِل إلى أداة عرض عملية الاستيعاب (المستندات) في "بوابة الشريك" (انتقِل إلى الاستيعاب > السجلّ) لتتبُّع تقدّم عملية استيعاب الخلاصة.

ابحث عن name الذي أدخلته في ملف الواصف في عمود "اسم الخلاصة" للعثور على خلاصتك.

بعد استيعاب الخلاصة (الحالة Success أو Fail)، يمكنك النقر على الصف الخاص بها للاطّلاع على تفاصيل الأخطاء والتحذيرات.