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