שימוש בתיבת הדואר הנכנס של פיד כללי

תיבת ה-dropbox של הפיד הגנרי מאפשרת להעלות כמה סוגים של פידים לתיבת 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. אם חסר קובץ, קיבל שם שגוי, או מועלה למיקום אחר, אז לא ניתן להעלות את כל הפיד עבר עיבוד.

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

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

• דוגמה: offer_1524606581_1.json

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

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

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

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

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

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