שלב 2: פידים

קודם צריך ליצור את הפידים, ואז Google בודקת אותם.

יצירת פידים

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

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

   שדות נדרשים ומומלצים

   פיד	שם השדה	תיאור	חובה?
   מוֹכר	merchant_id	מזהה ייחודי של המוכר	כן
   מוֹכר	שם	שם המוכר	כן
   מוֹכר	geo	הכתובת והקואורדינטות הגיאוגרפיות של המוכר	כן
   מוֹכר	טלפון	מספר הטלפון של המוכר	כן
   מוֹכר	קטגוריה	סוג המקום של המוכר	מומלץ
   מוֹכר	action_link	מידע לגבי קישורי עומק ספציפיים למוכר	כן
   מוֹכר	action_link_type	סוג הפעולה בקישור. שותפים של Reservations Business Link צריכים להשתמש ב-ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
   מוֹכר	brand_id	מחרוזת שמזהה את המותג שמוצג לצרכנים	אופציונלי

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

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

   • פידים של הזמנות למסעדות

   כאן אפשר לקרוא מידע נוסף על ציון קישורי פעולה בפיד השילוב של Reservations Business Link.

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

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

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

   הערה: צריך להעלות את כל הפידים עם processing_instruction‏ PROCESS_AS_COMPLETE. האפשרות PROCESS_AS_INCREMENTAL הוצאה משימוש ואי אפשר להשתמש בה.
   הערה: אפשר להטמיע את השילוב הזה גם בשילוב עם השילוב מקצה לקצה של Actions Center, או כתוסף לשילוב מקצה לקצה. כדי לתמוך בכך, תצטרכו גם להטמיע פידים של זמינות ואת השדות הנדרשים לשילוב מקצה לקצה, בהתאם למדריך הזה.

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

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

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

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

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

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

Google בודקת את הפידים

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

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

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