עדכונים

קודם כל צריך ליצור את הפידים, ולאחר מכן Google בודקת אותם.

יצירת פידים

1. יוצרים את הפידים. רוב נתוני המלאי שלך נשלחים ל-Google על ידי פידים. כדי להתחיל, יוצרים פיד של מוכר (ופיד שירותים, אם רלוונטי):

   • פיד מוכרים: פיד המוכרים מתאר את הקישורים שלכם למוכרים ואת הקישורים לביצוע הפעולות ברמת המוכר.
   • פיד שירותים (אופציונלי / לא מומלץ): לא מומלץ להטמיע פידים של שירותים לשילובים חדשים למתחילים. אם רוצים לשמור על השילוב הקיים, צריך לפעול לפי מסמכי התיעוד הקודמים.

   שדות חובה ושדות מומלצים

   פיד	שם השדה	תיאור	חובה?
   מוֹכר	merchant_id	מזהה ייחודי של המוכר	כן
   מוֹכר	name	שם המוכר	כן
   מוֹכר	geo	הכתובת והקואורדינטות הגיאוגרפיות של המוכר	כן
   מוֹכר	הטלפון	מספר הטלפון של המוכר	כן
   מוֹכר	קטגוריה	סוג המקום של המוכר	מומלץ
   מוֹכר	פעולה_קישור	מידע בנוגע לקישורי עומק ספציפיים למוכר	כן
   מוֹכר	action_link_type	סוג פעולת הקישור. שותפים להזמנות אוכל צריכים להשתמש בACTION_LINK_TYPE_MAKE_DINING_RESERVATION. שותפים להזמנות אוכל צריכים לעיין במדריך להזמנה של איסוף עצמי לעומת משלוח.	כן
   מוֹכר	food_ordering_metadata	מציינים עמלות &זמני אספקה להזמנת אוכל.	מומלץ
   מוֹכר	brand_id [מזהה_מותג]	מחרוזת שמאפשרת לזהות את המותג שפונה לצרכנים	אופציונלי

   הערה: צריך להתעלם מכל השדות הנוספים שמפורטים בקטע ההפניה.
   נקודת מפתח: חובה להעלות רק פיד מוֹכר.

   קודם כול, כדאי לעיין בפידים לדוגמה

   • פידים של הזמנת מקומות במסעדה
   • פיד למשלוחי אוכל
   • פיד אוכל באיסוף עצמי
   • פידים של הזמנת אוכל באמצעות מטא-נתונים

   מידע נוסף על ציון קישורי פעולה בפידים של שילוב Starter זמין כאן.

   יש לכלול מטא-נתונים של הפיד בכל אחד מהפידים, שמלמד את Google איך לפרש את הפיד.

   בהמשך מופיע קטע קוד של מטא-נתונים של פיד:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }
   

   הערה: יש להעלות את כל הפידים עם process_instruction process_AS_COMPLETE. process_AS_INCREMENTAL הוצאה משימוש ולא ניתן להשתמש בה.
   הערה: אפשר גם לשלב את השילוב עם Reserve with Google מקצה לקצה או כתוסף מקצה לקצה. כדי לתמוך בו, יהיה עליך להטמיע גם פידים של זמינות והשדות הנדרשים לשילוב מקצה לקצה, בהתאם למדריך הזה.

2. מייצאים את הפידים. הפורמט של הפידים מתואר בתחביר של מאגר הנתונים הזמני בין פרוטוקולים, אבל כדאי לעיין בדוגמאות לדוגמה שצוינו למעלה כדי לראות את פורמט ה-JSON. מומלץ להעלות את הפידים בפורמט JSON.

   אם ברצונך להמשיך לעבוד עם פורמט pb3, במאמר הכללי Protocol Buffer Basics: Java מוסבר איך משתמשים במאגר נתונים זמני כדי ליצור קובץ pb3.

3. מעלים את הפידים ל-SFTP Dropbox. כדי להעלות את הפידים, יש להשתמש בפרטי חשבון SFTP ש-Google סיפקה לך ובמפתח הפרטי שיצרת בהגדרה. שרת ה-SFTP של Google זמין ב-sftp://partnerupload.google.com ביציאה 19321.

   יש להעלות קבצים עם שמות ייחודיים, כמו שם שכולל חותמת זמן. שמות ייחודיים עוזרים בפתרון בעיות ומאפשרים שאילתות לסטטוס הפיד.

   כדי לקבוע את גודל הפידים ואת תדירות השליחה, יש לפעול לפי ההנחיות הבאות:

   • הגודל של קובצי וקטעי הפיד:
     • הגודל של קובץ הפיד צריך להיות קטן מ-200MB (לאחר דחיסת הנתונים). אפשר לדחוס את הקבצים באמצעות gzip
     • אם הקובץ יכול להגיע ליותר מ-200MB (לאחר הדחיסת הנתונים), יש לפצל אותו לחלק מהפיצולים לפי המדריך פיצול קובצי הפיד . עם זאת, סביר להניח שההטמעה למתחילים לא תגיע למגבלה של 200MB.
   • תדירות העדכונים המלאים:
     • פיד מלא של מוכר מסופק פעם ביום.
     • (אם יושמה) פיד שירות מלא מסופק פעם ביום.
   הערה: Google מעבדת קובצי פיד ברגע שהם מועלים לתיקייה בענן של SFTP. אם הפיד מחולק למספר קבצים, התהליך יתחיל לאחר העלאת הקובץ האחרון. אם הפיד מכיל שגיאות, תקבלו אימייל עם קודי השגיאות בפיד.

Google בודקת פידים

אחרי העלאת הפידים, Google מעבדת ומעריכה אותם כדי לבדוק את האיכות והשלמות שלהם. אנחנו בודקים כמה גורמים:

• הפידים עומדים במפרט.
• הפידים כוללים את כל שדות החובה.
• לכל מוכר יש לפחות שירות אחד (action_link) או שירות אחד לפחות שבו מוגדר action_link.
• רוב הנתונים של המוכר תואמים למיקומים במפות Google.

הערה: כדי להבטיח שההטמעה תבוצע בצורה חלקה, צריך לבצע הערכה מראש של הגורמים שלמעלה, חוץ מהאחרון, לפני ששולחים את הפידים.