Widget κρατήσεων
Ενσωματώστε το widget απευθείας κρατήσεων του StayParity σε ιστοσελίδα ξενοδοχείου με έναν κώδικα. Ο κώδικας, το dock, τι βλέπουν οι επισκέπτες και το CSP.
Το widget είναι ένα μικρό πλαίσιο τιμής στην ιστοσελίδα του ίδιου του ξενοδοχείου. Δείχνει την απευθείας τιμή για μια διαμονή και, όταν το ξενοδοχείο είναι φθηνότερο ή στην ίδια τιμή, τις τιμές των OTA δίπλα της. Λειτουργεί σε iframe με sandbox, οπότε δεν μπορεί να διαβάσει τη σελίδα όπου βρίσκεται και η σελίδα δεν έχει πρόσβαση σε αυτό. Το sandbox του επιτρέπει δύο ενέργειες, καθεμία μόνο μετά από κλικ του επισκέπτη: να ανοίξει τη σελίδα κρατήσεων του ξενοδοχείου στην καρτέλα όπου βρίσκεται ο επισκέπτης, και να ανοίξει το stayparity.com σε νέα καρτέλα από τον σύνδεσμο αναφοράς του.
Τι λέει το widget στους επισκέπτες, και γιατί, θα το βρείτε στη σελίδα Widget απευθείας κρατήσεων. Αυτή η σελίδα εξηγεί πώς το βάζετε σε μια ιστοσελίδα.
Ενσωμάτωση στην ιστοσελίδα
- Στην εφαρμογή, ανοίξτε τις Ρυθμίσεις → Widget κρατήσεων και ενεργοποιήστε το Widget. Η εφαρμογή ζητά τη σελίδα κρατήσεων του ξενοδοχείου, που παραμένει στην ίδια οθόνη, στο πεδίο Σελίδα κρατήσεων, για να την αλλάξετε αργότερα. Το κουμπί Book direct, στη γλώσσα του επισκέπτη με ενεργοποιημένη τη μετάφραση, ανοίγει τη σελίδα κρατήσεων στην ίδια καρτέλα.
- Αντιγράψτε τον κώδικα από την ενότητα Κώδικας ενσωμάτωσης, στην καρτέλα Επικόλληση: είναι η ετικέτα script, που δεν περιέχει τίποτα άλλο εκτός από το κλειδί ενσωμάτωσης του ξενοδοχείου. Η καρτέλα Tag manager δίνει την ίδια ετικέτα, με τα βήματα για μια ετικέτα τύπου «Προσαρμοσμένη HTML». Η καρτέλα Προώθηση δίνει ένα μήνυμα με τον κώδικα, πού μπαίνει και πώς ελέγχεται, για να το στείλετε σε όποιον φροντίζει την ιστοσελίδα σας.
- Επικολλήστε τον μία φορά σε κάθε σελίδα όπου θέλετε να εμφανίζεται το widget ή στο υποσέλιδο της ιστοσελίδας σας. Το widget εμφανίζεται σε μια κάτω γωνία του παραθύρου, όπου κι αν βρίσκεται η ετικέτα, οπότε η ετικέτα μπορεί να μπει οπουδήποτε μέσα στο
<body>. Στη συνέχεια, στη σελίδα Widget της εφαρμογής, βάλτε τη διεύθυνση της σελίδας στην ενότητα Έλεγχος της ιστοσελίδας μου: ο έλεγχος δείχνει αν η ετικέτα βρίσκεται στη σελίδα και αν η πολιτική ασφαλείας της ιστοσελίδας σας επιτρέπει στο widget να φορτώσει.
<!-- Widget απευθείας κρατήσεων StayParity. Η εμφάνισή του ορίζεται στο StayParity. -->
<script src="https://badge.stayparity.com/embed.js" data-hotel="wk_aurora" async></script>Το script δημιουργεί ένα iframe στο τέλος της σελίδας και δεν τροποποιεί τίποτε άλλο σε αυτήν. Το πλαίσιο ρυθμίζει το ύψος του ανάλογα με το περιεχόμενο.
Το dock
Το widget είναι ένα dock: μπάρα σε μια κάτω γωνία του παραθύρου, που εμφανίζεται όταν έρθει η απευθείας τιμή. Με ένα κλικ ανοίγει σε κάρτα με την πλήρη απάντηση, και κλείνει ξανά με το βελάκι στο κάτω μέρος της κάρτας ή με το Escape. Ο επισκέπτης δεν μπορεί να το απομακρύνει: παραμένει για όλη την προβολή της σελίδας. Αν στη γωνία του βρίσκεται ήδη κουμπί chat ή σταθερή μπάρα κρατήσεων, το dock ανεβαίνει πάνω από το στοιχείο αυτό ή μετακινείται στην άλλη κάτω γωνία· αν καμία από τις δύο θέσεις δεν είναι ελεύθερη, μένει όπου είναι. Κρύβεται όσο ένα συνηθισμένο banner για τα cookie εκτείνεται πάνω από αυτό.
Στην ενότητα Εμφάνιση, στις Ρυθμίσεις → Widget κρατήσεων:
- Η ρύθμιση Γωνία του dock επιλέγει την αριστερή ή τη δεξιά γωνία, και η ρύθμιση Ύψος του dock πόσο πάνω από το κάτω άκρο του παραθύρου βρίσκεται, έως 200 pixel.
- Το Χρώμα κουμπιού είναι Αυτόματο, δηλαδή σκούρο σε φωτεινό φόντο και ανοιχτό σε σκούρο, ή ένα δικό σας χρώμα. Χρώμα με αντίθεση μικρότερη από 3:1 απέναντι στο φόντο δεν γίνεται δεκτό.
- Το Φόντο είναι Φωτεινό, Σκούρο ή Σύστημα επισκέπτη, που ακολουθεί τη ρύθμιση φωτεινού ή σκούρου θέματος του επισκέπτη.
- Οι Γωνίες είναι Τετράγωνες, Στρογγυλές ή Κάψουλα.
Κάθε αλλαγή φτάνει σε κάθε σελίδα με την ετικέτα μέσα σε ένα λεπτό, με τον ίδιο κώδικα. Το widget ζητά τις ρυθμίσεις του από το StayParity σε κάθε φόρτωση σελίδας.
Γλώσσα
Το widget εμφανίζεται στα αγγλικά. Αν ενεργοποιήσετε τη Μετάφραση του widget στις Ρυθμίσεις → Widget κρατήσεων, εμφανίζεται στη γλώσσα του επισκέπτη όταν το πρόγραμμα περιήγησής του προτιμά ελληνικά, ισπανικά, ιταλικά, γερμανικά ή τσεχικά, και στα αγγλικά σε κάθε άλλη περίπτωση. Λαμβάνει υπόψη τις γλώσσες που έχει ορίσει ο επισκέπτης στο πρόγραμμα περιήγησής του, όχι τη γλώσσα της σελίδας σας, και γράφει τιμές και ημερομηνίες όπως συνηθίζεται στη γλώσσα αυτή. Η ρύθμιση είναι απενεργοποιημένη μέχρι να την ενεργοποιήσετε και ισχύει σε κάθε σελίδα με την ετικέτα μέσα σε ένα λεπτό, χωρίς νέο κώδικα.
Νόμισμα
Το widget δείχνει τις τιμές στο νόμισμα του ξενοδοχείου. Με ενεργή τη ρύθμιση Οι επισκέπτες μπορούν να αλλάξουν νόμισμα, ένας κωδικός νομίσματος στο υποσέλιδο του dock ανοίγει μενού με τα νομίσματα που προσφέρετε, πρώτο το νόμισμα του ξενοδοχείου, και κάθε τιμή στην κάρτα αλλάζει στο νόμισμα που επιλέγει ο επισκέπτης, με μετατροπή στη συναλλαγματική ισοτιμία αναφοράς της ημέρας. Η ίδια η σύγκριση και το ποσό που χρεώνει η σελίδα κρατήσεων μένουν στο νόμισμα του ξενοδοχείου. Με ενεργή τη ρύθμιση Άνοιγμα στο νόμισμα του επισκέπτη, το widget ξεκινά στο νόμισμα της περιοχής του επισκέπτη, όπως προκύπτει από τη γλώσσα του προγράμματος περιήγησής του, εφόσον το προσφέρετε.
Παράμετροι
Η ετικέτα δέχεται δύο παραμέτρους:
data-hotel, υποχρεωτική: το κλειδί ενσωμάτωσης του ξενοδοχείου, σε μορφήwk_…. Χωρίς κλειδί δεν εμφανίζεται widget.data-consent="none", προαιρετική: το StayParity δεν μετρά αυτή την προβολή σελίδας στα στατιστικά του widget, και το widget δεν αποθηκεύει τίποτα στο πρόγραμμα περιήγησης του επισκέπτη, οπότε η Αποθήκευση διανυκτέρευσης, το Αυτόματο άνοιγμα και η Προσφορά αποχώρησης δεν εμφανίζονται σε αυτή τη σελίδα και η λειτουργία δοκιμής ισχύει μόνο για μία σελίδα. Οι τιμές που δείχνει δεν αλλάζουν. Για να μη φορτώνεται το widget σε μια σελίδα πριν συναινέσει ο επισκέπτης, φορτώστε την ετικέτα μέσω του εργαλείου διαχείρισης συγκατάθεσης ή του tag manager σας, αντί να την προσθέσετε απευθείας.
Η εμφάνιση, η γλώσσα και το νόμισμα έρχονται από το StayParity και η διανυκτέρευση από τη σελίδα.
Για ποια διανυκτέρευση δείχνει τιμή
Το widget δείχνει την τιμή μίας διανυκτέρευσης, με την ημερομηνία άφιξης, μαζί με την ημερομηνία αναχώρησης ή τον αριθμό διανυκτερεύσεων, και τον αριθμό ενηλίκων που επιλέγει ο επισκέπτης. Τα αναζητά μόνο στη διεύθυνση της σελίδας σας, στα πεδία της φόρμας κρατήσεων και, στις σελίδες κρατήσεων Mews και Cloudbeds, στα συμβάντα που στέλνουν αυτά τα booking engine στο dataLayer της σελίδας, και δεν διαβάζει τίποτε άλλο στη σελίδα. Μέχρι να γνωρίζει μια διαμονή, δείχνει την πιο κοντινή διανυκτέρευση της επόμενης εβδομάδας για την οποία βρήκαμε τιμή το τελευταίο 24ωρο, όσο είναι ενεργή η ρύθμιση Πιο κοντινή διανυκτέρευση με τιμή, που είναι ενεργή εξαρχής. Με τη ρύθμιση ανενεργή ή χωρίς τέτοια διανυκτέρευση, δεν εμφανίζει τίποτα και δεν καταλαμβάνει χώρο. Για διαμονή χωρίς αριθμό ενηλίκων, ή με παιδιά ή περισσότερα από ένα δωμάτια, δείχνει την τιμή για δύο ενήλικες ή, αν το ξενοδοχείο δεν ελέγχεται για δύο, για τον μικρότερο αριθμό για τον οποίο ελέγχεται. Δείχνει τη διανυκτέρευση του επισκέπτη μόλις γνωρίζει τη διαμονή, για παράδειγμα τη στιγμή που ο επισκέπτης επιλέγει ημερομηνίες στη φόρμα κρατήσεων.
Το widget ξεκινά νέο έλεγχο μόνο για τους αριθμούς ατόμων που παρακολουθούνται για το συγκεκριμένο ξενοδοχείο. Για κάθε άλλο αριθμό δείχνει τιμή που έχει ήδη βρεθεί γι’ αυτόν ή, αν δεν υπάρχει, την τιμή για δύο ενήλικες ή για τον μικρότερο αριθμό για τον οποίο ελέγχεται το ξενοδοχείο, και το αναφέρει.
Τι διαβάζει:
- Τη διεύθυνση της σελίδας, κατά τη φόρτωση και κάθε φορά που αλλάζει, όπως συμβαίνει όταν ένα booking engine κάνει αναζήτηση χωρίς να ξαναφορτώσει τη σελίδα. Ημερομηνία άφιξης από
checkin,checkInDate,arrival,arrivalDate,arrive,startDate,dateFrom,fromDateήmewsStart· ημερομηνία αναχώρησης απόcheckout,checkOutDate,departure,departureDate,depart,endDate,dateTo,toDateήmewsEnd· διανυκτερεύσεις απόnightsήlos· ενήλικες απόadults,adult,adultCount,adultQty,numAdults,numberOfAdultsήmewsAdultCount· παιδιά απόchildren,child,childCount,childQty,kidsήnumChildren· δωμάτια απόrooms,numRoomsήroomCount. Πεζά, κεφαλαία και σημεία στίξης δεν έχουν σημασία, οπότε μετρούν και ταcheck_inκαιCheck-In, αλλά το όνομα πρέπει να ταιριάζει ολόκληρο: μεinήitems[0][adults]δεν διαβάζεται τίποτα. Ο συνολικός αριθμός ατόμων, όπωςguests,pax,personsήoccupancy, δεν μετρά ποτέ ως αριθμός ενηλίκων. - Τα πεδία της φόρμας κρατήσεων, μόλις ο επισκέπτης αλλάξει κάποιο. Ένα πεδίο μετρά όταν το
nameτου, τοidτου ή το τελευταίο τμήμα[...]του ονόματός του είναι ένα από τα παραπάνω ονόματα, όπωςarrival_dateήinfo[arrival_date]. Δεν διαβάζει ποτέ κρυφά πεδία, πεδία κωδικού πρόσβασης, email, τηλεφώνου, αρχείου, πλαισίου ελέγχου ή κουμπιού επιλογής, πεδία που το πρόγραμμα περιήγησης συμπληρώνει με όνομα, email, αριθμό τηλεφώνου ή κάρτα, ούτε απενεργοποιημένα πεδία. Μια φόρμα όπως φορτώθηκε μετρά μόνο αφού ο επισκέπτης αλλάξει κάποιο από τα πεδία της, οπότε μια φόρμα που ανοίγει με συμπληρωμένη την αποψινή ημερομηνία αφήνει να φαίνεται η πιο κοντινή διανυκτέρευση με τιμή μέχρι να επιλέξει ο επισκέπτης.
Υπερισχύει η πιο πρόσφατη διαμονή που διαβάζει, από όπου κι αν προέρχεται. Μια διεύθυνση που περιέχει μόνο τις προεπιλογές ενός booking engine, μία διανυκτέρευση από σήμερα για δύο ενήλικες, μετρά μόνο αφού αλλάξει. Η πρώτη διανυκτέρευση που γνωρίζει ελέγχεται αμέσως. Μετά, το widget περιμένει μισό δευτερόλεπτο από την τελευταία αλλαγή του επισκέπτη πριν ζητήσει ξανά τιμές, ώστε ένα ημερολόγιο που συμπληρώνει δύο πεδία να κοστίζει έναν έλεγχο. Ένας επιλογέας που γράφει στα πεδία του χωρίς συμβάν change διαβάζεται 300 χιλιοστά του δευτερολέπτου μετά το κλικ του επισκέπτη.
Διαβάζει ημερομηνίες γραμμένες ως 2027-06-14, 2027/06/14, 20270614, 14/06/2027 ή 06/14/2027 (με /, . ή -), καθώς και ως 14 Jun 2027 ή Jun 14, 2027, με ονόματα μηνών στις έξι γλώσσες του widget και στα γαλλικά. Μια αριθμητική ημερομηνία που διαβάζεται με δύο τρόπους και δίνει δύο πιθανές διαμονές παραλείπεται. Μια διαμονή έχει από 1 έως 30 διανυκτερεύσεις, από σήμερα και μέσα στις επόμενες 500 ημέρες. Δεν διαβάζει φόρμες μέσα σε άλλο πλαίσιο ή σε shadow root, ούτε επιλογείς ημερομηνιών και ατόμων που δεν είναι πεδία φόρμας.
Αν η φόρμα κρατήσεων εκτελείται σε δικό της πλαίσιο ή χρησιμοποιεί επιλογείς ημερομηνιών και ατόμων που δεν είναι πεδία φόρμας, το widget δεν βλέπει τη διανυκτέρευση: δείχνει την πιο κοντινή διανυκτέρευση με τιμή ή, με ανενεργή τη ρύθμιση Πιο κοντινή διανυκτέρευση με τιμή, τίποτα. Σε αυτή την περίπτωση, βάλτε τη διαμονή στη διεύθυνση της σελίδας, π.χ. ?checkin=2027-06-14&checkout=2027-06-15&adults=2.
Τι εμφανίζεται στον επισκέπτη
Το widget συγκρίνει την απευθείας τιμή με τις τιμές των OTA για εκείνη τη διανυκτέρευση, και δείχνει τα OTA μόνο όταν η απευθείας κράτηση είναι φθηνότερη ή στην ίδια τιμή:
| Αποτέλεσμα ελέγχου | Τίτλος | Περιεχόμενο |
|---|---|---|
| Η τιμή του ξενοδοχείου είναι χαμηλότερη | Save €16 | Η τιμή κάθε OTA για την ίδια διαμονή |
| Η τιμή του ξενοδοχείου ισούται ακριβώς με τη χαμηλότερη τιμή OTA | Same price, booked direct | Η τιμή κάθε OTA για την ίδια διαμονή |
| Ένα OTA είναι φθηνότερο | Η απευθείας τιμή, π.χ. €188 per night | Κανένα OTA |
| Καμία τιμή OTA για εκείνη τη διανυκτέρευση | Η απευθείας τιμή, π.χ. €188 per night | Κανένα OTA |
Συμπτυγμένο, το dock γράφει Save €16 by booking direct, Same price as Booking.com ή, όταν δεν υπάρχει OTA για να δείξει, Best price here: €188 per night.
Η κάρτα ανοίγει με μια γραμμή που αναγράφει τη διανυκτέρευση για την οποία δείχνει τιμή, π.χ. Night of Sat 4 Oct · 2 adults ή Tonight, και τον χρόνο από τον τελευταίο έλεγχο, π.χ. Checked 12 min ago (παραλείπεται όταν ο έλεγχος είναι παλαιότερος από μία εβδομάδα). Από κάτω, πάνω από τον τίτλο, μια σφραγίδα γράφει Best price here σε κάθε περίπτωση. Όταν το widget δείχνει τα OTA, αυτά εμφανίζονται κάτω από το Same stay elsewhere, το καθένα με το λογότυπο, το όνομα και την τιμή του. Το κουμπί Book direct δείχνει την απευθείας τιμή της διανυκτέρευσης. Στο κάτω μέρος της κάρτας, ο σύνδεσμος Price check by StayParity ανοίγει το stayparity.com σε νέα καρτέλα· βρίσκεται ανάμεσα στο βελάκι που κλείνει την κάρτα και, αν επιτρέπετε στους επισκέπτες να αλλάζουν νόμισμα, στον επιλογέα νομίσματος.
Για να μετράτε στο δικό σας εργαλείο ανάλυσης τις κρατήσεις που φέρνει το Book direct, διαβάστε τη σελίδα Μέτρηση του widget στο εργαλείο ανάλυσης. Για να αναφέρετε την ίδια απάντηση σε ένα chatbot ή σε ένα δικό σας widget, διαβάστε τη σελίδα API ελέγχου τιμών.
Όσο εκτελείται ο πρώτος έλεγχος για μια διαμονή, καθώς και αν δεν έρθει καμία τιμή, το dock δεν δείχνει τίποτα. Το widget δεν εμφανίζει τίποτα και δεν καταλαμβάνει χώρο όταν:
- το ξενοδοχείο είναι ανενεργό στο StayParity.
- δεν υπάρχει ακόμη τιμή για τη διαμονή, ο έλεγχος απορρίπτεται (η διαμονή είναι στο παρελθόν ή πέρα από τον ορίζοντα του πακέτου ή έχει εξαντληθεί το όριο ελέγχων) και δεν υπάρχει τιμή ούτε για δύο ενήλικες ή για τον μικρότερο αριθμό για τον οποίο ελέγχεται το ξενοδοχείο.
Οι τιμές μορφοποιούνται σύμφωνα με τις τοπικές ρυθμίσεις του επισκέπτη, στο νόμισμα του ξενοδοχείου ή σε εκείνο που επιλέγει ο επισκέπτης. Τα κείμενα του widget είναι στα αγγλικά ή στη γλώσσα του επισκέπτη, αν έχετε ενεργοποιήσει τη μετάφραση.
Πληροφορίες που δεν εμφανίζονται
- Τιμές OTA κάτω από την τιμή του ξενοδοχείου. Ούτε καν ότι υπάρχει κάποια. Αν ένα OTA είναι φθηνότερο, το dock δείχνει μόνο την απευθείας τιμή, χωρίς να παραθέτει τις ακριβότερες. Ούτε το API αποκαλύπτει ποτέ μια απόκλιση: απαντά για εκείνη τη διανυκτέρευση ακριβώς όπως για μια που δεν πουλάει κανένα OTA, οπότε ούτε ο επισκέπτης ούτε ένα script που διαβάζει το endpoint μπορεί να τις ξεχωρίσει. Η απόκλιση παραμένει διαθέσιμη στο ξενοδοχείο μέσω της εφαρμογής και των ειδοποιήσεων.
- Εσωτερικά στοιχεία. Το εσωτερικό αναγνωριστικό του ξενοδοχείου, από πού προέρχεται μια τιμή ή πόσο σίγουροι είμαστε γι’ αυτήν.
- Μηνύματα σφάλματος. Το πλαίσιο δεν καταλαμβάνει χώρο όσο εκτελείται ο πρώτος έλεγχος και παραμένει κρυφό αν ο έλεγχος αποτύχει. Αν το κλειδί είναι άγνωστο ή το widget είναι απενεργοποιημένο, το πλαίσιο συρρικνώνεται σε μηδενικό ύψος και δεν αφήνει κενό στη σελίδα. Το πρόγραμμα περιήγησης ενός επισκέπτη μπορεί να συνεχίσει να δείχνει ένα widget που φόρτωσε τα τελευταία πέντε λεπτά.
Τι αποθηκεύει στη συσκευή του επισκέπτη
Ούτε το πλαίσιο ούτε το script χρησιμοποιούν cookie. Με τους πρόσθετους διακόπτες του ξενοδοχείου ανενεργούς, δεν αποθηκεύουν τίποτα στο πρόγραμμα περιήγησης του επισκέπτη. Η Αποθήκευση διανυκτέρευσης, το Αυτόματο άνοιγμα και η Προσφορά αποχώρησης κρατούν από μια μικρή σημείωση στη συσκευή του επισκέπτη, στον αποθηκευτικό χώρο της σελίδας σας, με το κλειδί ενσωμάτωσης του ξενοδοχείου:
- Αποθήκευση διανυκτέρευσης: η διανυκτέρευση και ο αριθμός ενηλίκων που αποθήκευσε ο επισκέπτης, στο localStorage, όταν πατά Keep. Το widget τα διαγράφει όταν ο επισκέπτης πατά ξανά Kept, καθώς και την επόμενη φορά που ανοίγει σελίδα όπου φορτώνεται το widget σας, εφόσον έχει περάσει η ημερομηνία άφιξης ή ο διακόπτης είναι ανενεργός.
- Αυτόματο άνοιγμα και προσφορά αποχώρησης: στο sessionStorage μέχρι να κλείσει η καρτέλα, μια σημείωση που γράφεται όταν το dock ανοίγει από μόνο του ή καθώς ο επισκέπτης πάει να φύγει, ή όταν ο επισκέπτης το συμπτύσσει, ώστε να μην ανοίξει ξανά από μόνο του.
- Προσφορά αποχώρησης: στο sessionStorage μέχρι να κλείσει η καρτέλα, μια σημείωση που γράφεται όταν εμφανίζεται η προσφορά ή ο επισκέπτης κάνει κλικ στο Book direct, ώστε να μην εμφανιστεί ξανά όταν πάει να φύγει. Στο localStorage, η ώρα που ο επισκέπτης έκλεισε την προσφορά, ώστε να μένει κλειστή για 7 ημέρες. Το widget τη διαγράφει την επόμενη φορά που ο επισκέπτης ανοίγει σελίδα όπου φορτώνεται το widget σας μετά τις 7 ημέρες ή μόλις η προσφορά πάψει να εμφανίζεται: επειδή απενεργοποιήθηκε ή επειδή δεν υπάρχει ενεργός κωδικός.
Το banner για τα cookie ή το εργαλείο διαχείρισης συγκατάθεσής σας μπορεί να χρειάζεται να καλύπτει αυτές τις σημειώσεις. Με data-consent="none" καμία από αυτές δεν διαβάζεται ούτε γράφεται.
Η λειτουργία δοκιμής (#stayparity-debug στη διεύθυνση της σελίδας) κρατά τη γλώσσα της στο sessionStorage της καρτέλας.
Τι μετρά
Εκτός αν η ετικέτα έχει data-consent="none", το πλαίσιο στέλνει στο StayParity μία καταμέτρηση για κάθε προβολή σελίδας όπου εμφανίστηκε, όταν η σελίδα κρύβεται ή κλείνει ή όταν ο επισκέπτης κάνει κλικ στο Book direct. Αυτές οι καταμετρήσεις είναι τα στατιστικά του widget στην εφαρμογή. Η πρώτη αποστολή για κάθε προβολή σελίδας περιέχει:
- το κλειδί ενσωμάτωσης του ξενοδοχείου και το hostname της σελίδας·
- τη γλώσσα του προγράμματος περιήγησης και αν η οθόνη έχει μέγεθος κινητού·
- για ποια διανυκτέρευση έδειξε τιμή το widget: τη διαμονή του επισκέπτη, την ημερομηνία του επισκέπτη για άλλο αριθμό ενηλίκων ή την πλησιέστερη διανυκτέρευση με τιμή·
- το αποτέλεσμα της σύγκρισης, όπως ότι η απευθείας κράτηση είναι φθηνότερη ή ότι η τιμή είναι ίδια·
- αν είναι λωρίδα ή dock, και αν είναι ενεργή η λειτουργία δοκιμής·
- αν έδειξε τιμή και εμφανίστηκε στην οθόνη, αν ο επισκέπτης άνοιξε το dock ή έκανε κλικ στο Book direct, αν εμφανίστηκε η προσφορά αποχώρησης, αν ο επισκέπτης αντέγραψε τον κωδικό της ή αποθήκευσε τη διανυκτέρευση, και αν το dock άνοιξε από μόνο του.
Αν ο επισκέπτης κάνει κάτι ακόμη μετά, όπως να αντιγράψει τον κωδικό, μια επόμενη αποστολή περιέχει μόνο το κλειδί ενσωμάτωσης, το hostname και ποιες από αυτές τις ενέργειες έκανε. Καμία αποστολή δεν περιέχει αναγνωριστικό, διεύθυνση σελίδας ή ημερομηνία διαμονής.
Ο edge server που λαμβάνει τις καταμετρήσεις χρησιμοποιεί τη διεύθυνση IP του επισκέπτη μόνο ως κλειδί για το όριο αιτημάτων του, 30 αποστολές το λεπτό· ο πάροχος φιλοξενίας μας κρατά αυτό το κλειδί για εκείνο το λεπτό. Ο server δεν καταγράφει τη διεύθυνση ούτε τη διαβιβάζει, και το StayParity δεν την αποθηκεύει ποτέ.
Πολιτική ασφάλειας περιεχομένου (CSP)
Αν η ιστοσελίδα στέλνει κεφαλίδα Content-Security-Policy, επιτρέψτε στην προέλευση του widget να φορτώνει το script και το iframe, και στο script να διαβάζει τις ρυθμίσεις του widget:
script-src https://badge.stayparity.com;
frame-src https://badge.stayparity.com;
connect-src https://badge.stayparity.com;Προσθέστε την προέλευση στις υπάρχουσες οδηγίες της πολιτικής· μην αντικαταστήσετε τις υπόλοιπες επιτρεπόμενες πηγές.
Το script ζητά τις ρυθμίσεις του widget από την προέλευσή του πριν δημιουργήσει το πλαίσιο, και αυτό το επιτρέπει το connect-src. Χωρίς αυτό, το widget εξακολουθεί να λειτουργεί, αλλά το πρόγραμμα περιήγησης καταγράφει παραβίαση CSP σε κάθε προβολή σελίδας, και το πλαίσιο ξεκινά στο σημείο της ετικέτας και μετά δίνει τη θέση του σε ένα δεύτερο στο τέλος της σελίδας, οπότε φορτώνεται δύο φορές. Το script ρυθμίζει τις διαστάσεις μέσω του DOM, χωρίς inline attributes style στον κώδικα HTML, οπότε ο κώδικας δεν απαιτεί αλλαγή του style-src.
Οι τιμές ζητούνται μέσα στο πλαίσιο, με τη δική του πολιτική. Αν χρησιμοποιείτε nonce ή strict-dynamic, προσθέστε το nonce της ιστοσελίδας στην ετικέτα script. Η προσθήκη του domain στην allowlist ενδέχεται να μην αρκεί.
Απενεργοποίηση ή αντικατάσταση
- Απενεργοποίηση: απενεργοποιήστε το Widget στις Ρυθμίσεις → Widget κρατήσεων. Οι νέοι επισκέπτες δεν βλέπουν τίποτα, γιατί το πλαίσιο συρρικνώνεται· το πρόγραμμα περιήγησης ενός επισκέπτη μπορεί να συνεχίσει να δείχνει ένα widget που φόρτωσε μέσα στα τελευταία πέντε λεπτά. Αν το ενεργοποιήσετε ξανά, ο ίδιος κώδικας λειτουργεί πάλι.
- Αλλαγή εμφάνισης ή νομίσματος: αλλάξτε την Εμφάνιση ή τις ρυθμίσεις νομίσματος στις Ρυθμίσεις → Widget κρατήσεων. Κάθε σελίδα με την ετικέτα ενημερώνεται μέσα σε ένα λεπτό, με τον ίδιο κώδικα.
- Μετάφραση: ενεργοποιήστε ή απενεργοποιήστε τη Μετάφραση του widget στις Ρυθμίσεις → Widget κρατήσεων. Κάθε σελίδα με την ετικέτα ενημερώνεται μέσα σε ένα λεπτό, με τον ίδιο κώδικα.
- Αντικατάσταση: η Αντικατάσταση κώδικα δημιουργεί νέο κλειδί ενσωμάτωσης. Το παλιό κλειδί απορρίπτεται στο επόμενο αίτημα που δεν εξυπηρετείται από την προσωρινή μνήμη, σε κάθε ιστοσελίδα που το έχει, μέχρι να επικολλήσετε τον νέο κώδικα. Ένα πρόγραμμα περιήγησης μπορεί να συνεχίσει να δείχνει ένα widget που αποθήκευσε στην προσωρινή μνήμη μέσα στα τελευταία πέντε λεπτά.
Μόνο οι διαχειριστές λογαριασμού μπορούν να ενεργοποιήσουν ή να απενεργοποιήσουν το widget, να αλλάξουν την εμφάνιση, τη γλώσσα ή το νόμισμά του ή να αντικαταστήσουν τον κώδικα.
Φόρτωση και απόδοση
Το script χρησιμοποιεί async, ώστε να μην καθυστερεί ποτέ τη σελίδα. Συμπιεσμένα, όπως τα κατεβάζουν τα προγράμματα περιήγησης, το script είναι περίπου 9 kB και το πλαίσιο του widget άλλα περίπου 32 kB κώδικα script. Δεν φορτώνει γραμματοσειρές.
Σε κάθε προβολή σελίδας δημιουργείται ένα πλαίσιο, όταν το πρόγραμμα περιήγησης είναι σε αδράνεια, αφού φορτωθεί η σελίδα ή, αν συμβεί νωρίτερα, 3 δευτερόλεπτα μετά το parsing της, ώστε να μην ανταγωνίζεται ποτέ τη φόρτωση της ίδιας της σελίδας. Όταν η πολιτική της ιστοσελίδας παραλείπει το connect-src, το πλαίσιο ξεκινά στο σημείο της ετικέτας και αντικαθίσταται στο τέλος της σελίδας, οπότε φορτώνεται δύο φορές.
Σε σελίδα με απενεργοποιημένο widget δεν δημιουργείται πλαίσιο. Πριν μάθει τη διανυκτέρευση, το widget ζητά μόνο την πιο κοντινή διανυκτέρευση με τιμή και, με ανενεργή τη ρύθμιση Πιο κοντινή διανυκτέρευση με τιμή, τίποτα. Μετά, ζητά ξανά τιμές μόνο όταν ο επισκέπτης καταλήξει σε άλλη διανυκτέρευση.
Webhooks
Το υπογεγραμμένο συμβάν JSON που στέλνει το StayParity όταν ένα OTA πουλάει κάτω από την απευθείας τιμή ενός ξενοδοχείου. Υπογραφές, επαναλήψεις, δοκιμές.
API ελέγχου τιμών
Δείξτε στο chatbot ή widget σας ό,τι δείχνει το widget StayParity ενός ξενοδοχείου: ένα GET, η απευθείας τιμή, όσα OTA δεν είναι φθηνότερα, ποτέ απόκλιση.