פידים למתחילים (קודמים)

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

יצירת פידים

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

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

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

   פיד	שם השדה	התיאור	חובה?
   מוֹכר	merchant_id	המזהה הייחודי של המוכר.	כן
   מוֹכר	name	שם המוכר	כן
   מוֹכר	geo	הכתובת והקואורדינטות הגיאוגרפיות של המוכר	כן
   מוֹכר	טלפון	מספר הטלפון של המוכר	כן
   מוֹכר	category	סוג המקום של המוכר	נחמד שיהיה
   מוֹכר	action_link	מידע בנוגע לקישורי עומק ספציפיים למוכרים	אופציונלי אם מספקים פידים של שירות, אחרת יש לציין אותם
   מוֹכר	brand_id	מחרוזת שמזהה את המותג שמיועד לצרכנים שבהם צריך להשתמש	אופציונלי
   שירותים	service_id	המזהה הייחודי של השירות שסופק על ידי המוכר	כן (רק אם סופק פיד שירותים)
   שירותים	merchant_id	קישור אל המוכר שמספק את השירות הזה	כן (רק אם סופק פיד שירותים)
   שירותים	localized_service_name	שם השירות שניתן	כן (רק אם סופק פיד שירותים)
   שירותים	localized_description	תיאור שירות שגלוי למשתמש	אופציונלי
   שירותים	action_link	מספק מידע על קישורי עומק שקשורים לשירות	כן (רק אם סופק פיד שירותים)
   שירותים	סוג	סוג קישור העומק (למשל SERVICE_TYPE_DINING_RESERVATION)	כן (רק אם סופק פיד שירותים)

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

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

   • פידים להזמנת אוכל
   • פיד הזמנות ממסעדות
   • פיד לאיסוף הזמנות אוכל
   • פידים של הזמנות אוכל עם מטא-נתונים
   • פידים של הזמנות מחנויות
   • פידים של הזמנות קמעונאיות עם מטא-נתונים
   • פידים לפגישות אישיות
   • פידים אונליין/ווירטואליות לפגישות

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

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

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

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

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

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

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

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

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.

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