הפיד הוא מקור הנתונים המרכזי שבו Google משתמשת כדי לגשת אל כלי רכב. כרגע אנחנו תומכים בפידים פורמט קובץ CSV, שאפשר לדחוס את הנתונים שלהן בפורמט ZIP או GZ.
יצירת פיד
כדי לעצב את הפרטים בפורמט המתאים לשירות כרטיסי המוצר של כלי הרכב, צריך להשתמש בפורמט שמתואר בפורמט פיד, המאפיינים שסופקו מפרט הפיד, פיד לדוגמה. מומלץ להתחיל עם כמה בדיקות רכבים, ולשלוח קובץ CSV לדוגמה כלי האימות כדי לאמת את פורמט הפיד. בהמשך אפשר להרחיב את הרשימה כדי לכלול את כל מלאי שטחי הפרסום ב-Google.
חשוב לכלול את הפרטים הבאים בפיד כדי שנוכל לדעת בדיוק התאמה בין רכבים לבין סוכנויות רכב ב-Google:
- חובה: קוד חנות
- לפרטים נוספים אפשר לעיין בקטע סוכנות רכב התאמה.
- חובה: השם והכתובת למשלוח דואר של הסוכנות
- מומלץ: מזהה מקום ב-Google או כתובת URL של מפות Google
- הנתונים האלה מזהים באופן ייחודי את פרופיל העסק של הסוכנות ב-Google, וגם להסיר כל אי בהירות בהשוואה להתאמות שמשתמשות בשם ובמיקוד address.
פורמט פיד
צריך להעלות את הפיד כערכים מופרדים בפסיקים (CSV) או בפורמט של קובץ מופרד בטאבים. קובץ ערכים (TSV). ודאו שהקובץ עומד בדרישות הבאות:
- פורמט ה-CSV חייב להיות תואם לפורמט
RFC 4180:
- אין לכלול מירכאות כפולות בשום מקום בקובץ, אלא אם הן מסומנות בתו בריחה (escape).
- כדי לסמן בתו בריחה (escape) מירכאות כפולות, יש להשתמש בשתי מירכאות כפולות, וכן צריך להקיף את כל שדה ה-CSV במירכאות כפולות. פרטים נוספים זמינים במאמר סעיפים 2.5-2.7 ב RFC 4180.
- דוגמה לשימוש חוקי במירכאות כפולות היא
"Wheels 17"" Alloy", שמוצג כ-Wheels 17" Alloy.
- אין לכלול מירכאות כפולות בשום מקום בקובץ, אלא אם הן מסומנות בתו בריחה (escape).
- אפשר לדחוס את הקובץ בפורמט קובץ ZIP או GZ.
- הפיד חייב להכיל קובץ אחד. אנחנו לא תומכים בשימוש בריבוי מקטעי קובץ, שנקראים גם פיצול (sharding).
- כל גרסת פיד חייבת לכלול את כל המלאי של כל סוכנויות הרכב שאתם שרוצים להציג ב-Google. כי כל קובץ פיד מכיל מלאי שטחי פרסום אין צורך ליצור חשבונות נפרדים לכל סוכנות של הסוכנות. אחרי עיבוד הפיד, כלי הרכב הנתונים מקובצים לפי סוכנות בדף 'אבחון' בפורטל השותפים.
- אנחנו לא תומכים בעדכונים חלקיים (מצטברים) של מלאי.
פיד לדוגמה
אפשר להשתמש בפיד ה-CSV הבא לדוגמה כתבנית ליצירת פידים:
store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"
מעלים את הפיד לחשבון SFTP
כשנרשמים לחשבון כרטיסי מוצר של רכבים, חשבון SFTP הוא נוצר באופן אוטומטי. צריך להשתמש בפרטי ה-SFTP שמופיעים בדף פיד של בפורטל לשותפים, כדי להעלות את קובצי ה-CSV שלכם.
יש הרבה שיטות העלאת קובץ באמצעות SFTP. ברוב הדרכים הנפוצות הן שימוש בשורת הפקודה (Terminal), או שימוש תוכנת SFTP. איזו שיטה המתאימה ביותר עבורך תלויה באופן שבו אתה מנהל את המלאי שלך. לכן, אנחנו לא צריך לספק כאן הוראות ספציפיות לייצוא ולהעלאה של כלי הרכב שרת ה-SFTP של Google.
כדי למנוע עיכובים בעיבוד הפיד שלכם ב-Google, מומלץ לעשות זאת הבאים:
- מוודאים שהפיד עובר את כלי האימות.
- צריך לוודא שנתוני הרכב עומדים בדרישות של מפרט הפיד, המדיניות וההגבלות.
- לשלוח את הפיד לפחות פעם ביום.
- מעלים את כל המלאי של כל סוכנות שרוצים להציג ב-Google.
בדיקת התוצאות של עיבוד הפיד
אחרי ששולחים את הפיד, אפשר לבדוק את תוצאות העיבוד. הסטטוס של כל העלאת פיד מוצג בדף פיד בפורטל השותפים. הזה בודק רק אם יש בעיות בסיסיות בקובץ ובנתונים, כמו שדות חובה חסרים או פורמט שגוי. תוצאות העיבוד המלאות יהיו זמינות אבחון אחרי מספר שעות.
ניהול הפיד
מומלץ להעלות את הגרסה העדכנית ביותר של הפיד כל ארבע שעות. יש שתי סיבות עיקריות לכך שמומלץ לרענן את הפיד לעיתים קרובות:
- העלאות פיד בתדירות גבוהה יותר משפרות את עדכניות הנתונים הכוללת. כתוצאה מכך משך הזמן בין מועד עדכון המלאי לבין מסירת הנתונים ל-Google.
- עדכונים תכופים מאפשרים זיהוי מהיר יותר של הפסקות זמניות בשירות והתאוששות מהן מה שעלול לגרום לכך שלא יהיה אפשר לעבד את הפיד.
בכל פעם שמעלים את הפיד, חשוב לוודא שהוא מכיל את כל המלאי סוכנויות רכב. סוכנויות רכב ורכבים שלא כלולים בפיד יוסרו מ-Google תוך מספר שעות.
אחרי שמעלים פיד ל-Google, משך הזמן שעובר עד שהנתונים מתעדכנים תלוי בסוג העדכון. המספרים בטבלה הבאה הם אומדנים ולא מובטחת.
| שינוי בפיד | שעת העדכון הצפויה ב-Google |
|---|---|
| הוספה של סוכנות חדשה | יום אחד |
| הסרה של סוכנות | 6 שעות |
| שינוי פרופיל העסק של סוכנות | 12 שעות |
| הוספה, הסרה ועדכון של מכונית | 6 שעות |
הרשמה לקבלת התראות על פידים
תוכלו לקבל התראה באימייל כש-Google לא קיבלה פיד, או שהעיבוד של הפיד נכשל במשך יותר מ-24 שעות. נכנסים אל חשבון בפורטל השותפים, ולהוסיף כתובת אימייל חדשה ליצירת קשר שרוצים לקבל התראות פיד אלה.