שלב 2: פיד של נקודות עניין

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

אפשרות 1: כלי להמרת כרטיסי מוצר לנקודות עניין

כדי לצמצם את החיכוך הטכני בהשקה הראשונית, אנחנו מציעים כלי המרה זמני לשותפים בתחום האירוח. הכלי הזה מאפשר לשותפים להשתתף מהר יותר בתוכנית על ידי המרת פידים קיימים של רשימות מלונות מ-Hotel Center לפורמט החדש של נקודות עניין (POI) שעומד בדרישות ב-Actions Center. הפתרון הזה משמש רק כגשר מעבר, כדי להבטיח שתהיה לכם נראות מיידית ביחידות החדשות, אבל אנחנו ממליצים לשותפים לתכנן הטמעה משלהם של פיד נתוני מיקום לטווח הארוך.

שלבים לשותפים להמרת נקודות עניין:

  • לא נדרשת פעולה להגדרה: אצל שותפים נבחרים, ההמרה מופעלת כברירת מחדל. לא צריך ליצור פיד חדש באופן מיידי. אתם יכולים להמשיך לעדכן את כרטיסי המלונות ב-Hotel Center כרגיל, והפידים שהומרו יוצגו ב-Action Center כשהם יהיו זמינים.
  • עדכונים שוטפים: הכלי להמרת נתונים מופעל כמה פעמים בשבוע, באותו קצב כמו פיד כרטיסי המלונות. מומלץ לעדכן את כרטיסי המלונות ב-Hotel Center כרגיל כדי לוודא שהעדכונים נקלטים באופן עקבי.

אפשרות 2: יצירת פיד עצמאי של נקודות עניין

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

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

השלבים להטמעה של פיד נקודות העניין (POI) עבור שותפים:

  1. פורמט הפיד: כדי להבין את פורמט ה-JSON הנדרש ולבנות את נתוני הנכס, אפשר לעיין במפרט של פיד נקודות העניין.
  2. יוצרים זוג מפתחות SSH: פועלים לפי ההוראות להגדרת SSH כדי ליצור זוג מפתחות SSH ציבורי ופרטי.
  3. שיתוף המפתח הציבורי: שולחים באימייל את קובץ המפתח הציבורי שנוצר (<keyname>.pub) לצוות ההצטרפות של Google כדי להגדיר את הגישה ל-SFTP.
  4. העלאת הפיד: אחרי ש-Google תגדיר את מפתח ה-SSH, תקבלו שם משתמש. באמצעות שם המשתמש והמפתח הפרטי, אפשר להעלות את קובצי ה-JSON של נקודות העניין באמצעות SFTP:
    • כתובת ה-URL של שרת ה-SFTP: sftp://partnerupload.google.com
    • יציאת SFTP: 19321
    • אריזת הקובץ: צריך לשלב את כל רשומות הנכסים בקובץ JSON אחד. קובץ המטען הייעודי (payload) בתוך הארכיון חייב להיות קובץ JSON (לדוגמה, feed.json). מומלץ לדחוס אותו לארכיון יחיד בפורמט GZIP או ZIP (עדיף GZIP) ולהעלות אותו. נדרש ארכיון JSON מצטבר יחיד.
    • המלצה: כדי להבטיח שנתוני הנכס יישארו עקביים בכל המערכות, מומלץ לשלוח את פיד נקודות העניין באותה תדירות שבה אתם שולחים את פיד כרטיסי המלונות הקיים (HLF).
  5. אימות ההעלאה: כדי לוודא שהפיד התקבל ולבדוק את סטטוס ההעלאה שלו, עוברים אל הדף Ingestion viewer > History (כלי לבדיקת העלאות > היסטוריה) במרכז הפעולות.