פיד מחירים

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

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

  • USD
  • CAD
  • AUD
  • GBP

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

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

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

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

  • 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"
  }
]