מאמר זה מסביר את תהליך ההפעלה של ממשק ה-API לתפריטים בחשבון ושל השילוב איתו. כאן יש סקירה מפורטת של תהליך ההצטרפות והדרישות המוקדמות להשקה. כדאי לעיין בדף הזה בתכנון מאמצי השילוב.
- הגדרה - הגדרת החשבון ותכנון תהליך הפיתוח.
- פיתוח – פיתוח ובדיקה של פידים של נתונים.
- השקה – הערכת נתונים לפני ההשקה.
הגדרה
בשלב הזה חשוב לוודא שהחשבון שלך בפורטל השותפים מוגדר במלואו ומוכן לקבל פידים של נתונים שרלוונטיים לנתוני התפריט הסטטי. אם יש לך שילוב פעיל של OwG Redirect או RwG שאליו מוסיפים את המטא-נתונים של התפריטים, ייעשה שימוש חוזר בחשבון הקיים לשילוב הזה. במקרים שבהם יש שילוב ישיר של OwG בפלטפורמה הזו או שאין שילוב בכלל, ייווצר חשבון חדש ופרטי הגישה ישותפו באימייל.
נכנסים לחשבון בפורטל השותפים ועוברים לדף של הגדרות התיקייה בענן הגדרות > פידים. יש שתי תיבות בענן שרלוונטיות לשילוב פיד הנתונים של התפריט: כללי ומוכרים. אתם צריכים לבדוק שבשתי התיקייה בענן מוגדר המפתח הציבורי SSH. מידע נוסף על ההגדרה של מפתחות SSH זמין בדף הזה.
התיקייה הגנרית בענן יכולה לקבל פידים שונים שיכולים להתאים לסכימות שונות של נתונים. סוג הפיד
שמקבל נתונים של תפריטים מובְנים נקרא google.food_menu. בדרך כלל
הוא מופעל בחשבון שלך כברירת מחדל בתחילת
תהליך ההצטרפות. אם אתם מנסים לשלוח פיד וקיבלתם את הודעת השגיאה הבאה:
"עיבוד הפיד נכשל. נתקלנו בבעיה פנימית במהלך ניתוח
הפיד שלך. האפשרות 'google.food_menu' לא מופעלת. יש לתקן את השגיאה ולנסות שוב", יש לפנות לאיש הקשר שלכם ב-Google כדי להפעיל את סוג הפיד הזה.
לסיום, צריך לעבור לדף הגדרה > פרטים ליצירת קשר ולוודא שכל הפרטים ליצירת קשר מעודכנים.
פיתוח
שלב הפיתוח כולל את החלק העיקרי במאמץ ההטמעה – יצירה ובדיקה של הפידים של הנתונים. צריך ליצור פידים של נתונים ולשלוח אותם לתיקיית היעד בענן בכל יום. עיבוד הפידים שנשלחים ב-Sandbox צפוי להתחיל בתוך שעה לאחר השליחה. פידים בסביבת ייצור מעובדים פעם אחת בכל יום בשעה 12:00 לפי אזור הזמן PST. לעיבוד הנתונים האלה מתבצע רק הפיד האחרון שנשלח. כשיוצרים את הפידים, מומלץ לעיין במפרט ובדוגמאות של פיד הנתונים. למרות שהמפרט מוצג בפורמט protobuf, מומלץ להעלות קובצי פיד בפורמט JSON, כי קל יותר לפתור את הבעיות. לכן, דוגמאות הפיד גם הן בפורמט JSON.
אפשר לבדוק קובץ אחד של פיד נתונים במהירות באמצעות הכלי לאימות פידים באינטרנט שמאמת אם הקובץ תואם למפרט. הכלי מראה אם הקובץ תואם לסכימת הנתונים, ואם לא, מייצר פלט של רשימת השגיאות. כדי לבדוק פיד נתונים שלם שמורכב מכמה קבצים, צריך להעלות את הפיד לסביבת ה-Sandbox ובסיום הטמעת הנתונים, לעיין בתוצאות בפורטל השותפים. במהלך הטמעת הנתונים של הפיד, חלים כללי אימות נוספים שבוחנים לוגיקה עסקית מסוימת ואת איכות הנתונים.
הפעלה
אפשר להתחיל את שלב ההשקה אחרי שכל פעולות השילוב יושלמו, ופיד הייצור ישקף בצורה נכונה את כל מלאי התפריטים של המסעדות.
דרישות מוקדמות להפעלת מודעות
התנאים הבאים צריכים להתקיים כדי שהשילוב יופעל:
- העיבוד של פידים של נתונים בסביבת הייצור מתבצע עם 0 שגיאות.
- פיד הנתונים של סביבת הייצור מכיל את כל מלאי שטחי הפרסום בהיקף של השילוב הזה בתחילת השילוב.
- רוב נתוני המוכרים תואמים למיקומים במפות Google.
- הפידים בסביבת הייצור עברו הערכה של איכות הנתונים.
- השילוב עומד בכל כללי המדיניות והדרישות של תפריט אוכל.
הערכת נתונים
אחרי הטמעת הפידים של נתוני הייצור ללא שגיאות, יכול להיות שיהיה תהליך פנימי להערכת האיכות של נתוני התפריט. התהליך הזה נועד לאתר חוסר עקביות באיכות הנתונים. למשל, תוכן שלא קשור לאוכל בתיאורי המנות, חוסר התאמה בשמות המנות, במחירים וכו'. במקרה של ממצאים כאלה, המשוב יועבר לצוות הפיתוח.