במאמר הזה נסביר איך מפעילים את Menu API בחשבון ומשתמשים בו. בהמשך מופיעה סקירה כללית מפורטת של תהליך ההצטרפות והדרישות המוקדמות להשקה. מומלץ לעיין בדף הזה כשמתכננים את תהליך השילוב.
- הגדרה – הגדרת החשבון ותכנון תהליך הפיתוח.
- פיתוח – פיתוח ובדיקה של פידים של נתונים.
- השקה – הערכת נתונים לפני ההשקה.
הגדרה
בשלב הזה חשוב לוודא שהחשבון שלכם בפורטל השותפים מוגדר במלואו ומוכן לקבל פידים של נתונים שרלוונטיים לנתוני תפריטים סטטיים. אם יש לכם שילוב פעיל של OwG Redirect או RwG Redirect שאליו אתם מוסיפים את המטא-נתונים של התפריטים, המערכת תשתמש שוב בחשבון הקיים בשילוב הזה. במקרים שבהם יש שילוב של OwG Direct בפלטפורמה הזו או שאין שילוב בכלל, נוצר חשבון חדש ופרטי הגישה משותפים באימייל.
נכנסים לחשבון בפורטל השותפים ועוברים לדף ההגדרות של Dropbox Configuration > Feeds. יש שני תיבות נפתחות שרלוונטיות לשילוב של פיד נתוני תפריט: Generic ו-Merchants. צריך לוודא שהמפתח הציבורי של SSH מוגדר בשתי התיקיות בענן. מידע נוסף על הגדרת מפתחות SSH זמין בדף הזה.
תיבת הדואר הנכנס הגנרית יכולה לקבל פידים שונים שיכולים לפעול לפי סכימות נתונים שונות. סוג הפיד שמקבל נתוני תפריט מובְנים נקרא google.food_menu, ובדרך כלל הוא מופעל בחשבון כברירת מחדל בתחילת תהליך ההצטרפות. אם ניסיתם לשלוח פיד וקיבלתם את הודעת השגיאה הזו:
"עיבוד הפיד נכשל. נתקלנו בבעיה פנימית במהלך ניתוח הפיד שלך. האפשרות 'google.food_menu' לא מופעלת. יש לתקן את הבעיה ולנסות שוב", עליכם לפנות לאיש הקשר שלכם ב-Google כדי להפעיל את סוג הפיד הזה.
לבסוף, עליך לעבור לדף Configuration > Contact Information ולוודא שכל הפרטים ליצירת קשר מעודכנים.
פיתוח
שלב הפיתוח מכיל את החלק העיקרי של מאמצי ההטמעה – יצירת פידים של נתונים ובדיקת הפיד. צריך ליצור פידים של נתונים ולשלוח אותם לתיבת הדואר הנכנס של היעד מדי יום. עיבוד הפיד שנשלח לארגז החול אמור להתחיל תוך שעה ממועד השליחה. פידים בסביבת הייצור מעובדים פעם ביום בשעה 12:00 (שעון החוף המערבי של ארה"ב) – רק הפיד האחרון שנשלח מעובד. מומלץ לעיין במפרט ובדוגמאות של פיד הנתונים בזמן העבודה על יצירת הפידים. למרות שהמפרט מוצג בפורמט protobuf, מומלץ להעלות קובצי פיד בפורמט JSON כי קל יותר לפתור בעיות. לכן, גם טעימות הפיד מוצגות בפורמט JSON.
אפשר לבדוק במהירות קובץ אחד של פיד נתונים באמצעות הכלי האינטרנטי לאימות פידים, שמאמת אם הקובץ תואם למפרט. הכלי מראה אם הקובץ תואם לסכימת הנתונים, ואם לא – הוא יוצר רשימה של השגיאות. כדי לבדוק פיד נתונים שלם שמורכב מכמה קבצים, מעלים את הפיד הזה בסביבת ה-sandbox. אחרי השלמת הטמעת הנתונים, אפשר לראות את התוצאות בפורטל השותפים. במהלך הטמעת הפיד, חלים כללי אימות נוספים כדי לבדוק חלק מהלוגיקה העסקית ואת איכות הנתונים.
הפעלה
אפשר להתחיל את שלב ההשקה אחרי שכל עבודות השילוב יושלמו ופיד הייצור ישקף בצורה נכונה את מלאי התפריטים של המסעדות.
דרישות מוקדמות להפעלה
כדי שהשילוב יופעל, צריך לעמוד בתנאים הבאים:
- פידים של נתונים עוברים עיבוד בסביבת הייצור ללא שגיאות.
- פיד הנתונים בסביבת הייצור מכיל את מלאי שטחי הפרסום המלא שהוגדר לשילוב הזה בתחילת השילוב.
- רוב נתוני המוכרים שלכם תואמים למיקומים במפות Google.
- הפידים בסביבת הייצור עברו את בדיקת איכות הנתונים.
- השילוב עומד בכל המדיניות והדרישות לגבי תפריטי מזון.
הערכת נתונים
אחרי שהטמעת הנתונים של פידים בסביבת הייצור תתבצע ללא שגיאות, יכול להיות שיתבצע תהליך פנימי להערכת האיכות של נתוני התפריטים. המטרה של התהליך הזה היא למצוא חוסר עקביות באיכות הנתונים, כמו תוכן שלא קשור לאוכל בתיאורי המנות, חוסר התאמה בשמות המנות, במחירים וכו'. במקרה של ממצאים כאלה, המשוב ישותף עם צוות הפיתוח.