12 سؤالًا ينبغي طرحها عند اختيار Hotel Mapping API
عند اختيار hotel mapping API اسألوا كيف تُقاس الدقة، وهل التغطية صالحة لمناطقكم، وكيف تُعالج المطابقات الملتبسة، وهل المعرّفات دائمة، وما دعم الغرف وأنظمة الوجبات، وطرق التسليم، وعملية تصحيح الأخطاء، وشروط الخروج. وتحققوا من كل إجابة بتجربة على بيانات مورّديكم أنتم.
- الكاتب
- فريق تحرير hotelmapping.org
- آخر تحديث:
- 9 دقيقة للقراءة
كيف تُستخدم هذه القائمة؟
يَعِد معظم مزوّدي مطابقة الفنادق بدقة عالية وتغطية واسعة وتكامل سهل. وعندما تتشابه الوعود يُختزل الاختيار بسهولة في السعر وانطباع العرض التجريبي. بينما الفروق في التفاصيل: كيف تُقاس الدقة، وماذا يحدث للسجلات الملتبسة، وكيف يتصرف المعرّف عند إغلاق فندق، وهل يدخل مستوى الغرف ونظام الوجبات ضمن التغطية.
تجمع الأسئلة الـ12 التالية، التي ينبغي طرحها عند تقييم hotel mapping API، المواضيع في خمسة أقسام. لكل سؤال كتبنا لماذا هو مهم وكيف تتحققون من الإجابة. القائمة محايدة؛ ويمكن تطبيقها على كل مزوّد بالطريقة نفسها، ومنهم hotelmapping.org.
إذا كان الموضوع جديدًا عليكم فننصح بقراءة دليل ما هي مطابقة الفنادق أولًا. وقد شرحنا الجانب الثابت والديناميكي لروابط الموردين في مقالة تكامل XML للفنادق.
جودة البيانات
1. كيف تُقاس الدقة وما معدل المطابقات الخاطئة؟
لماذا هو مهم: المطابقة الخاطئة أغلى غالبًا من المطابقة الفائتة. فإذا اندمج فندقان مختلفان في سجل واحد فقد يحجز العميل في الفندق الخطأ؛ وهذا يعني إلغاءً وشكوى وكلفة إضافية. وقد لا تعني كلمة “الدقة” الشيء نفسه عند كل مزوّد: فقد تُحسب النسبة على المطابقات التلقائية فقط، أو مع إدراج السجلات التي مرت بمراجعة بشرية.
كيف يُتحقق: اسألوا على أي مجموعة اختبار جرى القياس: كم زوج فنادق، ومن أي مناطق، ومن وسمها، ومتى آخر قياس؟ اطلبوا معدل المطابقات الخاطئة (false positive) ومعدل المطابقات الفائتة (false negative) كلًا على حدة. ثم أرسلوا عينة من بيانات مورّديكم وافحصوا النتائج يدويًا مع فريقكم.
2. ما المناطق والموردون الذين تصدق عليهم نسبة التغطية؟
لماذا هو مهم: قد لا تعكس نسبة التغطية العالمية الوضع في المناطق التي تبيعونها. فمناطق المنتجعات المتوسطية، بما فيها من منشآت كثيرة بالاسم نفسه ومواقع متقاربة، ميدان صعب. كما تتوقف التغطية على ما إذا كان المزوّد يعالج أصلًا بيانات موردي كم.
كيف يُتحقق: قدّموا قائمة الموردين الذين تعملون معهم واطلبوا نسبة تغطية منفصلة لكل منهم. واطلبوا نتيجة بحسب المنطقة للوجهات الأكثر مبيعًا لديكم (مثل أنطاليا ومغلا وإسطنبول). واسألوا هل تُحسب نسبة التغطية على إجمالي السجلات أم على السجلات النشطة القابلة للبيع.
3. كيف تُعالَج المطابقات غير المؤكدة؟
لماذا هو مهم: تولّد معظم أنظمة المطابقة درجة مطابقة وتستخدم قيم عتبة. وما يُفعل بالسجلات غير قاطعة الدرجة يحدد الجودة مباشرة: هل تُطابَق تلقائيًا رغم ذلك، أم يفحصها خبير، أم يُفتح سجل جديد؟
كيف يُتحقق: اسألوا عن قيم العتبة وما يحدث في كل نطاق. واطلبوا نسبة السجلات التي تقع في المراجعة البشرية ومتوسط مدة القرار. وانظروا هل تعود الدرجة إليكم في رد API؛ فإذا عادت أمكنكم تطبيق عتبة أشد من جانبكم.
الهوية ودورة الحياة
4. هل المعرّف دائم، وماذا يحدث للفنادق المغلقة والمدموجة والمنفصلة؟
لماذا هو مهم: يُكتب معرّف المطابقة في سجل حجوزاتكم وجداول المحتوى والتقارير. وإذا أُعطي معرّف لفندق آخر من جديد أو حُذف بصمت فسدت بياناتكم التاريخية.
كيف يُتحقق: اسألوا كتابيًا هل يُعاد إعطاء المعرّف لفندق آخر. وإذا اندمج فندقان فاطلبوا رد مثال يبيّن هل يُحوَّل المعرّف القديم إلى الجديد وكيف يظهر ذلك في API (مثلًا حقل status أو merged_into). وانظروا هل تُعلَّم الفنادق المغلقة بوصفها غير نشطة.
5. هل تستطيعون نقل معرّفاتكم ورموزكم الحالية؟
لماذا هو مهم: لا يبدأ معظم الفرق من الصفر. قد تكون لديكم رموز فنادق خاصة بكم أو معرّفات خدمة مطابقة استخدمتموها سابقًا. وإذا لم يستطع المزوّد الجديد حفظها مراجع متقاطعة ارتفعت كلفة الانتقال.
كيف يُتحقق: أرسلوا مثالًا من جدول المطابقة الحالي لديكم وانظروا هل تعود المعرّفات القديمة مع المعرّفات الجديدة. واسألوا عند التعارض (حين يختلف جدولكم عن نتيجة المزوّد) أيهما يُعتمد وهل تُبلَّغون بهذه الفروق.
6. كيف تُبلَّغ تغييرات رموز الموردين؟
لماذا هو مهم: يحذف الموردون رموزًا ويعطون رموزًا جديدة ويعيدون إدراج فندق برمز آخر. وإذا لم تصلكم هذه التغييرات تقادم جدول المطابقة لديكم بصمت، وظهرت في البحث فنادق مفقودة أو سجلات مكررة.
كيف يُتحقق: اسألوا عبر أي قناة تُبلَّغ التغييرات: delta dump أو webhook أو نقطة نهاية لسجل التغييرات. وانظروا هل ترد السجلات المحذوفة والمدموجة صراحةً في delta. واطلبوا ملف delta مثالًا لآخر شهر.
عمق التغطية
7. هل توجد مطابقة للغرف وكيف تعمل؟
لماذا هو مهم: لا تكفي مطابقة الفنادق وحدها لمقارنة الأسعار. فإذا كانت “DBL SV” و“Double Room Sea View” و“Deniz Manzaralı Çift Kişilik Oda” الغرفة نفسها فينبغي ربطها بمعرّف واحد أيضًا. وإلا ظهرت الغرفة نفسها عدة مرات في بطاقة الفندق نفسها.
كيف يُتحقق: اسألوا هل مطابقة الغرف منتج مستقل أم مشمولة في مطابقة الفنادق. واعرفوا هل تعمل فوريًا (بحسب الاستدعاء) أم دفعة واحدة. وأرسلوا أسماء غرف صعبة من بياناتكم (مختصرة، متعددة اللغات، غرف عائلية، غرف متصلة) وانظروا النتائج. وللتفاصيل راجعوا صفحة مطابقة الغرف.
8. هل مطابقة أنظمة الوجبات والوجهات مدعومة؟
لماذا هو مهم: في سوق المنتجعات يُعد نظام الوجبات من العوامل الرئيسية في تحديد السعر. وإذا لم تُحوَّل صيغ مثل “AI” و“All Inclusive” و“Ultra Her Şey Dahil” و“Soft AI” إلى رمز قياسي فقد تُقارَن أنظمة وجبات مختلفة في صف السعر نفسه. وفي الوجهات يرسل الموردون المنطقة نفسها بتسلسلات هرمية مختلفة (مثلًا مورّد “Antalya” وآخر “Belek”).
كيف يُتحقق: اطلبوا قائمة رموز أنظمة الوجبات القياسية المدعومة. وأرسلوا صيغ الوجبات الواردة من موردي كم وانظروا إلى أي رمز تُحوَّل. وفي الوجهات اسألوا هل تُحفظ مستويات البلد والمحافظة والقضاء والمنطقة السياحية كلًا على حدة.
9. كيف تُعالَج الأسماء والعناوين متعددة اللغات؟
لماذا هو مهم: قد يصل الفندق نفسه لدى مورّد بحروف لاتينية وفي آخر بحروف كيريلية أو عربية. والأحرف التركية (ç, ğ, ı, ö, ş, ü) تتشوه أو تسقط في بعض الأنظمة. وتصعّب هذه الفروق المطابقة القائمة على تشابه الأسماء.
كيف يُتحقق: اسألوا كيف يجري النقل الحرفي (transliteration) وتطبيع الأحرف. وأدرجوا في العينة فنادق وصلت بأسماء روسية أو عربية وسجلات تشوهت فيها الأحرف التركية. وقيّموا النتائج في هذه المجموعة الفرعية على حدة.
التكامل التقني والتشغيل
10. ما طرق التسليم والحدود وحداثة البيانات؟
لماذا هو مهم: تُستخدم نتيجة المطابقة لحظة البحث. والذهاب إلى API بعيد في كل بحث قد يسبب تأخيرًا؛ ولذلك يحفظ معظم الفرق النتائج في جدول من جانبهم. فتسليم الملفات الشاملة (dump) لا يقل أهمية عن API.
كيف يُتحقق: اطلبوا التفاصيل التالية كتابيًا:
- نقاط نهاية API وأمثلة الطلب/الرد
- حدود الاستدعاءات (بالدقيقة واليوم والشهر) وما يحدث عند تجاوزها
- صيغ dump الكامل وdelta (CSV وJSON وParquet وغيرها) ووتيرة النشر
- دعم webhook
- المدة اللازمة لمطابقة ملف مورّد جديد
- بيئة التجربة (sandbox)، وهل التوثيق متاح للجميع
شغّلوا في بيئة التجربة لعدة أيام تدفقًا قريبًا من حمل عملكم الفعلي.
11. ماذا يحدث عند الإبلاغ عن مطابقة خاطئة؟
لماذا هو مهم: لا يخلو أي نظام من الأخطاء. والفرق في سرعة تصحيح الخطأ وهل يتكرر. وإذا كانت عملية التصحيح غامضة اضطر فريقكم إلى ترقيع السجلات الخاطئة يدويًا من جانبه.
كيف يُتحقق: اسألوا عن قناة الإبلاغ عن الأخطاء (API أو بوابة أو بريد إلكتروني) ومدة التصحيح المستهدفة. واعرفوا هل يُطبَّق التصحيح في حسابكم فقط أم لدى كل العملاء. وانظروا هل في العقد مستوى خدمة (SLA) وهل لغة الدعم تناسب فريقكم. وأبلغوا عمدًا عن خطأ أثناء التجربة وتابعوا العملية من أولها إلى آخرها.
الشروط التجارية
12. ما نموذج السعر وشروط التجربة والخروج؟
لماذا هو مهم: قد تُسعَّر خدمات المطابقة بحسب عدد الموردين أو الفنادق أو الاستدعاءات أو وحدة المنتج. وإذا لم يتوافق النموذج مع خطة نموّكم ارتفعت الكلفة بصورة غير متوقعة. كما أن إمكانية الاستمرار في استخدام نتائج المطابقة بعد انتهاء العقد تحدد كلفة الانتقال.
كيف يُتحقق: انظروا هل السعر مكتوب بوضوح، وأي الوحدات مشمولة، وهل ثمة رسوم إضافية للمورّد. واسألوا هل تتوفر تجربة مجانية أو بيئة اختبار (sandbox). واطلبوا كتابيًا بأي صيغة يمكن تصدير البيانات عند انتهاء العقد وشروط الترخيص.
الأسئلة الـ12 بنظرة واحدة
| # | السؤال | الدليل المطلوب | العلامة التي ينبغي الانتباه لها |
|---|---|---|---|
| 1 | كيف تُقاس الدقة؟ | وصف مجموعة الاختبار، نتيجة على عينتكم | نسبة واحدة بلا شرح للطريقة |
| 2 | ما التغطية في مناطقكم؟ | نسبة بحسب المورّد والمنطقة | نسبة عالمية فقط |
| 3 | ماذا يحدث للمطابقات الملتبسة؟ | قيم العتبة، نسبة المراجعة البشرية | عدم عودة الدرجة في API |
| 4 | هل المعرّف دائم؟ | رد مثال للدمج والإغلاق | إمكانية إعادة استخدام المعرّف |
| 5 | هل تُنقل المعرّفات الحالية؟ | مخرجات مثال بمراجع متقاطعة | ضياع الرموز القديمة |
| 6 | هل تُبلَّغ تغييرات الرموز؟ | ملف delta مثال | غياب السجلات المحذوفة من delta |
| 7 | هل توجد مطابقة للغرف؟ | نتيجة اختبار بأسماء غرف صعبة | إرجاع نص حر فقط |
| 8 | هل الوجبات والوجهات مدعومة؟ | قائمة رموز قياسية، مثال للتسلسل الهرمي | خروج أنظمة الوجبات عن النطاق |
| 9 | هل تُعالَج الأسماء متعددة اللغات؟ | اختبار بسجلات كيريلية وعربية | انخفاض ملحوظ في هذه المجموعة الفرعية |
| 10 | ما التسليم والحدود؟ | التوثيق، sandbox، مثال dump | عدم وجود خيار التسليم الشامل |
| 11 | كيف تُصحَّح الأخطاء؟ | قناة الإبلاغ، المدة المستهدفة، SLA | عملية تصحيح غامضة |
| 12 | ما السعر وشروط الخروج؟ | سعر مكتوب، حق التصدير | تعذر استخدام البيانات بعد انتهاء العقد |
مثال: ماذا تنظرون في رد المطابقة؟
ردود API التي تحصلون عليها أثناء التقييم تجيب عن كثير من الأسئلة أعلاه بنظرة واحدة. نعرض فيما يلي مثالًا لرد POST /v1/match في API v1 لدى hotelmapping.org لفندق وهمي؛ وقد تختلف أسماء الحقول لدى مزوّدين آخرين.
الطلب:
{
"reference": "res-20417",
"name": "Kemer Pine Garden Hotel",
"address": "Göynük Mah. Atatürk Cad. No:45, Kemer, Antalya",
"lat": 36.6515,
"lng": 30.5601,
"supplier": "C",
"supplier_code": "KPG-7781"
}
الرد:
{
"reference": "res-20417",
"hm_id": "HM-1061590",
"confidence": 0.984,
"decision": "auto_match",
"status": "active",
"merged_into": null,
"destination_id": "TR-07-KEMER-GOYNUK",
"external_ids": { "client": "OTL-2231" },
"supplier_codes": { "A": "KPGH-1102", "C": "KPG-7781" },
"matched_at": "2026-11-15T09:20:00Z"
}
هذه بيانات مثال؛ واسم الفندق والعنوان والرموز لا تخص منشأة حقيقية. وأسماء الحقول تتبع API v1 وقابلة للتغيير. انظروا في هذا الرد إلى ما يلي:
confidenceوdecision: هل تعود الدرجة ونوع القرار؟ (السؤال 3)statusوmerged_into: هل تظهر حالة الإغلاق والدمج؟ (السؤال 4)external_ids: هل تُنقل رموز الفنادق الخاصة بكم أو معرّفات مزوّدكم الحالي؟ (السؤال 5)supplier_codes: هل رموز الموردين الآخرين للفندق نفسه في سجل واحد؟ (السؤال 6)destination_id: هل تأتي الوجهة بمعرّف قياسي ضمن تسلسل هرمي؟ (السؤال 8)
تفاصيل Find Match API في صفحتي Find Match API ومطابقة الفنادق، وقائمة نقاط النهاية في صفحة المطورين.
كيف تُنظَّم التجربة؟
للحصول على إجابات الأسئلة بالبيانات بدلًا من العروض التقديمية تكفي خطة تجربة قصيرة:
- جهّزوا العينة: أعدّوا قائمة سجلات من كل موردي كم، ومن المناطق الأكثر مبيعًا، ومن الحالات الصعبة (فنادق بالاسم نفسه، منشآت متقاربة الموقع، أسماء متعددة اللغات).
- حدّدوا الإجابات الصحيحة مسبقًا: طابقوا جزءًا من هذه القائمة يدويًا مع فريقكم. هذا هو المعيار الذي ستقارنون به نتائج المزوّد.
- أرسلوا البيانات نفسها إلى كل المرشحين: لتكون المقارنة عادلة ينبغي أن يتلقى كل مزوّد الملف نفسه.
- قيسوا النتائج على حدة: استخرجوا أرقامًا منفصلة للمطابقات الخاطئة والمطابقات الفائتة والسجلات الواقعة في المراجعة البشرية ومدة التسليم.
- اختبروا التشغيل: أبلغوا عن خطأ، واطلبوا ملف delta، وجرّبوا حدود API.
- خذوا شروط العقد كتابيًا: ينبغي أن ترد في العرض صراحةً الأسعار وSLA وحق تصدير البيانات.
ويساعدكم حساب كلفة السجلات المكررة على عملكم في تحويل نتائج التجربة إلى أثر تجاري. وللاطلاع على ذلك راجعوا مقالة كلفة الفنادق المكررة.
اطرحوا هذه الأسئلة على hotelmapping.org أيضًا
لم نُعدّ هذه القائمة لصالح مزوّد؛ ونتوقع أن تطرحوا الأسئلة نفسها على hotelmapping.org. وستُنشر قيم الدقة والتغطية المقيسة لدينا، عند اكتمال مجموعة الاختبار، في صفحة التغطية. وقد شرحنا في صفحة طلب عرض السعر كيف يُحدَّد التسعير بحسب الوحدات وعدد الموردين. وإذا كنتم تقارنون عدة مزوّدين فقيسوا النتائج على مجموعة البيانات نفسها؛ وقد شرحنا كيف تُقرأ أرقام الدقة والتغطية معًا في مقالة الدقة أم التغطية؟.
الأسئلة الشائعة
ما الفرق بين الدقة والتغطية؟
تبيّن الدقة نسبة المطابقات المنجزة الصحيحة فعلًا. وتبيّن التغطية نسبة سجلات الموردين التي أمكن ربطها بفندق. قد يكون أحدهما مرتفعًا والآخر منخفضًا؛ لذلك ينبغي السؤال عنهما على حدة وعلى مجموعة البيانات نفسها.
كم بيانات تكفي للتجربة؟
لا يوجد رقم محدد. المهم أن تمثل العينة مخزونكم الفعلي: المناطق الأكثر مبيعًا لديكم، والحالات الصعبة (فنادق بالاسم نفسه، أسماء بحروف كيريلية أو عربية، منشآت متقاربة الموقع)، وكل موردي كم.
هل تضيع مطابقاتي إذا غيّرت المزوّد؟
يتوقف ذلك على شروط العقد وملكية البيانات. اسألوا قبل الاختيار كتابيًا بأي صيغة تستطيعون تصدير نتائج المطابقة، وهل تستطيعون الاستمرار في استخدام هذه البيانات بعد انتهاء العقد.
هل نستطيع طرح هذه الأسئلة على hotelmapping.org أيضًا؟
نعم. أُعدّت القائمة بحياد ويمكن تطبيقها على كل مزوّد بالطريقة نفسها، ومنهم hotelmapping.org. والتجربة على بياناتكم أنتم هي أوثق طريقة للمقارنة.
فريق تحرير hotelmapping.org
فريق بيانات الفنادق في DIJI.TECH
فريق DIJI.TECH المتخصص في مطابقة الفنادق وتكامل الموردين وبرمجيات السفر.
منتجات ذات صلة
حلول Find Match API
أرسلوا الاسم والعنوان والإحداثيات لتعود معرّف HM ID ودرجة الثقة. دون الحاجة إلى رمز مورّد.
حلول مطابقة الفنادق
معرّف HM ID دائم لكل منشأة، مع رموز الموردين والمعرّفات المتقاطعة في سجل واحد.
حلول مطابقة الغرف
تفكّك أسماء الغرف إلى النوع والفئة والإطلالة والسرير والسعة، وتجمع الغرفة الواحدة في معرّف واحد.
مقالات ذات صلة
- ما هي مطابقة الفنادق (hotel mapping) وكيف تعمل؟ دليل شامل ما هي مطابقة الفنادق؟ كيف تُدمج سجلات المورّدين في معرّف واحد، مراحل العملية التسع، عتبات الدرجة، مطابقة الغرف والوجبات، وقياس الجودة.
- الدقة أم التغطية في مطابقة الفنادق؟ ماذا تعني 99.99% فعلًا كيف تؤثر الدقة والتغطية ونسبة المراجعة البشرية على بعضها في مطابقة الفنادق؟ أسئلة لفحص ادعاء دقة 99.99% قبل الاعتماد عليه.
- كلفة تكرار إدراج الفنادق على الوكالة: التحويل والإلغاء وشكاوى العملاء كم يكلّف تكرار إدراج الفنادق الوكالة في معدل التحويل والإلغاءات وخدمة العملاء؟ إطار حسابي ومتغيرات واضحة ومثال افتراضي لتقدير الكلفة الفعلية.
- ما هو تكامل XML للفنادق؟ الفرق بين البيانات الثابتة والديناميكية ما هو تكامل XML للفنادق وكيف يعمل؟ الفرق بين البيانات الثابتة والديناميكية، ومسار البحث والحجز النموذجي، وأمثلة على سجلات XML/JSON.