Hotel mapping API seçerken sorulması gereken 12 soru
Hotel mapping API seçerken doğruluğun nasıl ölçüldüğünü, kapsamanın sizin bölgeleriniz için geçerli olup olmadığını, belirsiz eşleşmelerin nasıl ele alındığını, ID'lerin kalıcılığını, oda ve pansiyon tipi desteğini, teslim yöntemlerini, hata düzeltme sürecini ve çıkış koşullarını sorun. Her cevabı kendi tedarikçi verinizle yapılan bir denemeyle doğrulayın.
- Yazar
- hotelmapping.org Editör Ekibi
- Son güncelleme:
- 9 dk okuma
Bu liste nasıl kullanılır?
Otel eşleştirme sağlayıcılarının çoğu yüksek doğruluk, geniş kapsama ve kolay entegrasyon vaat eder. Vaatler birbirine benzediğinde seçim kolayca fiyata ve demo izlenimine indirgenir. Oysa farklar ayrıntıdadır: doğruluğun nasıl ölçüldüğü, belirsiz kayıtlara ne olduğu, bir otel kapandığında ID’nin nasıl davrandığı, oda ve pansiyon tipinin kapsama dahil olup olmadığı.
Aşağıdaki 12 soru, bir hotel mapping API’sini değerlendirirken sorulması gereken konuları beş başlıkta toplar. Her soru için neden önemli olduğunu ve cevabı nasıl doğrulayacağınızı yazdık. Liste tarafsızdır; hotelmapping.org dahil her sağlayıcıya aynı şekilde uygulanabilir.
Konuya yeniyseniz önce otel eşleştirme nedir rehberini okumanızı öneririz. Tedarikçi bağlantılarının statik ve dinamik tarafını otel XML entegrasyonu makalesinde anlattık.
Veri kalitesi
1. Doğruluk nasıl ölçülüyor ve yanlış eşleşme oranı nedir?
Neden önemli: Yanlış eşleşme çoğu zaman eksik eşleşmeden daha pahalıdır. İki farklı otel tek kayıtta birleşirse müşteri yanlış otele rezervasyon yapabilir; bu da iptal, şikâyet ve ek maliyet demektir. “Doğruluk” kelimesi her sağlayıcıda aynı anlama gelmeyebilir: oran yalnız otomatik eşleşmeler üzerinden de, insan kontrolünden geçmiş kayıtlar dahil edilerek de hesaplanmış olabilir.
Nasıl doğrulanır: Ölçümün hangi test setiyle yapıldığını sorun: kaç otel çifti, hangi bölgelerden, kim tarafından etiketlenmiş, en son ne zaman ölçülmüş? Yanlış eşleşme oranını (false positive) ve kaçırılan eşleşme oranını (false negative) ayrı ayrı isteyin. Ardından kendi tedarikçi verinizden bir örneklem gönderin ve sonuçları ekibinizle elle kontrol edin.
2. Kapsama oranı hangi bölgeler ve tedarikçiler için geçerli?
Neden önemli: Global bir kapsama oranı, sizin sattığınız bölgelerdeki durumu göstermeyebilir. Akdeniz resort bölgeleri, aynı adı taşıyan çok sayıda tesis ve birbirine yakın konumlarıyla zor bir alandır. Ayrıca kapsama, sağlayıcının sizin tedarikçilerinizin verisini zaten işleyip işlemediğine bağlıdır.
Nasıl doğrulanır: Çalıştığınız tedarikçilerin listesini verin ve her biri için ayrı kapsama oranı isteyin. En çok sattığınız destinasyonlar için (ör. Antalya, Muğla, İstanbul) bölge bazında sonuç isteyin. Kapsama oranının toplam kayıt üzerinden mi, yoksa aktif ve satılabilir kayıtlar üzerinden mi hesaplandığını sorun.
3. Emin olunmayan eşleşmeler nasıl ele alınıyor?
Neden önemli: Eşleştirme sistemlerinin çoğu bir eşleşme skoru üretir ve eşik değerleri kullanır. Skoru kesin olmayan kayıtlara ne yapıldığı kaliteyi doğrudan belirler: yine de otomatik mi eşleniyor, bir uzman mı kontrol ediyor, yoksa yeni kayıt mı açılıyor?
Nasıl doğrulanır: Eşik değerlerini ve her aralıkta ne olduğunu sorun. İnsan kontrolüne düşen kayıtların oranını ve ortalama karar süresini isteyin. API yanıtında skorun size dönüp dönmediğine bakın; skor dönüyorsa kendi tarafınızda daha sıkı bir eşik uygulayabilirsiniz.
Kimlik ve yaşam döngüsü
4. ID kalıcı mı; kapanan, birleşen ve ayrılan oteller ne oluyor?
Neden önemli: Eşleştirme kimliği sizin rezervasyon geçmişinize, içerik tablolarınıza ve raporlarınıza yazılır. Bir ID başka bir otele yeniden verilirse veya sessizce silinirse geçmiş verileriniz bozulur.
Nasıl doğrulanır: Bir ID’nin başka bir otele yeniden verilip verilmediğini yazılı olarak sorun. İki otel birleştiğinde eski ID’nin yeni ID’ye yönlendirilip yönlendirilmediğini ve bunun API’de nasıl göründüğünü (ör. bir status veya merged_into alanı) örnek yanıtla isteyin. Kapanan otellerin pasif olarak işaretlenip işaretlenmediğine bakın.
5. Mevcut ID’lerinizi ve kodlarınızı taşıyabiliyor musunuz?
Neden önemli: Çoğu ekip sıfırdan başlamaz. Elinizde kendi otel kodlarınız veya daha önce kullandığınız bir eşleştirme hizmetinin ID’leri olabilir. Yeni sağlayıcı bunları çapraz referans olarak saklayamıyorsa geçiş maliyeti artar.
Nasıl doğrulanır: Mevcut eşleştirme tablonuzdan bir örnek gönderin ve yeni ID’lerle birlikte eski kimliklerin de dönüp dönmediğine bakın. Çakışma durumunda (sizin tablonuz ile sağlayıcının sonucu farklı olduğunda) hangisinin esas alındığını ve bu farkların size raporlanıp raporlanmadığını sorun.
6. Tedarikçi kod değişiklikleri nasıl bildiriliyor?
Neden önemli: Tedarikçiler kod siler, yeni kod verir, bir oteli başka bir kodla yeniden listeler. Bu değişiklikler size ulaşmazsa eşleştirme tablonuz sessizce eskir ve aramada kayıp oteller ya da mükerrer kayıtlar ortaya çıkar.
Nasıl doğrulanır: Değişikliklerin hangi kanalla bildirildiğini sorun: delta dump, webhook veya değişiklik geçmişi uç noktası. Silinen ve birleşen kayıtların deltada açıkça yer alıp almadığına bakın. Son bir ayın örnek delta dosyasını isteyin.
Kapsam derinliği
7. Oda eşleştirme var mı ve nasıl çalışıyor?
Neden önemli: Otel eşleştirme tek başına fiyat karşılaştırması için yetmez. “DBL SV”, “Double Room Sea View” ve “Deniz Manzaralı Çift Kişilik Oda” aynı odaysa, bunların da tek kimliğe bağlanması gerekir. Aksi halde aynı otel kartında aynı oda birden çok kez görünür.
Nasıl doğrulanır: Oda eşleştirmenin ayrı bir ürün mü, otel eşleştirmeye dahil mi olduğunu sorun. Anında (çağrı bazlı) mı yoksa toplu mu çalıştığını öğrenin. Kendi verinizden zor oda adlarını (kısaltmalı, çok dilli, aile odaları, bağlantılı odalar) gönderip sonuçlara bakın. Ayrıntılar için oda eşleştirme sayfamıza bakabilirsiniz.
8. Pansiyon tipi ve destinasyon eşleştirme destekleniyor mu?
Neden önemli: Resort pazarında pansiyon tipi fiyatı belirleyen ana etkenlerden biridir. “AI”, “All Inclusive”, “Ultra Her Şey Dahil”, “Soft AI” gibi yazımlar standart bir koda çevrilmezse farklı pansiyonlar aynı fiyat satırında karşılaştırılabilir. Destinasyon tarafında ise tedarikçiler aynı bölgeyi farklı hiyerarşilerle gönderir (ör. bir tedarikçi “Antalya”, diğeri “Belek”).
Nasıl doğrulanır: Desteklenen standart pansiyon kodu listesini isteyin. Kendi tedarikçilerinizden gelen pansiyon yazımlarını gönderip hangi koda çevrildiğine bakın. Destinasyon için ülke, il, ilçe ve resort bölgesi seviyelerinin ayrı ayrı tutulup tutulmadığını sorun.
9. Çok dilli ad ve adresler nasıl işleniyor?
Neden önemli: Aynı otel bir tedarikçide Latin harfle, diğerinde Kiril veya Arap harfiyle gelebilir. Türkçe karakterler (ç, ğ, ı, ö, ş, ü) bazı sistemlerde bozulur veya düşer. Bu farklar ad benzerliğine dayalı eşleştirmeyi zorlaştırır.
Nasıl doğrulanır: Transliterasyon ve karakter normalleştirmenin nasıl yapıldığını sorun. Örneklem içine Rusça veya Arapça adla gelen otelleri ve Türkçe karakterleri bozulmuş kayıtları ekleyin. Sonuçları bu alt grupta ayrıca değerlendirin.
Teknik entegrasyon ve operasyon
10. Teslim yöntemleri, limitler ve güncellik nedir?
Neden önemli: Eşleştirme sonucu arama anında kullanılır. Her aramada uzak bir API’ye gitmek gecikme yaratabilir; çoğu ekip sonuçları kendi tarafında bir tablo olarak tutar. Bu yüzden API kadar toplu dosya (dump) teslimi de önemlidir.
Nasıl doğrulanır: Şu ayrıntıları yazılı olarak isteyin:
- API uç noktaları ve örnek istek/yanıt
- Çağrı limitleri (dakika, gün, ay bazında) ve aşıldığında ne olduğu
- Tam ve delta dump biçimleri (CSV, JSON, Parquet vb.) ve yayın sıklığı
- Webhook desteği
- Yeni bir tedarikçi dosyasının eşleştirilme süresi
- Deneme ortamı (sandbox) ve dokümantasyonun herkese açık olup olmadığı
Deneme ortamında birkaç gün boyunca gerçek iş yükünüze yakın bir akış çalıştırın.
11. Yanlış eşleşme bildirildiğinde ne oluyor?
Neden önemli: Hiçbir sistem hatasız değildir. Fark, hatanın ne kadar hızlı düzeltildiği ve aynı hatanın tekrar edip etmediğidir. Düzeltme süreci belirsizse ekibiniz yanlış kayıtları kendi tarafında elle yamamak zorunda kalır.
Nasıl doğrulanır: Hata bildirme kanalını (API, portal, e-posta) ve hedef düzeltme süresini sorun. Düzeltmenin yalnız sizin hesabınızda mı, tüm müşteriler için mi uygulandığını öğrenin. Sözleşmede bir hizmet seviyesi (SLA) olup olmadığına ve destek dilinin ekibinize uyup uymadığına bakın. Deneme sırasında bilerek bir hata bildirin ve süreci baştan sona izleyin.
Ticari koşullar
12. Fiyat modeli, deneme ve çıkış koşulları nedir?
Neden önemli: Eşleştirme hizmetleri tedarikçi sayısı, otel sayısı, çağrı sayısı veya ürün modülü bazında fiyatlanabilir. Model ile büyüme planınız uyuşmazsa maliyet beklenmedik şekilde artar. Ayrıca sözleşme bittiğinde eşleştirme sonuçlarınızı kullanmaya devam edip edemeyeceğiniz, geçiş maliyetini belirler.
Nasıl doğrulanır: Fiyatın açık yazılıp yazılmadığına, hangi modüllerin dahil olduğuna ve ek tedarikçi ücretine bakın. Ücretsiz deneme veya test ortamı (sandbox) imkânı olup olmadığını sorun. Sözleşme bitiminde verinin hangi biçimde dışa aktarılabileceğini ve lisans koşullarını yazılı olarak isteyin.
12 soru tek bakışta
| # | Soru | İstenecek kanıt | Dikkat edilecek işaret |
|---|---|---|---|
| 1 | Doğruluk nasıl ölçülüyor? | Test seti açıklaması, kendi örnekleminizle sonuç | Yöntemi açıklanmayan tek bir oran |
| 2 | Kapsama sizin bölgelerinizde ne? | Tedarikçi ve bölge bazında oran | Yalnız global oran |
| 3 | Belirsiz eşleşmeler ne oluyor? | Eşik değerleri, insan kontrolü oranı | Skorun API’de dönmemesi |
| 4 | ID kalıcı mı? | Birleşme ve kapanma için örnek yanıt | ID’nin yeniden kullanılabilmesi |
| 5 | Mevcut ID’ler taşınabiliyor mu? | Çapraz referanslı örnek çıktı | Eski kodların kaybolması |
| 6 | Kod değişiklikleri bildiriliyor mu? | Örnek delta dosyası | Silinen kayıtların deltada olmaması |
| 7 | Oda eşleştirme var mı? | Zor oda adlarıyla test sonucu | Yalnız serbest metin döndürme |
| 8 | Pansiyon ve destinasyon var mı? | Standart kod listesi, hiyerarşi örneği | Pansiyon tipinin kapsam dışı olması |
| 9 | Çok dilli adlar işleniyor mu? | Kiril ve Arap harfli kayıtlarla test | Bu alt grupta belirgin düşüş |
| 10 | Teslim ve limitler nedir? | Dokümantasyon, sandbox, dump örneği | Toplu teslim seçeneğinin olmaması |
| 11 | Hata nasıl düzeltiliyor? | Bildirim kanalı, hedef süre, SLA | Belirsiz düzeltme süreci |
| 12 | Fiyat ve çıkış koşulları nedir? | Yazılı fiyat, dışa aktarma hakkı | Sözleşme sonunda verinin kullanılamaması |
Örnek: bir eşleştirme yanıtında neye bakmalı?
Değerlendirme sırasında aldığınız API yanıtları, yukarıdaki soruların birçoğunu tek bakışta cevaplar. Aşağıda kurgusal bir otel için hotelmapping.org API v1’in POST /v1/match yanıtını örnek olarak gösteriyoruz; başka sağlayıcıların alan adları farklı olabilir.
İstek:
{
"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"
}
Yanıt:
{
"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"
}
Örnek veridir; otel adı, adres ve kodlar gerçek bir tesise ait değildir. Alan adları v1 taslağıdır ve değişebilir. Bu yanıtta şunlara bakın:
confidencevedecision: Skor ve kararın türü dönüyor mu? (Soru 3)statusvemerged_into: Kapanma ve birleşme durumu görünüyor mu? (Soru 4)external_ids: Kendi otel kodlarınız veya mevcut sağlayıcınızın kimlikleri taşınıyor mu? (Soru 5)supplier_codes: Aynı otelin diğer tedarikçi kodları tek kayıtta mı? (Soru 6)destination_id: Destinasyon hiyerarşisi standart bir kimlikle mi geliyor? (Soru 8)
Find Match API’nin ayrıntıları eşleştirme API’si ve otel eşleştirme sayfalarında, uç nokta listesi geliştiriciler sayfasındadır.
Deneme sürecini nasıl kurgulamalı?
Soruların cevaplarını sunum yerine veriyle almak için kısa bir deneme planı yeterlidir:
- Örneklem hazırlayın: Tüm tedarikçilerinizden, en çok sattığınız bölgelerden ve zor durumlardan (aynı adlı oteller, yakın konumlu tesisler, çok dilli adlar) oluşan bir kayıt listesi çıkarın.
- Doğru cevapları önceden belirleyin: Bu listenin bir bölümünü ekibinizle elle eşleştirin. Bu, sağlayıcının sonuçlarını karşılaştıracağınız ölçüttür.
- Aynı veriyi tüm adaylara gönderin: Karşılaştırmanın adil olması için her sağlayıcı aynı dosyayı almalıdır.
- Sonuçları ayrı ayrı ölçün: Yanlış eşleşme, kaçırılan eşleşme, insan kontrolüne düşen kayıt ve teslim süresi için ayrı sayılar çıkarın.
- Operasyonu test edin: Bir hata bildirin, bir delta dosyası isteyin, API limitlerini deneyin.
- Sözleşme koşullarını yazılı alın: Fiyat, SLA ve veri dışa aktarma hakkı teklifte açıkça yer almalıdır.
Mükerrer kayıtların işinize ne kadar mal olduğunu hesaplamak, deneme sonuçlarını iş etkisine çevirmenize yardımcı olur. Bunun için mükerrer otel maliyeti makalesine bakabilirsiniz.
Bu soruları hotelmapping.org’a da sorun
Bu listeyi bir sağlayıcının lehine hazırlamadık; hotelmapping.org için de aynı soruları sormanızı bekleriz. Ölçülmüş doğruluk ve kapsama değerlerimiz, test seti tamamlandığında kapsam sayfasında yayımlanacaktır. Fiyatlandırmanın modül ve tedarikçi sayısına göre nasıl belirlendiğini teklif sayfasında anlattık. Birden fazla sağlayıcıyı karşılaştırıyorsanız sonuçları aynı veri setinde ölçün; doğruluk ile kapsama rakamlarını birlikte nasıl okuyacağınızı eşleştirme doğruluğu mu, kapsama mı? yazısında anlattık.
Sık sorulan sorular
Doğruluk ve kapsama arasındaki fark nedir?
Doğruluk, yapılan eşleşmelerin ne kadarının gerçekten doğru olduğunu gösterir. Kapsama ise tedarikçi kayıtlarının ne kadarının bir otele bağlanabildiğini gösterir. Biri yüksek, diğeri düşük olabilir; bu yüzden ikisini ayrı ayrı ve aynı veri seti üzerinde sormak gerekir.
Deneme için ne kadar veri yeterli?
Kesin bir sayı yoktur. Önemli olan örneklemin sizin gerçek envanterinizi temsil etmesidir: en çok sattığınız bölgeler, zor durumlar (aynı adlı oteller, Kiril veya Arap harfli adlar, yakın konumdaki tesisler) ve tüm tedarikçileriniz örnekte yer almalıdır.
Sağlayıcı değiştirirsem eşleştirmelerim kaybolur mu?
Bu, sözleşme ve veri sahipliği koşullarına bağlıdır. Seçim öncesinde eşleştirme sonuçlarını hangi biçimde dışa aktarabileceğinizi ve sözleşme bittikten sonra bu veriyi kullanmaya devam edip edemeyeceğinizi yazılı olarak sorun.
Bu soruları hotelmapping.org'a da sorabilir miyiz?
Evet. Liste tarafsız hazırlanmıştır ve her sağlayıcıya, hotelmapping.org dahil, aynı şekilde uygulanabilir. Kendi verinizle yapılacak bir deneme en güvenilir karşılaştırma yöntemidir.
hotelmapping.org Editör Ekibi
DIJI.TECH otel verisi ekibi
Otel eşleştirme, tedarikçi entegrasyonu ve seyahat yazılımı alanında çalışan DIJI.TECH ekibi.
İlgili ürünler
Find Match API çözümü
Ad, adres ve koordinat gönderin; HM ID ve güven skoru dönsün. Tedarikçi kodu gerekmez.
Otel eşleştirme çözümü
Her tesise kalıcı bir HM ID; tedarikçi kodları ve çapraz ID'ler tek kayıtta.
Oda eşleştirme çözümü
Oda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odayı tek oda ID'sinde toplar.
İlgili makaleler
- Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber Otel eşleştirme nedir? Tedarikçi kayıtlarının tek kimlikte nasıl birleştiği, 9 adımlı süreç, skor eşikleri, oda ve pansiyon eşleştirme, kalite ölçümü.
- Eşleştirmede doğruluk mu, kapsama mı? %99,99 gerçekte ne demek? Otel eşleştirmede doğruluk, kapsama ve insan kontrolü oranı birbirini nasıl etkiler? %99,99 doğruluk beyanını sorgulamak için sorulacak sorular.
- Mükerrer otel listelemenin acenteye maliyeti: dönüşüm, iptal ve müşteri şikâyeti Mükerrer otel listeleme acenteye dönüşüm, iptal ve müşteri hizmetlerinde ne kadara mal olur? Hesaplama çerçevesi, değişkenler ve varsayımlı örnek.
- Otel XML entegrasyonu nedir? Statik ve dinamik veri farkı Otel XML entegrasyonu nedir, nasıl çalışır? Statik ve dinamik otel verisi farkı, tipik arama-rezervasyon akışı ve örnek XML/JSON kayıtları.