שימוש בתיבת ה-dropbox של הפיד הגנרי

תיבת ה-dropbox של הפיד הגנרי מאפשרת להעלות כמה סוגים של פידים לתיבת dropbox אחת לכל סביבה. במדריך הזה נסביר איך להשתמש ב-Generic Dropbox ונספק קישורים למדריך המתאים לפי הפיד שבו אתם מתכננים להשתמש.

כדי להשתמש בתיבת הדואר הנכנס הגנרית, צריך לבצע שתי העלאות נפרדות:

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

מבנה תוכן הפיד

אחרי העלאת קובץ המתאר, תצטרכו להעלות את כל קובצי הפיד של סוג נתוני הפיד שתואם לקובץ התצורה של הפיד ששמו מופיע בקובץ המתאר. שמות הקבצים ומיקומי הנתיבים (ביחס ל-dropbox) חייבים להיות זהים לפרטים שכללו בשדה data_file. אם קובץ חסר, השם שלו שגוי או שהוא הועלה למיקום אחר, כל הפיד לא עובד.

התוכן של קובצי נתוני הפיד האלה חייב להתאים למפרט הרלוונטי של הפיד שצוין בקובץ המתאר.

כל שם קובץ של קובץ פיד צריך להיות ייחודי, ואי אפשר לעשות בו שימוש חוזר בהעלאות שונות. מומלץ לכלול בשם הקובץ את חותמת הזמן של היצירה ואת מספר הפלח (המזהה המצטבר).

• דוגמה: offers_1524606581_1.json

גודל הקבצים של הפיד ותדירות ההעלאה

• גודל קובץ הפיד צריך להיות קטן מ-200MB (אחרי דחיסת הנתונים).
• גודל כל קובץ נתונים ללא דחיסה צריך להיות קטן מ-2GB.
• ברוב השילובים יהיה צורך להשתמש רק בחלק אחד. מומלץ להשתמש בכמה שפחות פלחים. אפשר ליצור עד 1,000 פלחים לכל פיד.
• אין צורך לשלוח רשומות נפרדות שנשלחו באותה שריד באותו מספר שריד בפידים עתידיים.
• כדי לשפר את הביצועים, כדאי לפצל את הנתונים באופן שווה בין הפיצולים, כך שכל קבצי הפיצול יהיו בגודל דומה.
• אם צריך, משתמשים ב-gzip כדי לדחוס פידים. עם זאת, צריך לעשות זאת לכל שריד פיד בנפרד.

פתרון בעיות וניפוי באגים

אחרי העלאת הקבצים (קובץ התיאור וקובצי הפיד), עוברים אל מרכז הבקרה של היסטוריית הפיד (מסמכי עזרה) בפורטל השותפים (עוברים אל היסטוריה > פידים) כדי לעקוב אחרי התקדמות הטמעת הפיד.

כדי למצוא את הפיד, מחפשים את הערך name שהזנתם בקובץ המתאר בעמודה 'שם הפיד'.

אחרי שהפיד יאוחסן (הסטטוס שלו יהיה Success או Fail), תוכלו ללחוץ על השורה שלו כדי לראות את פרטי השגיאות והאזהרות.