פיד מחירים

פיד המחירים מכיל פרטי תמחור לכל מסלולי השייט. הוא כולל את המחיר הכי זול לחדר בשיט לכל סוג מטבע. אפשר להעלות פידים של מחירים בפורמט CSV.

המטבעות הבאים זמינים ב-Google:

  • USD
  • CAD
  • AUD
  • GBP

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

רכיבים מרכזיים

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

הוא כולל את שדות החובה הבאים:

  • ‫sail_id: מזהה ייחודי של הפלגה לנסיעה ספציפית.

  • ‫currency_code: קוד מטבע ייחודי בן שלוש אותיות של המטבע הספציפי.

  • ‫cruise_line: שם חברת הקרוזים.

  • ‫starting_price: המחיר הכולל של מסלול השייט, כולל מיסים.

  • ‫sail_url: כתובת ה-URL של דף הנחיתה שבו מוצג מידע על המחיר.

שדות

שם השדה חובה? סוג תיאור
sail_id Required string מזהה ייחודי של הפלגה לנסיעה מסוימת במסלול הטיול עם תאריך התחלה ותאריך סיום. לדוגמה, אם יש מסלול נסיעה של 5 לילות עם 3 עצירות, הערך של sail_id הוא ייחודי ונשאר זהה לכל 3 העצירות. דוגמה ל-sail_id היא ABC12345.

הערה: הערכים sail_id ו-currency_code משורשרים כדי ליצור מפתח ראשי מורכב, והם חייבים להיות ייחודיים.
currency_code Required currency קוד המטבע בן שלוש האותיות של המחיר. לדוגמה, ‫currency_code יכול להיות USD.

הערה: הערכים sail_id ו-currency_code משורשרים כדי ליצור מפתח ראשי מורכב, והם חייבים להיות ייחודיים.
cruise_line Required string השם של חברת הקרוזים. cruise_line הוא חובה למוכרים שהם אגרגטורים ומוכרים בשם חברות אחרות. לדוגמה: Norwegian Cruise Line.
starting_price Required decimal המחיר הכולל של מסלול השייט, כולל מיסים. המחיר הכולל, כולל מיסים ומחיר השייט. הערך הזה צריך להיות זהה לערך שמוצג באתר השותף כשפותחים את כתובת ה-URL של המבצע. לדוגמה 1000.00.
sail_url Required URL כתובת ה-URL של דף הנחיתה שבו מוצגים פרטי המחיר. לדוגמה, https://partner.com/path.html&id=XYZ12345
offer_desc Optional string תיאור של המבצע שמשויך למחיר או לשם המחלקה. לדוגמה, Inside Cabin.
image_url Optional URL כתובת ה-URL של תמונה שמייצגת את מסלול הנסיעה. התמונה צריכה להיות קשורה לחלקים הפנימיים של אוניית הקרוז, למשל תמונה של תא הנוסעים, הסיפון ומתקנים אחרים באונייה. התמונה לא חייבת להיות של הבקתה הספציפית שמופיעה בפרטים. אפשר להשתמש בתמונה אחרת של תא הנוסעים. דוגמה ל-image_url היא https://partner.com/images/XXXXX.jpg
brand_name Optional string מפתח משני שמאפשר להשתמש בכמה sail_url לאותו sail_id ו-currency_code. לדוגמה, Fancy Crusies.
updated_at Optional datetime התאריך והשעה שבהם הרשומה הזו עודכנה בפעם האחרונה, לפי זמן אוניברסלי מתואם(UTC). המידע הזה שימושי לזיהוי נתונים לא עדכניים. התאריך צריך להיות בפורמט ISO 8601. לדוגמה, updated_at הוא 2025-01-22T00:00:00+00:00.

דוגמאות

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

בדוגמאות מוצגים שני הפורמטים: CSV ו-JSON. השדות sail_id ו-currency_code מחוברים כדי ליצור את המפתח הראשי המורכב, והם חייבים להיות ייחודיים בכל שורה.

CSV

שדות חובה

זו דוגמה לשדות החובה בפיד מחירים:

sail_id; currency_code; cruise_line; starting_price; sail_url
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345

כל השדות הזמינים

הדוגמה הבאה היא דוגמה לכל השדות הזמינים בפיד מחירים:

sail_id; currency_code; cruise_line; starting_price; sail_url; offer_desc; image_url; brand_name; updated_at
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Fancy Cruises; 2025-06-20T00:00:00+00:00
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00

‫JSON (למטרות מידע)

שדות חובה

זו דוגמה לשדות החובה בפיד מחירים:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  }
]

כל השדות הזמינים

הדוגמה הבאה היא דוגמה לכל השדות הזמינים בפיד מחירים:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Fancy Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]