API & XML Feed

Τι είναι το XML product feed

Το XML product feed είναι ένα αρχείο που περιγράφει, με δομημένο τρόπο, ολόκληρο τον κατάλογο των προϊόντων σου. Κάθε προϊόν αναπαρίσταται ως μια εγγραφή με πεδία όπως όνομα, τιμή, διαθεσιμότητα και σύνδεσμο προς τη σελίδα του προϊόντος στο κατάστημά σου. Το cheepy.gr διαβάζει αυτό το αρχείο, ταυτοποιεί τα προϊόντα σου με τα αντίστοιχα προϊόντα άλλων καταστημάτων και τα εμφανίζει στις σελίδες σύγκρισης τιμών.

Σημαντικό: το cheepy.gr δεν πουλάει προϊόντα. Είμαστε μηχανή σύγκρισης τιμών ανάμεσα σε ελληνικά e-shops. Όταν ένας χρήστης επιλέξει τη δική σου προσφορά, οδηγείται απευθείας στη σελίδα του προϊόντος στο κατάστημά σου για να ολοκληρώσει την αγορά.

Πώς ξεκινάς: εγγραφή και υποβολή feed

Η εγγραφή του καταστήματος και η υποβολή του XML feed γίνονται μέσα από την πύλη καταστημάτων στο merchants.cheepy.gr. Εκεί δημιουργείς λογαριασμό, καταχωρείς τα στοιχεία του καταστήματος και δηλώνεις τη διεύθυνση (URL) του feed σου.

• Νέο κατάστημα; Κάνε εγγραφή εδώ.
• Έχεις ήδη λογαριασμό; Σύνδεση.

Μόλις δηλώσεις το URL του feed, το σύστημά μας το ανακτά και το επεξεργάζεται αυτόματα. Δεν χρειάζεται να μας στείλεις χειροκίνητα κάποιο αρχείο, αρκεί το URL να είναι προσβάσιμο δημόσια ή με τα διαπιστευτήρια που θα δηλώσεις.

Βασικά πεδία ανά προϊόν

Για να εμφανιστεί σωστά ένα προϊόν και να συγκριθεί με ασφάλεια απέναντι σε προσφορές άλλων καταστημάτων, για κάθε εγγραφή του feed περιμένουμε κατ' ελάχιστον τα παρακάτω πεδία:

• Όνομα προϊόντος — καθαρός, περιγραφικός τίτλος όπως εμφανίζεται στο κατάστημά σου.
• Τιμή — η τελική τιμή λιανικής με ΦΠΑ, σε ευρώ.
• Διαθεσιμότητα — αν το προϊόν είναι σε απόθεμα ή όχι (π.χ. διαθέσιμο / εξαντλημένο / κατόπιν παραγγελίας).
• URL προϊόντος — ο απευθείας σύνδεσμος προς τη σελίδα του προϊόντος στο e-shop σου.
• Εικόνα — URL μιας αντιπροσωπευτικής εικόνας του προϊόντος σε καλή ανάλυση.
• Ταυτοποιητικά (GTIN / EAN / MPN) — οι μοναδικοί κωδικοί ταυτοποίησης του προϊόντος, ιδανικά μαζί με τη μάρκα (brand).
• Μεταφορικά — το κόστος αποστολής, ώστε η σύγκριση να αντικατοπτρίζει το πραγματικό συνολικό κόστος για τον καταναλωτή.
• Κατηγορία — η κατηγορία του προϊόντος, που μας βοηθά στη σωστή κατάταξη.

Γιατί έχουν σημασία τα ταυτοποιητικά

Τα ταυτοποιητικά (GTIN, EAN, UPC, ISBN, καθώς και ο συνδυασμός μάρκας με MPN) είναι το πιο αξιόπιστο εργαλείο για να αντιστοιχίσουμε (κάνουμε matching) το προϊόν σου με το ίδιο ακριβώς προϊόν που πουλάνε και άλλα καταστήματα. Όταν αυτοί οι κωδικοί υπάρχουν και είναι σωστοί, η ταυτοποίηση γίνεται αυτόματα και με μεγάλη ακρίβεια: το προϊόν σου εμφανίζεται στην ίδια σελίδα σύγκρισης με τους ανταγωνιστές σου, αυξάνοντας την προβολή και τις πιθανότητες πώλησης.

Όταν τα ταυτοποιητικά λείπουν ή είναι λανθασμένα, η αντιστοίχιση στηρίζεται σε λιγότερο σίγουρα στοιχεία (όνομα, μάρκα, κατηγορία), κάτι που μπορεί να καθυστερήσει ή να εμποδίσει την εμφάνιση του προϊόντος. Συνιστούμε να συμπεριλαμβάνεις πάντα τα διαθέσιμα ταυτοποιητικά για κάθε προϊόν.

Ενδεικτική μορφή XML

Ένα απλό παράδειγμα μιας εγγραφής προϊόντος έχει περίπου τη μορφή: <product> <name>Όνομα προϊόντος</name> <price>199.90</price> <availability>Διαθέσιμο</availability> <link>https://to-eshop-sou.gr/proion</link> <image>https://to-eshop-sou.gr/eikona.jpg</image> <gtin>5201234567890</gtin> <mpn>ABC-123</mpn> <brand>Όνομα μάρκας</brand> <shipping>3.50</shipping> </product>. Τα ονόματα των ετικετών (tags) μπορεί να διαφέρουν ανάλογα με την πλατφόρμα του e-shop σου, αρκεί να μπορούμε να αντιστοιχίσουμε τα αντίστοιχα πεδία.

Συχνότητα ενημέρωσης (sync)

Το feed σου ανακτάται και συγχρονίζεται αυτόματα σε τακτά διαστήματα, ώστε οι τιμές και η διαθεσιμότητα που βλέπουν οι χρήστες να παραμένουν ενημερωμένες. Για τον λόγο αυτό είναι σημαντικό το URL του feed να είναι πάντα διαθέσιμο και να αντικατοπτρίζει τα τρέχοντα δεδομένα του καταστήματός σου. Αλλαγές σε τιμές, αποθέματα ή νέα προϊόντα αποτυπώνονται στο cheepy.gr με τον επόμενο συγχρονισμό.

Τεχνική υποστήριξη

Έχεις απορίες για τη δομή του feed, τα ταυτοποιητικά ή τον συγχρονισμό; Η ομάδα μας είναι στη διάθεσή σου στο [email protected]. Περίγραψέ μας το κατάστημά σου και την πλατφόρμα που χρησιμοποιείς, ώστε να σε καθοδηγήσουμε στη σωστή ρύθμιση.