הפידים מספקים את נתוני המלאי שלכם ל-Actions Center. ההעלאה היומית הזו באמצעות פרוטוקול מאובטח להעברת קבצים (SFTP) מעדכנת את כל הנתונים של המוכרים, השירותים ומשבצות הזמינות. בפידים מציינים באילו מוֹכרים אתם תומכים, את הזמינות שלהם ואת כל התכונות המיוחדות שנדרשות כדי לוודא ש-Google מציגה את המלאי שלכם בצורה נכונה. הפידים מועלים לתיקיות SFTP בענן שהוגדרו כשסיפקתם את מפתח ה-SSH בהגדרה.
לפני שמתחילים להשתמש בשרת ההזמנות, צריך להשלים את המשימות הבאות שקשורות לפידים:
המשימות יסומנו כהושלמו ויהפכו לירוקות אחרי שתעלו את הפידים בהצלחה. כדי להשלים כל משימה ספציפית של אבן דרך, צריך לעיין בתיעוד המקושר.
כדי שהשילוב של הזמנות במסעדות מקצה לקצה יפעל בצורה תקינה, צריך להעלות באופן אוטומטי מדי יום פיד של מוצרים, פיד של שירותים ופיד של זמינות. התשתית של הפיד האוטומטי צריכה לספק את המלאי המלא שלכם.
סוגי פידים
שילובים של הזמנות במסעדות מקצה לקצה דורשים את הפידים הבאים ואת תדירות ההעלאה שלהם:
| פיד | תיאור | תדירות | דוגמה |
|---|---|---|---|
| המוֹכרים | תיאור של המוֹכרים. | אחת ל-24 שעות | דוגמה לפיד של מוצרים |
| שירותים | תארו את השירותים של המוכרים שלכם. | אחת ל-24 שעות | דוגמה לפיד שירותים |
| זמינות | תיאור של משבצות הזמן הפנויות לשירותים של העסק. צריך לספק נתונים על תקופה של 30 יום לפחות. כדי להאריך את תקופת הכיסוי ל-90 ימים, צריך לפנות לתמיכה של Google באמצעות טופס הפנייה במרכז הפעולות. | אחת ל-24 שעות | פיד זמינות לדוגמה |
פורמטי הפידים מתוארים באמצעות תחביר של protocol buffer 3, אבל אפשר להעלות את הפידים בפורמט JSON המתאים. דוגמאות לפורמט JSON מופיעות במאמר על פידים. מומלץ להעלות את הפידים בפורמט JSON.
מוסכמות מתן שמות ומטא-נתונים
שמות הקבצים
אם אתם משתמשים בפיצול, הפידים שאתם מעלים צריכים להיות בעלי שמות ייחודיים שמציינים את סוג הפיד ואת המספר שלו. חותמת זמן של יצירת הפיד עומדת בדרישה הייחודית של מתן שמות לקובץ הפיד.
מבנה: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
דוגמה: availability_feed_1574117613_001_of_002.json.gz
הגדרת מזהים
כשמגדירים מזהים למוכרים או למאפיינים אחרים שנדרש להם מזהה, מומלץ מאוד להשתמש במזהי UID או UUID. אתם יכולים לספק פתרון אלפאנומרי משלכם, כל עוד המזהים נשארים ייחודיים בפלטפורמה שלכם.
מטא-נתונים
כשיוצרים פידים, הערך של generation_timestamp צריך לשקף את השעה שבה הנתונים נשלפו ממסד הנתונים. שימוש חוזר בערך הזה בפידים שונים עלול להוביל לשגיאות עיבוד.
ערכי Nonce, מספרים אקראיים או לא חוזרים, חייבים להיות ייחודיים בכל סוגי הפידים ולא ניתן לעשות בהם שימוש חוזר. הערך חייב להיות זהה בכל הקבצים של פיד משורד ספציפי.
גודל קובץ הפיד
פיצול קבצים של פידים
בהתאם למלאי שלכם, יכול להיות שתצטרכו לפצל את הפידים לכמה קבצים. יכול להיות שתצטרכו לפצל את הפידים שלכם במקרים הבאים:
- פיד דחוס בפורמט gzip גדול מ-200MB לקובץ אחד.
- דוגמה: פיד הזמינות שנוצר הוא בנפח 1GB. הנתונים צריכים להיות מחולקים לחמישה או יותר שברים נפרדים.
- מלאי של שותפים מפוזר במערכות או באזורים שונים, ולכן קשה לבצע התאמה בין נתוני המלאי.
- דוגמה: לשותף יש מלאי שטחי פרסום בארה"ב ובאיחוד האירופי, שמאוחסן במערכות נפרדות.
יכול להיות שהפיד נוצר עם שני רסיסים. אחד לארה"ב ואחד לאיחוד האירופי עם אותו ערך nonce ואותו ערך
generation_timestamp.
- דוגמה: לשותף יש מלאי שטחי פרסום בארה"ב ובאיחוד האירופי, שמאוחסן במערכות נפרדות.
יכול להיות שהפיד נוצר עם שני רסיסים. אחד לארה"ב ואחד לאיחוד האירופי עם אותו ערך nonce ואותו ערך
מידע נוסף זמין במאמר בנושא הדרכות ושיטות מומלצות לגבי פיצול קבצים של פידים.
פיד יכול לכלול כמה קבצים שנקראים shards. כדי לקבוע את גודל הפידים, אפשר להיעזר בהנחיות הבאות:
- פיצול הפיד המוצע:
- פיד של מוצרים: שבר אחד.
- פיד שירותים: רסיס אחד.
- פיד זמינות: פחות מ-20 רסיסים. אם יש לכם הצדקה עסקית שדורשת סכום גבוה יותר מהסכום שצוין, פנו לתמיכה לקבלת הוראות נוספות.
- גודל קובצי הפיד ופיצול:
- גודל הקובץ של כל שבר צריך להיות קטן מ-200MB אחרי הדחיסה. אם צריך, אפשר להשתמש בכמה שרדים.
- אין צורך לשלוח רשומות בודדות שנשלחו בשבר אחד באותו שבר בפידים עתידיים.
- כדי לשפר את הביצועים, כדאי לפצל את הנתונים באופן שווה בין הפצלים כדי שגודל כל קובצי הפצלים יהיה דומה.
- אם צריך, משתמשים ב-gzip כדי לדחוס פידים של JSON בטקסט פשוט לכל חלק פיד בנפרד.
דחיסת קבצים של פידים
אפשר לדחוס כל קובץ JSON או PB3 באמצעות gzip לפני ההעלאה. כך אפשר להקטין באופן משמעותי את גודל הקובץ של פידים יומיים.
כל קובץ shard צריך להיות בפורמט gzip ולהיות מועלה בנפרד, למשל gzip*.json. שברי פיד דחוסים חייבים להסתיים ב- .json.gz או ב- .pb3.gz.
העלאת הפידים לתיבת הדואר הנכנס ב-SFTP
אחרי שיוצרים את פיד המוצרים, פיד השירותים ופיד הזמינות, אפשר להעלות אותם לסביבת ארגז החול או לסביבת הייצור דרך תיבת הדואר הנכנס של SFTP. תיבת הדואר הנכנס של SFTP מוגדרת כשמספקים את מפתח ה-SSH בהגדרה.
שרת ה-SFTP של Google זמין בכתובת sftp://partnerupload.google.com ביציאה 19321.
Google בודקת ומאמתת את קובצי הפידים מיד אחרי שהם מועלים לתיקייה בענן ב-SFTP. אם הפיד מחולק לכמה קבצים, המערכת תעבד אותם אחרי שתעלו את הקובץ האחרון. אם הפיד מכיל שגיאות, יישלח אליכם אימייל עם קודי השגיאות בפיד. אם יש שגיאות, אי אפשר להוסיף את המוכרים, השירותים או הזמינות שהוגדרו. אחרי שהפידים מאומתים, יכולות לחלוף עד 24 שעות עד שהם יופיעו בחלק הגלוי למשתמשים.