חשבון פיד כללי מאפשר להעלות מספר סוגי פידים לתיקייה בענן אחת לכל סביבה. במדריך הזה מוסבר איך להשתמש בתיקיית חשבון גנרית, וניתן למצוא בו קישורים למדריך המתאים עבור הפיד המתאים, שבו מתכננים להשתמש.
התיקייה הכללית בענן מסתמכת על שתי העלאות נפרדות:
- קובץ תיאור: מתאר את סוג הפיד שאתם מתכוונים להעלות
- קובצי הפיד: התוכן של הפיד עצמו.
הגדרת המבנה של שדה התיאור
מתבצעת העלאה של קובץ התיאור כדי שהמערכת שלנו תזהה את סוג הפיד שברצונך להעלות. כך אנחנו יכולים לאמת ולעבד את הפיד בצורה נכונה. צריך להעלות את קובץ התיאור לפני תוכן הפיד, והוא צריך לעמוד בדרישות הבאות למתן שמות:
- שימוש בסיומת הקובץ .filesetscore.json
- כל שם של קובץ מתאר חייב להיות ייחודי, ואי אפשר לעשות בו שימוש חוזר בהעלאות. מומלץ
לכלול את חותמת הזמן של היצירה בשם הקובץ.
- לדוגמה: offers_1524606581.filesetreset.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
הגודל של קובצי הפיד ותדירות ההעלאה
- גודל קובץ הפיד צריך להיות קטן מ-200MB (לאחר דחיסה).
- ברוב השילובים יהיה צורך להשתמש בפיצול אחד בלבד. עדיף להשתמש בכמה שפחות פיצולים. אפשר לשתף עד 1,000 פיצולים לכל פיד.
- רשומות נפרדות שנשלחות בפיצול אחד לא צריכות להישלח באותו מספר פיצול בפידים עתידיים.
- לביצועים טובים יותר, כדאי לפצל את הנתונים באופן שווה בין הפיצולים, כדי שכל קובצי הפיצול יהיו דומים בגודלם.
- במידת הצורך, משתמשים ב-gzip כדי לדחוס פידים. עם זאת, צריך לעשות זאת עבור כל פיצול נפרד של פיד.
פתרון בעיות וניפוי באגים
אחרי שמעלים את הקבצים (קובצי תיאור ופידים) אפשר לעבור אל מרכז השליטה של היסטוריית הפידים (תיעוד) בפורטל לשותפים (עוברים אל היסטוריה > פידים) כדי לעקוב אחר ההתקדמות של הטמעת הנתונים של הפיד.
כדי למצוא את הפיד, צריך לחפש בעמודה 'שם הפיד' את name שהזנת בקובץ התיאור.
אחרי הטמעת הפיד (הסטטוס הוא Success או Fail), אפשר ללחוץ על
השורה שלו כדי לראות את פרטי השגיאות והאזהרות.