Ενσωμάτωση Magento

Συνδέστε το κατάστημά σας Magento 2 με την επέκταση Joryio Connect. Συγχρονίστε προϊόντα, παραγγελίες, πελάτες και καλάθια, παρακολουθήστε τη συμπεριφορά στο κατάστημα και ανακτήστε εγκαταλελειμμένα καλάθια.

Δυνατότητες

• Επέκταση εγκαθιστώμενη με Composer - Εγγενές module Magento 2, χωρίς ανάγκη OAuth
• Αυτόματος συγχρονισμός - Προϊόντα, παραγγελίες, πελάτες και καλάθια ρέουν προς το Joryio κάθε λεπτό
• Ιστορική εισαγωγή - Τα υπάρχοντα προϊόντα, πελάτες και παραγγελίες (τελευταίες 90 ημέρες από προεπιλογή) εισάγονται κατά τη σύνδεση
• Ανάκτηση εγκαταλελειμμένων καλαθιών - Εντοπισμός εγκαταλελειμμένων καλαθιών και αποστολή συνδέσμων ανάκτησης που επαναφέρουν το καλάθι
• Παρακολούθηση καταστήματος - Συμβάντα προβολών σελίδων, προϊόντων και κατηγοριών, προσθήκης στο καλάθι και ολοκλήρωσης αγοράς
• Καταγραφή ταυτότητας - Αυτόματη αναγνώριση πελατών από σύνδεση, εγγραφή σε newsletter και ολοκλήρωση αγοράς
• Απόδοση εσόδων - Οι παραγγελίες αποδίδονται στην καμπάνια ή στο journey που τις οδήγησε
• Εναύσματα καταλόγου - Οι ενημερώσεις αποθέματος και τιμών τροφοδοτούν τα εναύσματα επιστροφής σε απόθεμα και πτώσης τιμής

Προαπαιτούμενα

• Magento Open Source ή Adobe Commerce 2.4.x
• Πρόσβαση γραμμής εντολών στον διακομιστή Magento σας με Composer
• Ρυθμισμένο και ενεργό cron του Magento - η επέκταση παραδίδει συμβάντα μέσω cron, οπότε αυτό είναι απαραίτητο
• Εξερχόμενη πρόσβαση HTTPS από τον διακομιστή Magento σας προς το Joryio

Βήματα ρύθμισης

Βήμα 1: Λάβετε το URL διακομιστή και το κλειδί API

1. Στο Joryio, μεταβείτε στις Ρυθμίσεις → Ενσωματώσεις → Magento
2. Αντιγράψτε το URL διακομιστή. Είναι η διεύθυνση της περιοχής όπου βρίσκεται ο λογαριασμός σας στο Joryio, για παράδειγμα https://api-eu1.joryio.com. Από την έκδοση 1.4.1 της επέκτασης δεν υπάρχει προεπιλογή, οπότε επικολλήστε ακριβώς αυτή την τιμή
3. Κάντε κλικ στη Δημιουργία κλειδιού API και αντιγράψτε το κλειδί (αρχίζει με jry_mg_). Όταν ανοίξετε ξανά αυτή τη σελίδα αργότερα, εμφανίζει το ίδιο κλειδί, κρυμμένο - κάντε κλικ στο εικονίδιο του ματιού για να το δείτε. Το κλειδί μένει ίδιο μέχρι να αποσυνδεθεί το κατάστημα

Βήμα 2: Εγκαταστήστε την επέκταση

Κατεβάστε το zip της επέκτασης (joryio-connect-magento2.zip) με το κουμπί Λήψη επέκτασης στη σελίδα ενσωμάτωσης Magento του πίνακα ελέγχου σας, αποσυμπιέστε το και εκτελέστε τις παρακάτω εντολές από τον ριζικό κατάλογο του Magento:

composer config repositories.joryio path /path/to/joryio-connect
composer require joryio/module-connect
bin/magento module:enable Joryio_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Εναλλακτικά (χωρίς composer): αποσυμπιέστε το zip στο app/code/Joryio/Connect και εκτελέστε τις ίδιες εντολές bin/magento.

Βήμα 3: Συνδεθείτε

1. Στο admin του Magento, μεταβείτε στο Stores → Configuration → Joryio
2. Επικολλήστε το URL διακομιστή και το κλειδί API από το Βήμα 1
3. Κάντε κλικ στο Connect

Η επέκταση δημιουργεί αυτόματα ένα διακριτικό πρόσβασης ενσωμάτωσης Magento και το μοιράζεται με ασφάλεια με το Joryio - δεν χρειάζεται να δημιουργήσετε κανένα διακριτικό χειροκίνητα. Το Joryio επικυρώνει τη σύνδεση και ξεκινά αμέσως πλήρη ιστορικό συγχρονισμό (προϊόντα, έπειτα πελάτες, έπειτα παραγγελίες - οι τελευταίες 90 ημέρες από προεπιλογή).

Όταν ολοκληρωθεί, η κατάσταση εμφανίζεται ως Connected τόσο στη σελίδα admin του Magento όσο και στον πίνακα ελέγχου του Joryio.

Αποδοχή διακριτικών πρόσβασης OAuth ως διακριτικών Bearer

Το Joryio διαβάζει το REST API του καταστήματός σας με το διακριτικό πρόσβασης της ενσωμάτωσης "Joryio", που αποστέλλεται ως διακριτικό Bearer. Από το Magento 2.4.4, το Magento το δέχεται μόνο όταν η ρύθμιση Stores → Configuration → Services → OAuth → Consumer Settings → Allow OAuth Access Tokens to be used as standalone Bearer tokens είναι Yes (η προεπιλογή είναι No). Όταν είναι No, το Connect (επέκταση v1.4.1 ή νεότερη) το εξηγεί και ρωτά πριν την ενεργοποιήσει - τίποτα δεν δημιουργείται πριν επιβεβαιώσετε. Είναι ρύθμιση για όλο το κατάστημα: ισχύει για τα διακριτικά πρόσβασης κάθε ενσωμάτωσης του καταστήματός σας. Μπορείτε επίσης να την ορίσετε σε Yes μόνοι σας και μετά να κάνετε κλικ στο Connect.

Αν μια σύνδεση αποτύχει, δεν μένει τίποτα πίσω: η ενσωμάτωση "Joryio" που δημιούργησε το Connect διαγράφεται (σε μια ενσωμάτωση από προηγούμενη σύνδεση ανακαλείται το διακριτικό της) και μια ρύθμιση Bearer που ενεργοποίησε το Connect απενεργοποιείται ξανά. Το μήνυμα δείχνει τον λόγο που δίνει το Joryio - δείτε Η σύνδεση αποτυγχάνει.

Τι συγχρονίζεται

Δεδομένα	Πώς	Πότε
Προϊόντα	Ιστορική εισαγωγή + ενημερώσεις σε πραγματικό χρόνο (συμπεριλαμβανομένων αλλαγών αποθέματος και τιμών)	Κατά τη σύνδεση, έπειτα συνεχώς
Πελάτες	Ιστορική εισαγωγή + ενημερώσεις σε πραγματικό χρόνο	Κατά τη σύνδεση, έπειτα συνεχώς
Παραγγελίες	Ιστορική εισαγωγή (τελευταίες 90 ημέρες από προεπιλογή) + ενημερώσεις σε πραγματικό χρόνο	Κατά τη σύνδεση, έπειτα συνεχώς
Καλάθια	Παρακολούθηση σε πραγματικό χρόνο + εντοπισμός εγκατάλειψης	Συνεχώς
Ταυτότητα	Σύνδεση, εγγραφή σε newsletter, email ολοκλήρωσης αγοράς	Συνεχώς

Οι ενημερώσεις πραγματικού χρόνου μπαίνουν σε τοπική ουρά στο κατάστημά σας και παραδίδονται στο Joryio από μια εργασία cron ανά λεπτό - γι' αυτό ένα υγιές cron του Magento είναι απαραίτητο. Οι ενημερώσεις αποθέματος και τιμών τροφοδοτούν επίσης τα εναύσματα καταλόγου (επιστροφή σε απόθεμα, πτώση τιμής).

Η διαγραφή ενός πελάτη στο κατάστημά σας δεν διαγράφει την επαφή στο Joryio. Για να διαγράψετε τα δεδομένα κάποιου, χρησιμοποιήστε τη Διαγραφή δεδομένων στην επαφή.

Προϊόντα, απόθεμα και κατηγορίες

• Τα διαμορφώσιμα προϊόντα (configurable) είναι ένα προϊόν στο Joryio. Τα θυγατρικά τους προϊόντα (για παράδειγμα κάθε μέγεθος ή χρώμα) γίνονται παραλλαγές του όταν έχουν ρυθμιστεί ως Not Visible Individually· ένα θυγατρικό που εμφανίζεται και μόνο του παραμένει επίσης προϊόν. Το προϊόν δείχνει τη χαμηλότερη τιμή θυγατρικού, είναι σε απόθεμα όταν κάποιο θυγατρικό είναι, και η ποσότητά του είναι το σύνολο των θυγατρικών. Κάθε παραλλαγή φέρει τις επιλογές της (για παράδειγμα Color: Red), και η διαγραφή ενός θυγατρικού το αφαιρεί από το προϊόν.
• Το απόθεμα διαβάζεται από τις πηγές σας όταν το κατάστημα χρησιμοποιεί Multi-Source Inventory (MSI), αλλιώς από τις ρυθμίσεις αποθέματος του προϊόντος· με MSI αφαιρούνται οι ποσότητες που έχουν δεσμευτεί από παραγγελίες που δεν έχουν αποσταλεί ακόμη (για έως 2.000 προϊόντα ανά συγχρονισμό - τα υπόλοιπα δείχνουν την ποσότητα της πηγής έως την επόμενη ενημέρωσή τους). Ένα προϊόν χωρίς διαχείριση αποθέματος εμφανίζεται σε απόθεμα, χωρίς ποσότητα.
• Οι κατηγορίες συγχρονίζονται με το όνομά τους (η ριζική κατηγορία του καταστήματος όχι).
• Οι γραμμές παραγγελίας ενός διαμορφώσιμου προϊόντος φέρουν το όνομα του προϊόντος και το SKU της παραλλαγής που αγόρασε ο πελάτης.
• Ποσά κουπονιών: το Magento αναφέρει μία έκπτωση για όλους τους κανόνες τιμών καλαθιού μιας παραγγελίας. Όταν το κουπόνι ήταν ο μόνος κανόνας, το ποσό του κουπονιού είναι η έκπτωση της παραγγελίας. Με περισσότερους κανόνες, το Joryio δείχνει το ποσό του κουπονιού μόνο όταν κάθε γραμμή με έκπτωση την πήρε από έναν κανόνα· αλλιώς η παραγγελία αναφέρει ότι το κατάστημα δεν το δήλωσε.

Οι κατηγορίες, το απόθεμα MSI και οι ενημερώσεις παραλλαγών από την επέκταση χρειάζονται την έκδοση 1.4.4 της επέκτασης - δείτε Αναβάθμιση στην 1.4.4.

Προγραμματισμένος έλεγχος συμφωνίας

Οι ζωντανές ενημερώσεις (το extension) μπορεί να χαθούν - για παράδειγμα όταν το κατάστημα είναι εκτός λειτουργίας ή όταν μια αποστολή αποτύχει πάρα πολλές φορές. Κάθε 6 ώρες το Joryio ελέγχει το κατάστημα για ό,τι άλλαξε από τον προηγούμενο έλεγχο και συμπληρώνει ό,τι έχασαν οι ζωντανές ενημερώσεις: παραγγελίες, πιστωτικά σημειώματα (επιστροφές χρημάτων), πελάτες και προϊόντα. Τα καλάθια έρχονται μόνο από το extension (το API του Magento δεν έχει λίστα εγκαταλελειμμένων καλαθιών που μπορεί να διαβάσει το Joryio).

Τίποτα δεν μετριέται δύο φορές: ένα στοιχείο που το Joryio έχει ήδη στην ίδια ή σε νεότερη έκδοση μένει ως έχει, και ένα παλαιότερο αντίγραφο δεν αντικαθιστά ποτέ ένα νεότερο.

• Μια παραγγελία που λείπει και έγινε τις τελευταίες 24 ώρες καταγράφεται σαν να είχε φτάσει ζωντανά, ώστε τα journeys μετά την αγορά να ξεκινούν κανονικά. Μια παλαιότερη παραγγελία που λείπει, και μια επιστροφή χρημάτων ή ακύρωση παραγγελίας που το Joryio ήδη γνώριζε, καταγράφονται χωρίς να ξεκινούν journeys· τα Order Refunded και Order Cancelled καταγράφονται και πάλι μία φορά το καθένα.
• Κάθε κατάστημα ελέγχεται στη δική του ώρα, ώστε να μη διαβάζονται όλα μαζί, και ένας έλεγχος διαβάζει περιορισμένο αριθμό αλλαγών· ένα κατάστημα με περισσότερες αλλαγές συνεχίζει μέσα σε μισή ώρα.
• Τα καταστήματα που είναι αποσυνδεδεμένα, σε σφάλμα ή σε συγχρονισμό παραλείπονται μέχρι να συνδεθούν ξανά.

Το αποτέλεσμα εμφανίζεται στο Ρυθμίσεις → Ενσωματώσεις → Magento: Τελευταίος έλεγχος συμφωνίας: 22/10/2026 12:00 - στοιχεία που συμπληρώθηκαν: 3. Αν οι έλεγχοι βρίσκουν συνεχώς αλλαγές που δεν έφτασαν ζωντανά, το Joryio εμφανίζει την ειδοποίηση Live updates from Magento may be failing (καμπανάκι, Logs & Monitoring και email στους διαχειριστές του workspace). Τα δεδομένα που λείπουν συμπληρώνονται σε κάθε περίπτωση, αλλά ελέγξτε τη σύνδεση του καταστήματος: τα journeys που αντιδρούν σε αυτές τις αλλαγές ξεκινούν με καθυστέρηση.

Η ίδια σελίδα δείχνει το Τελευταίο συμβάν που λήφθηκε - πότε έφτασε τελευταία φορά στο Joryio μια ζωντανή ενημέρωση από το κατάστημα (με καθυστέρηση έως ένα λεπτό) - και τον Τελευταίο συγχρονισμό, τον πιο πρόσφατο ανάμεσα στον τελευταίο πλήρη συγχρονισμό και τον τελευταίο έλεγχο συμφωνίας. Σε ένα κατάστημα που στέλνει ζωντανές ενημερώσεις, το Τελευταίο συμβάν που λήφθηκε προχωρά ακόμη κι όταν δεν έχει τρέξει συγχρονισμός.

Επιστροφές και ακυρώσεις

Μια επιστροφή χρημάτων σε παραγγελία Magento γίνεται ένα συμβάν Order Refunded με το ποσό που επιστράφηκε και κάθε ακυρωμένη παραγγελία ένα Order Cancelled, ώστε ένα journey να μπορεί να αντιδράσει. Η επέκταση αναφέρει τις ακυρώσεις και τις πλήρεις επιστροφές (κατάσταση closed) τη στιγμή που συμβαίνουν· ένα μερικό credit memo εντοπίζεται στον επόμενο συγχρονισμό παραγγελιών. Δείτε Συμβάντα επιστροφής και ακύρωσης.

Πώς τα δεδομένα του καταστήματος ενημερώνουν μια επαφή

Οι παραγγελίες, τα checkout και οι ενημερώσεις πελατών από το κατάστημά σας ενημερώνουν την αντίστοιχη επαφή στο Joryio:

• Τηλέφωνο - checkout επισκέπτη: ένα checkout από αγοραστή που δεν είναι συνδεδεμένος στο κατάστημα δεν αντικαθιστά ποτέ το υπάρχον τηλέφωνο μιας επαφής. Συμπληρώνει το τηλέφωνο μόνο όταν η επαφή δεν έχει - σε checkout επισκέπτη ο καθένας μπορεί να πληκτρολογήσει οποιοδήποτε email.
• Τηλέφωνο - συνδεδεμένοι πελάτες: μια παραγγελία από συνδεδεμένο πελάτη, και οι αλλαγές στον λογαριασμό του πελάτη στο κατάστημα, ενημερώνουν το τηλέφωνο της επαφής.
• Τα ονόματα ενημερώνονται από τις παραγγελίες και τις ενημερώσεις πελατών.
• Αριθμός πελάτη καταστήματος: ο αριθμός πελάτη Magento μιας επαφής προέρχεται από τα δεδομένα λογαριασμού πελάτη (ενημερώσεις πελατών, εισαγωγή πελατών και παραγγελίες συνδεδεμένων πελατών), ποτέ από checkout επισκέπτη. Όταν ο λογαριασμός έχει διαφορετικό email, ο αριθμός μεταφέρεται στην επαφή με αυτό το email.
• Η παραγγελία κρατά το τηλέφωνο που πληκτρολογήθηκε στο checkout στη διεύθυνση χρέωσης και αποστολής της, ό,τι κι αν συμβεί στην επαφή.
• Η συγκατάθεση για SMS που δόθηκε στο checkout με αριθμό διαφορετικό από της επαφής δεν εγγράφει τον αριθμό της επαφής.
• Άλλοι τρόποι να αλλάξει το τηλέφωνο μιας επαφής: checkout ως συνδεδεμένος πελάτης ή ο λογαριασμός του πελάτη στο κατάστημα, το SDK ή το API από τον δικό σας ιστότοπο ή εφαρμογή (για παράδειγμα αφού συνδεθεί το άτομο), μια εισαγωγή, ή η επεξεργασία της επαφής στο Joryio.

Παρακολούθηση καταστήματος

Η επέκταση προσθέτει ένα ελαφρύ απόσπασμα παρακολούθησης στο κατάστημά σας (ενεργό από προεπιλογή - μπορείτε να το απενεργοποιήσετε στο Stores → Configuration → Joryio). Κάθε συμβάν αποθηκεύεται με το τυπικό του όνομα (στήλη Αποθηκεύεται ως) - το ίδιο όνομα που χρησιμοποιούν οι ενσωματώσεις WooCommerce και Shopify και τα SDK:

Συμβάν	Αποθηκεύεται ως	Πότε στέλνεται
Page View	Page Viewed	Κάθε επίσκεψη σελίδας
Product Viewed	Product Viewed	Σελίδα προϊόντος. Περιέχει την κατάσταση αποθέματος: in_stock (true ή false) και stock_status (in_stock ή out_of_stock)
Category Viewed	Product List Viewed	Σελίδα κατηγορίας, με category_id, category_name και τη διεύθυνση της σελίδας (επέκταση v1.1.1 ή νεότερη)
Add to Cart	Product Added	Κάθε προσθήκη: το κουμπί AJAX, μια φόρμα προϊόντος που φορτώνει ξανά τη σελίδα, και η μεταφορά από τη λίστα επιθυμιών στο καλάθι. Το Magento καταγράφει την προσθήκη και ο browser του αγοραστή τη στέλνει μία φορά (επέκταση v1.1.1 ή νεότερη). Η επανάληψη παραγγελίας από το My Account δεν μετριέται
Checkout Started	Checkout Started	Η σελίδα ολοκλήρωσης αγοράς, μία φορά ανά καλάθι. Η επαναφόρτωσή της δεν είναι δεύτερη έναρξη
Identify	$identify	Καταγραφή email

Συνδεδεμένοι πελάτες (επέκταση 1.4.5 ή νεότερη). Όταν ένας πελάτης είναι συνδεδεμένος στο κατάστημα, η επέκταση υπογράφει τον αριθμό πελάτη Magento στον server του καταστήματος, και το identify μεταφέρει αυτή την απόδειξη. Το Joryio την ελέγχει και ενώνει την περιήγηση του επισκέπτη με την επαφή που έχει ήδη αυτόν τον αριθμό πελάτη - ποτέ με επαφή που βρέθηκε μέσω email, γιατί πολλές επαφές μπορεί να έχουν το ίδιο email. Το email που πληκτρολογεί ένας επισκέπτης χωρίς λογαριασμό ακολουθεί τη ρύθμιση Αναγνώριση επισκεπτών από το email που πληκτρολογούν του καταστήματος. Οι παλαιότερες εκδόσεις αναγνώριζαν έναν συνδεδεμένο πελάτη μόνο από το email, οπότε μπορούσε να μείνει μια δεύτερη επαφή μόνο με το email δίπλα στην επαφή του πελάτη· μετά την ενημέρωση, αυτή η δεύτερη επαφή ενώνεται με την επαφή του πελάτη την επόμενη φορά που ο πελάτης συνδέεται από τον ίδιο browser.

Κοινόχρηστοι browsers (επέκταση 1.4.25 ή νεότερη). Η αποσύνδεση από το κατάστημα δίνει στον browser νέο ανώνυμο επισκέπτη, ώστε το επόμενο άτομο στην ίδια συσκευή να μην εμφανίζεται ως το προηγούμενο. Ένας άλλος πελάτης που συνδέεται σε browser που χρησιμοποίησε άλλος πελάτης παίρνει πρώτα νέο επισκέπτη, και όταν το Joryio διαπιστώσει ότι ο επισκέπτης του browser ανήκει ήδη σε κάποιον άλλο (για παράδειγμα στον διαχειριστή του καταστήματος που τον χρησιμοποίησε πριν), η επέκταση ξεκινά νέο επισκέπτη και στέλνει ξανά την απόδειξη σύνδεσης. Το προφίλ και το ιστορικό του προηγούμενου ατόμου μένουν όπως είναι, και δύο άτομα δεν συγχωνεύονται ποτέ. Όσο αυτό ξεκαθαρίζει, τα συμβάντα μιας σελίδας περιμένουν το πολύ λίγα δευτερόλεπτα.

Τα συμβάντα προϊόντων περιέχουν product_id, variant_id (η επιλογή ενός configurable προϊόντος), quantity, price, currency και την κατάσταση αποθέματος.

Το απόσπασμα καταγράφει επίσης παραμέτρους UTM και τα click IDs του Joryio από τους συνδέσμους των καμπανιών σας, ώστε οι παραγγελίες να αποδίδονται πίσω στην καμπάνια ή στο journey που οδήγησε την πώληση. Δείτε την Απόδοση εσόδων.

Content Security Policy

Από την επέκταση 1.4.6 το snippet παρακολούθησης δεν περιέχει inline script: είναι ένα αρχείο που σερβίρεται από το κατάστημά σας (Joryio_Connect/js/tracking.js), και οι ρυθμίσεις του είναι ένα μπλοκ δεδομένων στη σελίδα. Το Magento 2.4.7 και νεότερα επιβάλλουν αυστηρή Content Security Policy στις σελίδες ολοκλήρωσης αγοράς και πληρωμής, η οποία μπλοκάρει τα inline scripts - με την 1.4.5 ή παλαιότερη, η ολοκλήρωση αγοράς δεν έστελνε Checkout Started, ούτε identify από το πεδίο email, ούτε Page View. Τίποτα δεν χρειάζεται 'unsafe-inline'. Η επέκταση προσθέτει στην πολιτική τα *.joryio.com και sdk.joryio.com για scripts και κλήσεις API· αν το Server URL σας δεν είναι στο joryio.com, προσθέστε μόνοι σας τον host του στην πολιτική σας. Μετά την αναβάθμιση ενός καταστήματος σε λειτουργία production, εκτελέστε bin/magento setup:static-content:deploy ώστε να δημοσιευτεί το νέο αρχείο.

Μετά την αλλαγή ρυθμίσεων

Οι ρυθμίσεις του snippet - το Server URL, το Inject Tracking Snippet και οι ρυθμίσεις μηνυμάτων in-app και web push - είναι μέρος κάθε σελίδας, οπότε η full-page cache του Magento κρατά τις τιμές με τις οποίες αποθηκεύτηκε η σελίδα. Από την επέκταση 1.4.6, τα Save Config, Connect και Disconnect καθαρίζουν ακριβώς τις αποθηκευμένες σελίδες που περιέχουν το snippet, στην page cache του Magento και στο Varnish, και αφήνουν την υπόλοιπη cache ανέγγιχτη. Με την 1.4.5 ή παλαιότερη, εκτελέστε bin/magento cache:flush μετά την αλλαγή αυτών των ρυθμίσεων. Ένα CDN ή μια proxy cache μπροστά από το Magento δεν καθαρίζεται από το Magento: καθαρίστε το μετά την αλλαγή του Server URL. Μέχρι τότε, μια παλιά σελίδα της cache δεν στέλνει τίποτα σε έναν browser που έχει ήδη φορτώσει μια φρέσκια σελίδα - ποτέ δεν στέλνει στην παλιά διεύθυνση. Το Magento μπορεί να εμφανίζει ακόμη One or more of the Cache Types are invalidated: Page Cache μετά το Save Config: το Magento σημειώνει έτσι την page cache μετά από κάθε αποθήκευση ρυθμίσεων, σε οποιαδήποτε ενότητα. Οι σελίδες με το snippet έχουν ήδη καθαριστεί· ανανεώστε την Page Cache στο System > Cache Management όποτε σας βολεύει.

Προβολές σελίδων και web SDK. Το συμβάν Page View στέλνεται πάντα από το snippet παρακολούθησης. Το trackPageViews: false στις ρυθμίσεις web SDK του snippet απενεργοποιεί μόνο τις αυτόματες προβολές σελίδων του ίδιου του SDK, ώστε κάθε σελίδα να μετριέται μία φορά.

Αναγνώριση επισκεπτών από το email που πληκτρολογούν

Από την έκδοση 1.4.21 της επέκτασης, το Stores → Configuration → Joryio έχει το Recognise visitors by the email they type. Είναι ενεργό από προεπιλογή, και μια παλαιότερη επέκταση συμπεριφέρεται σαν να είναι ενεργό. Αναφέρεται η τιμή του Default Config.

• Ενεργό (προεπιλογή) - ένα email που πληκτρολογεί ο επισκέπτης στο ταμείο ή σε μια φόρμα αναγνωρίζει τον browser του ως την επαφή με αυτό το email: την υπάρχουσα επαφή (αυτή που ήταν ενεργή πιο πρόσφατα, όταν πολλές επαφές έχουν το ίδιο email - δείτε παρακάτω) ή μια νέα. Η προηγούμενη περιήγηση του επισκέπτη ενώνεται με αυτή την επαφή, και δεν δημιουργείται δεύτερη επαφή με το ίδιο email. Αυτό περιμένουν τα περισσότερα καταστήματα. Το αντάλλαγμα: όποιος πληκτρολογεί το email κάποιου άλλου αναγνωρίζεται ως εκείνο το άτομο σε αυτόν τον browser - για παράδειγμα, θα μπορούσε να δει τα in-app μηνύματα και το εξατομικευμένο περιεχόμενο εκείνου του ατόμου.
• Ανενεργό (αυστηρή ταυτότητα) - ένα πληκτρολογημένο email δεν αναγνωρίζει ποτέ τον browser. Το καλάθι, η παραγγελία και η υποβολή της φόρμας πηγαίνουν και πάλι στην επαφή με αυτό το email, οπότε τα email εγκαταλελειμμένου καλαθιού φτάνουν και πάλι στη διεύθυνση που πληκτρολογήθηκε. Μόνο ένας πελάτης συνδεδεμένος στο κατάστημα αναγνωρίζεται στον browser.

Το Joryio δείχνει τη ρύθμιση μόνο για ανάγνωση στο Ενσωματώσεις → Magento → Ρυθμίσεις, με την έκδοση και πότε αναφέρθηκε τελευταία φορά - αλλάζει μόνο μέσα από η επέκταση. Η αποθήκευση την αναφέρει αμέσως στο Joryio, και μια αλλαγή ισχύει μέσα σε λίγα λεπτά.

Το καλάθι ακολουθεί το email που πληκτρολογήθηκε, και ένα διορθωμένο email. Το καλάθι ενός επισκέπτη μεταφέρεται στην επαφή που ορίζει το email του στο ταμείο μόλις το πληκτρολογήσει, όχι μόνο όταν αναφερθεί το εγκαταλελειμμένο καλάθι. Όταν ένας επισκέπτης διορθώνει ένα λάθος πληκτρολογημένο email, η λάθος διεύθυνση αφαιρείται ξανά και η διορθωμένη αντιστοιχίζεται όπως κάθε άλλη, οπότε ο επισκέπτης και το καλάθι μεταφέρονται στη σωστή επαφή και καμία επαφή δεν μένει με το λάθος. Μια πληκτρολογημένη διεύθυνση αφαιρείται μόνο όσο τίποτε άλλο στην επαφή δεν ορίζει ένα πρόσωπο: μια παραγγελία, ένας αριθμός τηλεφώνου, μια επιλογή συγκατάθεσης, ένας λογαριασμός στο κατάστημα ή μια διεύθυνση που πληκτρολογήθηκε πριν από περισσότερο από μία ημέρα την κρατούν.

Όταν πολλές επαφές έχουν το ίδιο email

Ένα email μπορεί να ανήκει σε περισσότερες από μία επαφές στο Joryio (για παράδειγμα ένα ζευγάρι, ή ένα άτομο που εισήχθη δύο φορές). Όταν το email ενός επισκέπτη στο ταμείο ταιριάζει με πολλές επαφές, το καλάθι, το ταμείο και η παραγγελία πηγαίνουν στην επαφή που ήταν ενεργή πιο πρόσφατα - ο ίδιος κανόνας που χρησιμοποιούν οι εισαγωγές, το API και οι φόρμες, ώστε το ιστορικό ενός ατόμου να μη μοιράζεται σε δύο επαφές. Μόλις ένα ταμείο επιλέξει επαφή, μένει σε αυτήν: οι επόμενες ενημερώσεις του καλαθιού, η συγκατάθεση, το εγκαταλελειμμένο καλάθι, η παραγγελία και οι αλλαγές κατάστασής της πηγαίνουν όλες στην ίδια επαφή, ακόμη κι αν η άλλη επαφή αλλάξει στο μεταξύ. Ένας πελάτης συνδεδεμένος στο κατάστημα πηγαίνει πάντα στην επαφή που έχει τον λογαριασμό πελάτη του στο κατάστημα. Οι επαφές δεν συγχωνεύονται ποτέ, και μια απεγγραφή εξακολουθεί να ισχύει για κάθε επαφή με το email.

Μηνύματα in-app και web push

Από την έκδοση v1.3.0 της επέκτασης, το snippet παρακολούθησης φορτώνει στο κατάστημα και το web SDK του Joryio, από το https://sdk.joryio.com/web/1/joryio.min.js (την πιο πρόσφατη έκδοση 1.x). Οι κλήσεις δεδομένων του πηγαίνουν στο Server URL που ορίσατε, όπως και του snippet. Οι ρυθμίσεις βρίσκονται στο Stores → Configuration → Joryio → In-app messages and web push:

Ρύθμιση	Προεπιλογή	Τι κάνει
In-app messages	Yes	Εμφανίζει τα μηνύματα in-app του Joryio στο κατάστημα
Allow HTML in-app messages	Yes	Εμφανίζει και μηνύματα που φτιάχτηκαν με τον επεξεργαστή HTML. Εμφανίζονται σε προστατευμένο πλαίσιο στο κατάστημά σας: τα scripts που περιέχουν δεν εκτελούνται και το μήνυμα δεν μπορεί να προσπελάσει τις σελίδες του καταστήματος ούτε να κάνει δικές του αιτήσεις δικτύου
Web push	No	Επιτρέπει στους αγοραστές να εγγραφούν σε ειδοποιήσεις προγράμματος περιήγησης

Τα καταστήματα που αναβαθμίζουν από παλαιότερη έκδοση παίρνουν τις ίδιες προεπιλογές. Το SDK φορτώνεται από το snippet παρακολούθησης, οπότε αφήστε ενεργό το Inject Tracking Snippet. Η επέκταση επιτρέπει το *.joryio.com στο Content Security Policy του Magento για scripts και κλήσεις API.

Τίποτα δεν μετριέται δύο φορές. Το SDK χρησιμοποιεί το ανώνυμο αναγνωριστικό επισκέπτη του snippet, άρα και τα δύο ανήκουν σε ένα προφίλ. Τα email εξακολουθούν να αναγνωρίζονται μόνο από το snippet, και το SDK δεν στέλνει δικές του προβολές σελίδων ή ενάρξεις συνεδρίας: τα γεγονότα σελίδων και καλαθιού έρχονται από το snippet, όπως πριν.

Web push. Ένα πρόγραμμα περιήγησης δέχεται το service worker των ειδοποιήσεων μόνο από τη διεύθυνση του ίδιου του καταστήματος. Με ενεργό το Web push, η επέκταση απαντά στο https://your-store/joryio-sw.js (μια διαδρομή του Magento που καλύπτει όλο το κατάστημα), η οποία φορτώνει το φιλοξενούμενο worker του Joryio. Οι τυπικές ρυθμίσεις nginx και Apache του Magento περνούν αυτή τη διεύθυνση στο Magento· αν ο διακομιστής σας σερβίρει αρχεία .js απευθείας από τον δίσκο, προσθέστε ένα rewrite από το /joryio-sw.js στο /joryio/sw/index. Οι αγοραστές ερωτώνται μέσω ενός μηνύματος in-app εγγραφής σε ειδοποιήσεις, οπότε αφήστε τα μηνύματα in-app ενεργά και ενεργοποιήστε το web push για την εφαρμογή και στο Joryio. Αν απενεργοποιήσετε το web push, η ίδια διεύθυνση σερβίρει ένα worker που αφαιρεί τον εαυτό του από τους browsers των επισκεπτών.

Ενεργοποιήστε το web push και στο Joryio. Η σύνδεση του καταστήματος δημιούργησε μια εφαρμογή γι' αυτό στο Joryio (Ρυθμίσεις → Εφαρμογές, με το όνομα του καταστήματος). Ανοίξτε την, πατήστε την καμπάνα (Push) και Ενεργοποίηση web push: έτσι δημιουργούνται τα κλειδιά web push του καταστήματος, που το SDK στο κατάστημά σας διαβάζει μόνο του - δεν χρειάζεται να αντιγράψετε τίποτα. Μετά δημιουργήστε ένα μήνυμα in-app με ένα κουμπί ρυθμισμένο σε Ζήτησε ενεργοποίηση ειδοποιήσεων και εμφανίστε το σε εκείνη την εφαρμογή· οι πελάτες που αποδέχονται μπορούν να λαμβάνουν τις καμπάνιες push και τα βήματα διαδρομών σας.

Συγκατάθεση μάρκετινγκ

Η συνδρομή στο newsletter του Magento στέλνεται στο Joryio (επέκταση v1.1.0 ή νεότερη) και εφαρμόζεται στη συνδρομή email της επαφής:

Στο Magento	Στο Joryio
Subscribed	Εγγραφή στο email. Όποιος διαγράφηκε επανεγγράφεται μόνο στις περιπτώσεις του Τι κάνει μια εγγραφή ή διαγραφή από το κατάστημα· διαφορετικά μπορεί να εγγραφεί ξανά ο ίδιος από το κέντρο προτιμήσεων.
Unsubscribed	Απεγγραφή από το email - εκτός αν το Joryio κατέγραψε μεταγενέστερη αλλαγή για την επαφή.
Not Activated, Unconfirmed	Καμία αλλαγή.

Μετρά κάθε τρόπος με τον οποίο αλλάζει η κατάσταση: το κουτί "Sign Up for Newsletter" στη φόρμα εγγραφής και στη σελίδα λογαριασμού, το διαχειριστικό του καταστήματος, το API και ο σύνδεσμος απεγγραφής στα newsletter σας. Η ιστορική εισαγωγή εγγράφει τους πελάτες που το Magento δείχνει ως εγγεγραμμένους· δεν απεγγράφει κανέναν, γιατί το API του Magento δεν ξεχωρίζει το "δεν εγγράφηκε ποτέ" από το "απεγγράφηκε". Κάθε αλλαγή καταγράφεται στο ιστορικό συνδρομής της επαφής (πηγή magento_newsletter), με το επίπεδο συγκατάθεσης (επιβεβαιωμένη όταν είναι ενεργό το Need to Confirm του Magento) και τον χρόνο που το Magento κατέγραψε την αλλαγή.

Απόδειξη που καταγράφεται (επέκταση 1.4.28): το πλαίσιο συγκατάθεσης του ταμείου σε μια παραγγελία καταγράφει επίσης τη διεύθυνση IP της παραγγελίας και τη σελίδα του ταμείου, και μια αλλαγή newsletter στο κατάστημα (η φόρμα εγγραφής, η σελίδα λογαριασμού, το μπλοκ newsletter, ο σύνδεσμος διαγραφής) τη διεύθυνση IP του επισκέπτη. Μια αλλαγή από το admin, μέσω του API ή από cron δεν καταγράφει καμία. Η διεύθυνση IP εμφανίζεται μόνο σε μέλη της ομάδας που μπορούν να βλέπουν προσωπικά δεδομένα, περιλαμβάνεται όταν το άτομο ζητά τα δεδομένα του και διαγράφεται όταν διαγράφονται τα δεδομένα του.

Ποιος μετράει αμέσως: μια εγγραφή στο newsletter μετράει αμέσως για έναν γνωστό αγοραστή (το Joryio έχει παραγγελία από την επαφή) ή κάποιον ήδη εγγεγραμμένο σε email ή SMS, καθώς και όταν το Magento την επιβεβαίωσε - το Need to Confirm είναι ενεργό και ο αγοραστής πάτησε το email επιβεβαίωσης του Magento. Το Magento δεν επαληθεύει καμία διεύθυνση στην εγγραφή, στη σελίδα λογαριασμού, στο διαχειριστικό ή μέσω του API, οπότε οποιοσδήποτε άλλος - και η ιστορική εισαγωγή - μένει σε εκκρεμότητα μέχρι τη δική του παραγγελία με το κουτί επιλεγμένο ή ένα κλικ στο email επιβεβαίωσης του Joryio, εκτός αν επιλέξετε να μετράνε αμέσως: δείτε Συγκαταθέσεις από νέους αγοραστές. Μια απεγγραφή ισχύει πάντα αμέσως.

Κουτί συγκατάθεσης στο ταμείο

Το Magento δεν έχει κουτί newsletter στο ταμείο. Για να ρωτήσετε εκεί, ενεργοποιήστε το Stores → Configuration → Joryio → Marketing Consent Checkbox → Show the Checkbox at Checkout. Το κουτί εμφανίζεται κάτω από τους τρόπους πληρωμής.

Ρύθμιση	Προεπιλογή	Σημειώσεις
Show the Checkbox at Checkout	No
Checkbox Text	"Yes, I'd like to receive news and offers by email"	Το ακριβές κείμενο που είδε ο αγοραστής καταγράφεται μαζί με την επιλογή του.
Ticked by Default	No	Δεν συνιστάται - σύμφωνα με τον GDPR (ΕΕ και Ηνωμένο Βασίλειο) ένα προεπιλεγμένο κουτί δεν είναι έγκυρη συγκατάθεση.
SMS Consent Checkbox	No	Δεύτερο κουτί για μηνύματα SMS, με δικό του κείμενο. Καταγράφεται το τηλέφωνο χρέωσης.

Ένα τικ εγγράφει την επαφή (επανεγγράφει όποιον διαγράφηκε μόνο στις περιπτώσεις παρακάτω, και ποτέ διεύθυνση της λίστας αποκλεισμού)· ένα κενό κουτί δεν αλλάζει τίποτα. Το τικ ενός συνδεδεμένου πελάτη είναι η εξαίρεση - δείτε Τι κάνει μια εγγραφή ή διαγραφή από το κατάστημα. Η επιλογή, το κείμενο που εμφανίστηκε και ο χρόνος στέλνονται με την παραγγελία και καταγράφονται στο ιστορικό συνδρομής της επαφής (πηγή magento_checkout). Τα ονόματα των ρυθμίσεων δίνονται στα αγγλικά, γιατί το διαχειριστικό της επέκτασης είναι διαθέσιμο μόνο στα αγγλικά. Με την προαιρετική ρύθμιση Ένα κενό πλαίσιο καταργεί την εγγραφή ενεργή, ένα κενό πλαίσιο σε ολοκληρωμένη παραγγελία καταγράφει αντί γι' αυτό διαγραφή.

Πότε μετράει ένα τικ

Επέκταση 1.4.14 ή νεότερη: Stores → Configuration → Joryio → Marketing Consent Checkbox → When a Shopper Ticks the Checkout Opt-In.

Επιλογή	Τι γίνεται
Only when the order is placed (προεπιλογή)	Η επιλογή φτάνει στο Joryio με την παραγγελία. Ένας αγοραστής που τσεκάρει και εγκαταλείπει δεν εγγράφεται.
Record consent immediately	Η επιλογή φτάνει στο Joryio μόλις τη κάνει ο αγοραστής, πριν παραγγείλει. Οι γνωστοί αγοραστές και συνδρομητές μετράνε αμέσως· ένας νέος επισκέπτης μετράει μετά την παραγγελία του ή αφού επιβεβαιώσει με email (παρακάτω). Αν ο αγοραστής ξε-τσεκάρει το κουτί στο ίδιο ταμείο, αυτή η επιλογή ανακαλείται - μόνο αυτή: μια συνδρομή που έδωσε οπουδήποτε αλλού παραμένει. Το συμβάν εγκαταλελειμμένου καλαθιού μεταφέρει επίσης το κουτί όπως το άφησε ο αγοραστής.

Ποιος μετράει αμέσως με το Record consent immediately (1.4.16 ή νεότερη):

Αγοραστής	Τι κάνει μια επιλογή πριν από την παραγγελία
Ένας γνωστός αγοραστής (το Joryio έχει παραγγελία της επαφής) ή κάποιος ήδη εγγεγραμμένος σε email ή SMS	Μετράει αμέσως: εγγράφεται, οπότε η υπενθύμιση εγκαταλελειμμένου καλαθιού μπορεί να τον φτάσει.
Ένας νέος επισκέπτης	Μένει σε εκκρεμότητα: η επιλογή καταγράφεται (κείμενο, ώρα, κατάστημα, ταμείο), αλλά η επαφή δεν εγγράφεται και δεν λαμβάνει μάρκετινγκ - μια υπενθύμιση εγκαταλελειμμένου καλαθιού παραλείπεται ως Αναμένει επιβεβαίωση. Η δική του παραγγελία με τσεκαρισμένο κουτί τον εγγράφει, όπως και ένα κλικ στο email επιβεβαίωσης, αν το ενεργοποιήσετε.
Κάποιος που απεγγράφηκε και δεν έχει παραγγείλει	Μένει απεγγεγραμμένος. Η παραγγελία του ακολουθεί τότε τους κανόνες παρακάτω.

Γιατί: σε ταμείο επισκέπτη ο καθένας μπορεί να πληκτρολογήσει οποιοδήποτε email. Χωρίς αυτόν τον κανόνα ένα bot θα μπορούσε να βάλει ένα προϊόν στο καλάθι, να πληκτρολογήσει το email ενός αγνώστου, να τσεκάρει το κουτί και να φύγει - εγγράφοντας κάποιον που δεν παρήγγειλε ποτέ.

Δύο δικλίδες ασφαλείας στις Ενσωματώσεις → Magento → Ρυθμίσεις (μόνο διαχειριστές· κάθε αλλαγή καταγράφεται στο αρχείο ελέγχου):

• Αποστολή συνδέσμου επιβεβαίωσης με email σε νέους επισκέπτες - ανενεργό από προεπιλογή, επειδή η διεύθυνση πληκτρολογήθηκε στο ταμείο και δεν την έχει επαληθεύσει ακόμη κανείς. Όταν είναι ενεργό, ένας νέος επισκέπτης σε εκκρεμότητα λαμβάνει ένα email· ο σύνδεσμός του τον εγγράφει (πηγή double_opt_in). Χρησιμοποιεί το πρότυπο επιβεβαίωσης double opt-in, αν έχετε επιλέξει.

• Επιλογές συγκατάθεσης ανά αγοραστή την ώρα - προεπιλογή 3, ανά διεύθυνση IP, ανά ταμείο και ανά διεύθυνση email. Όσες επιλογές ξεπερνούν το όριο αγνοούνται και το συμβάν εγκαταλελειμμένου καλαθιού εκείνου του ταμείου δεν μεταφέρει συγκατάθεση· η παραγγελία καταγράφει πάντα την επιλογή. Η επέκταση έχει το ίδιο όριο (Opt-In Ticks per Shopper per Hour, προεπιλογή 3) και σταματά μια τέτοια επιλογή πριν σταλεί.

• Μετράει μόνο ένα τικ που κάνει ο ίδιος ο αγοραστής, και στις δύο επιλογές. Ένα κουτί που εμφανίζεται ήδη τσεκαρισμένο (Ticked by Default) μετράει μόνο αφού ο αγοραστής αλληλεπιδράσει μαζί του: αν μείνει ανέγγιχτο, δεν είναι συγκατάθεση - ούτε αμέσως ούτε με την παραγγελία. Ξετσεκάρισμα και ξανά τσεκάρισμα μετράει.

• Κάθε αλλαγή στέλνεται μία φορά· το άνοιγμα ή η ανανέωση του checkout δεν στέλνει τίποτα.

• Όποιος έχει απεγγραφεί επανεγγράφεται μόνο όπως περιγράφεται στο Τι κάνει μια εγγραφή ή διαγραφή από το κατάστημα. Ένα ξετσεκάρισμα δεν απεγγράφει ποτέ κανέναν - μόνο αποσύρει το τικ που έγινε σε εκείνο το checkout.

• Το κατάστημα πρέπει να γνωρίζει το email του αγοραστή τη στιγμή του τικ (το Magento το ζητά πριν από το βήμα πληρωμής). Αν δεν το γνωρίζει ακόμη, η επιλογή ταξιδεύει με το εγκαταλελειμμένο καλάθι ή την παραγγελία.

Διατύπωση συγκατάθεσης και GDPR

Με το Record consent immediately, μια επιλογή είναι από μόνη της συγκατάθεση μάρκετινγκ - δεν συνδέεται με αγορά. Φροντίστε το κείμενο του κουτιού να λέει τι δέχεται να λαμβάνει ο αγοραστής και από ποιο κανάλι (για παράδειγμα "Yes, I'd like to receive news and offers by email"), αφήστε το κουτί ατσέκαρτο από προεπιλογή και χωριστό από την αποδοχή των όρων σας, και αναφέρετέ το στη δήλωση απορρήτου σας. Το Joryio καταγράφει με κάθε επιλογή το κείμενο που εμφανίστηκε, την ώρα, το κατάστημα, το ταμείο και τη διεύθυνση IP του αγοραστή. Η επιλογή ενός νέου επισκέπτη μένει σε εκκρεμότητα μέχρι τη δική του παραγγελία ή επιβεβαίωση, ώστε κανείς να μη λαμβάνει μάρκετινγκ επειδή κάποιος άλλος πληκτρολόγησε τη διεύθυνσή του· το email επιβεβαίωσης στέλνεται μόνο αν το ενεργοποιήσετε. Η υπενθύμιση εγκαταλελειμμένου καλαθιού φτάνει τότε σε έναν εγγεγραμμένο αγοραστή ως μήνυμα μάρκετινγκ.

Εμφανίζεται στο Joryio, ορίζεται στην επέκταση

Το Ενσωματώσεις → Magento → Ρυθμίσεις δείχνει τις ρυθμίσεις συγκατάθεσης στο ταμείο της επέκτασης στην κάρτα Store checkout opt-in (set in your store), μόνο για ανάγνωση: Show the Checkbox at Checkout, Ticked by Default και When a Shopper Ticks the Checkout Opt-In, με την έκδοση της επέκτασης και το πότε τις ανέφερε τελευταία φορά. Τις αλλάζετε μόνο στο Magento, στο Stores → Configuration → Joryio → Marketing Consent Checkbox· το Joryio δεν τις αλλάζει ποτέ. Εμφανίζονται οι τιμές του Default Config - ένα store view που αντικαθιστά κάποια δεν εμφανίζεται. Με Record consent immediately, η κάρτα δείχνει επίσης τις ρυθμίσεις του Joryio που τότε αποφασίζουν τι κάνει μια επιλογή: Opt-ins from new shoppers, το email επιβεβαίωσης και το ωριαίο όριο.

Η επέκταση 1.4.17 ή νεότερη τις αναφέρει με κάθε αίτημα που στέλνει στο Joryio - καλάθια, εγκαταλελειμμένα καλάθια, παραγγελίες, πελάτες, προϊόντα και τα υπόλοιπα - και ξανά όταν αποθηκεύετε μία από αυτές. Μια αλλαγή, όπως νέα έκδοση της επέκτασης μετά από ενημέρωση, εμφανίζεται από το επόμενο αίτημα· μια αναφορά που δεν άλλαξε καταγράφεται ξανά το πολύ μία φορά την ώρα, οπότε η τελευταία αναφορά μπορεί να είναι έως μίας ώρας. Με παλαιότερη επέκταση η κάρτα γράφει Not reported yet - update the plugin.

Συγκαταθέσεις από νέους αγοραστές

Η ρύθμιση Συγκαταθέσεις από νέους αγοραστές (που δεν έχουν αγοράσει ακόμη) στις Ενσωματώσεις → Magento → Ρυθμίσεις (μόνο διαχειριστές· κάθε αλλαγή καταγράφεται στο αρχείο ελέγχου) ορίζει τι κάνει μια συγκατάθεση από κάποιον που δεν έχει αγοράσει ακόμη:

Επιλογή	Τι συμβαίνει
Αναμονή μέχρι να παραγγείλουν ή να επιβεβαιώσουν με email (προεπιλογή, συνιστάται)	Η συγκατάθεση ενός νέου αγοραστή μένει σε εκκρεμότητα μέχρι τη δική του παραγγελία με το κουτί επιλεγμένο ή ένα κλικ στο email επιβεβαίωσης (αν ενεργοποιήσατε το Αποστολή συνδέσμου επιβεβαίωσης με email σε νέους επισκέπτες).
Να μετράνε αμέσως (λιγότερο αυστηρό - οποιοσδήποτε επισκέπτης μπορεί να εισαγάγει οποιοδήποτε email)	Μετράει αμέσως. Οποιοσδήποτε επισκέπτης μπορεί να πληκτρολογήσει οποιοδήποτε email, οπότε κάποιος μπορεί να εγγράψει άλλο άτομο· εκείνο μπορεί να διαγραφεί με ένα κλικ.

Καλύπτει κάθε συγκατάθεση που φτάνει χωρίς παραγγελία: την εγγραφή στο newsletter από τη φόρμα εγγραφής, τη σελίδα λογαριασμού, το διαχειριστικό και το API, την ιστορική εισαγωγή και - με το Record consent immediately - την επιλογή στο checkout. Σε κάθε περίπτωση:

• ένας γνωστός αγοραστής ή κάποιος ήδη εγγεγραμμένος μετράει αμέσως, όπως και μια εγγραφή που επιβεβαίωσε το Magento (Need to Confirm)·
• μια επιλογή που έρχεται με την παραγγελία του ίδιου του αγοραστή μετράει πάντα·
• μια απεγγραφή ισχύει πάντα αμέσως·
• το όριο Επιλογές συγκατάθεσης ανά αγοραστή την ώρα παραμένει σε ισχύ.

Δεν είναι η ίδια ρύθμιση με το When a Shopper Ticks the Checkout Opt-In της επέκτασης: εκείνη ορίζει πότε στέλνεται μια επιλογή στο checkout - με την παραγγελία ή μόλις γίνει· αυτή ορίζει τι κάνει μια πρώιμη συγκατάθεση από νέο αγοραστή. Με το Only when the order is placed, μια επιλογή στο checkout έρχεται με την παραγγελία και μετράει πάντα, οπότε αυτή η ρύθμιση καλύπτει μόνο τις συγκαταθέσεις στην εγγραφή και στον λογαριασμό.

Τι κάνει μια εγγραφή ή διαγραφή από το κατάστημα

Τι στέλνει το κατάστημα	Τι κάνει το Joryio
Επιλογή συγκατάθεσης σε checkout επισκέπτη	Εγγράφει μια επαφή που δεν έχει ακόμη συνδρομή σε αυτό το κανάλι. Εκτός αν είναι ενεργή η ρύθμιση του καταστήματος παρακάτω, δεν επανεγγράφει ποτέ κάποιον που διαγράφηκε - σε checkout επισκέπτη ο καθένας μπορεί να πληκτρολογήσει οποιοδήποτε email.
Συγκατάθεση από συνδεδεμένο πελάτη (παραγγελία από συνδεδεμένο πελάτη, όχι επισκέπτη), με ημερομηνία μεταγενέστερη από την τελευταία διαγραφή της επαφής	Επανεγγράφει επίσης μια επαφή που διαγράφηκε μέσω συνδέσμου διαγραφής ή του κουμπιού διαγραφής με ένα κλικ, της σελίδας προτιμήσεων, του API, ενός μέλους της ομάδας ή της διαγραφής από αυτό το ίδιο κατάστημα.
Συγκατάθεση στο checkout ή στην εγγραφή πελάτη, με ενεργή τη ρύθμιση Οι επιλογές συγκατάθεσης στο ταμείο επανεγγράφουν όσους απεγγράφηκαν (ανενεργή από προεπιλογή)	Επανεγγράφει μια επαφή που διαγράφηκε - και μετά από checkout επισκέπτη - όταν η ώρα της συγκατάθεσης στο κατάστημα είναι μετά την τελευταία της διαγραφή. Ο κίνδυνος: σε checkout επισκέπτη το Magento δεν μπορεί να πει στο Joryio ποιος είναι ο αγοραστής, οπότε κάποιος που πληκτρολογεί το email άλλου ατόμου στο checkout θα μπορούσε να το επανεγγράψει· μπορεί πάντα να διαγραφεί ξανά με ένα κλικ. Οι περιπτώσεις παρακάτω που δεν αναιρούνται ποτέ ισχύουν και τότε.
Κενό πλαίσιο	Καμία αλλαγή - δεν είναι ποτέ διαγραφή. Εκτός αν ενεργοποιήσετε στο κατάστημα το Ένα κενό πλαίσιο καταργεί την εγγραφή (απενεργοποιημένο από προεπιλογή).
Διαγραφή στο κατάστημα	Διαγράφει, εκτός αν το Joryio κατέγραψε μεταγενέστερη αλλαγή για αυτή την επαφή.
Δεν αναιρείται ποτέ από συγκατάθεση καταστήματος, με τη ρύθμιση ενεργή ή ανενεργή	Καταγγελία spam, hard bounce, αποκλεισμός σε επίπεδο οργανισμού, άλλος χώρος εργασίας, διαγραφή που καταγράφηκε σε άλλη επαφή με το ίδιο email ή τηλέφωνο, και STOP στο SMS.

• Η ρύθμιση βρίσκεται στο Ενσωματώσεις → Magento → Ρυθμίσεις, μία ανά σύνδεση καταστήματος, ανενεργή από προεπιλογή. Μόνο οι διαχειριστές μπορούν να την αλλάξουν και κάθε αλλαγή καταγράφεται στο αρχείο ελέγχου.
• Η επανεγγραφή αφορά μόνο αυτή την επαφή· οι άλλες επαφές με το ίδιο email ή τηλέφωνο παραμένουν διαγραμμένες. Το ιστορικό της επαφής λέει γιατί, για παράδειγμα επανεγγράφηκε από το checkout του καταστήματος (συνδεδεμένος πελάτης) μετά από διαγραφή μέσω της σελίδας προτιμήσεων.
• SMS: με ενεργή τη διπλή επιβεβαίωση (double opt-in) για SMS, μια επανεγγραφή στέλνει ένα μήνυμα "Απαντήστε YES" και η επαφή μένει σε αναμονή μέχρι να απαντήσει. Μια επαφή που έστειλε STOP επιστρέφει μόνο με αυτόν τον τρόπο - με απενεργοποιημένη τη διπλή επιβεβαίωση για SMS, μια συγκατάθεση καταστήματος δεν την επανεγγράφει ποτέ.
• Η συγκατάθεση καταστήματος εγγράφει στο κανάλι, όχι σε λίστα: μια λίστα που απαιτεί διπλή επιβεβαίωση εξακολουθεί να στέλνει το email επιβεβαίωσης όταν το άτομο μπαίνει σε αυτή.

Ένα κενό πλαίσιο καταργεί την εγγραφή (προαιρετικό)

Για καταστήματα με αυστηρή πολιτική συγκατάθεσης, η επέκταση 1.4.26 ή νεότερη έκδοση έχει μια προαιρετική ρύθμιση στη διαδρομή Stores → Configuration → Joryio → Marketing Consent: An unticked opt-in box at checkout or registration unsubscribes the person. Είναι απενεργοποιημένη από προεπιλογή.

Ρύθμιση	Τι κάνει ένα κενό πλαίσιο
Απενεργοποιημένη (προεπιλογή)	Τίποτα. Ένα κενό πλαίσιο δεν αλλάζει ποτέ την κατάσταση κανενός.
Ενεργοποιημένη	Ένα πλαίσιο που εμφανίστηκε και υποβλήθηκε κενό - με μια παραγγελία που ολοκληρώθηκε ή στη φόρμα εγγραφής - καταγράφει διαγραφή για το κανάλι αυτού του πλαισίου (email ή SMS). Μόνο για συνδεδεμένους πελάτες, που το κατάστημα έχει επαληθεύσει.
Ενεργοποιημένη, με Also for guest checkouts	Το ίδιο και για checkout επισκεπτών και νέες εγγραφές λογαριασμού. Στο checkout επισκέπτη ο καθένας μπορεί να πληκτρολογήσει το email κάποιου άλλου - ένας επισκέπτης θα μπορούσε να διαγράψει άλλο άτομο. Μια νέα εγγραφή λογαριασμού μετρά ως επισκέπτης: το κατάστημα δεν επαληθεύει τη διεύθυνση email.

• Η διαγραφή καταγράφεται όπως κάθε άλλη: στο ιστορικό συνδρομών της επαφής (πηγή magento_checkout, αιτία checkout_box_unticked, με το κείμενο που εμφανίστηκε δίπλα στο πλαίσιο) και ως συμβάν message.unsubscribed.
• Και όποιος δεν έδωσε ποτέ συγκατάθεση: με τη ρύθμιση ενεργή, ένα μη τσεκαρισμένο κουτί καταργεί την εγγραφή του ατόμου ακόμη κι αν δεν έδωσε ποτέ συγκατάθεση (το Not Set γίνεται Unsubscribed). Όπως κάθε κατάργηση εγγραφής, ισχύει για κάθε επαφή με το ίδιο email ή τηλέφωνο στον χώρο εργασίας, και για να αναιρεθεί χρειάζεται νέα συγκατάθεση.
• Ποτέ για πλαίσιο που δεν εμφανίστηκε (το πλαίσιο SMS μόνο όπου εμφανίζεται), ποτέ από συγχρονισμό παλαιότερων παραγγελιών και ποτέ για πλαίσιο που αποεπιλέχθηκε πριν ολοκληρωθεί η παραγγελία - η αποεπιλογή κατά το checkout αποσύρει μόνο την επιλογή του ίδιου checkout. Δεν εγγράφει ούτε επανεγγράφει ποτέ κανέναν και δεν αλλάζει ποτέ αποκλεισμό λόγω bounce ή καταγγελίας.
• Η σελίδα Integrations → Magento → Settings δείχνει τη ρύθμιση μόνο για ανάγνωση. Παλαιότερες εκδόσεις δεν την αναφέρουν και το Joryio τη θεωρεί απενεργοποιημένη.

Παράδοση και επαναλήψεις

Από την επέκταση v1.4.0, ένα συμβάν δεν χάνεται όταν το Joryio δεν είναι διαθέσιμο για λεπτά ή ώρες. Κάθε συμβάν (παραγγελία, προϊόν, πελάτης, καλάθι, αλλαγή στο newsletter) περιμένει στην ουρά του καταστήματος μέχρι να το δεχτεί το Joryio:

• Το Joryio δεν είναι διαθέσιμο ή είναι φορτωμένο - η ουρά σταματά και ξαναδοκιμάζει μετά από αυξανόμενες παύσεις: 1, 2, 4, 8, 16 και 32 λεπτά, έπειτα κάθε ώρα, για έως 7 ημέρες. Όταν το Joryio επανέλθει, τα συμβάντα σε αναμονή φτάνουν, με τη σειρά που έγιναν για κάθε παραγγελία, καλάθι και πελάτη.
• Ένα συμβάν που απορρίπτει το Joryio (για παράδειγμα, μη έγκυρα δεδομένα) μπαίνει αμέσως στην άκρη, ώστε να μην καθυστερεί τα υπόλοιπα.
• Το Joryio απορρίπτει το κλειδί API (το κατάστημα αποσυνδέθηκε στο Joryio ή δημιουργήθηκε νέο κλειδί) - η παράδοση σταματά και η διαχείριση του Magento εμφανίζει ειδοποίηση. Τα συμβάντα διατηρούνται: επικολλήστε το τρέχον κλειδί, πατήστε Connect και η παράδοση συνεχίζεται.
• Τα συμβάντα που δεν παραδόθηκαν διατηρούνται 30 ημέρες.

Το Stores → Configuration → Joryio → Event Queue δείχνει πόσα συμβάντα περιμένουν, επαναλαμβάνονται και δεν παραδόθηκαν, το τελευταίο σφάλμα και την τελευταία επιτυχημένη παράδοση. Το Retry now ξαναστέλνει κάθε συμβάν σε αναμονή ή που δεν παραδόθηκε. Από την έκδοση 1.4.4, η αποθήκευση νέου Server URL ή API key, ένα επιτυχημένο Connect ή ένα επιτυχημένο Test Connection τερματίζουν αμέσως την παύση: τα συμβάντα σε αναμονή φεύγουν στην επόμενη εκτέλεση (μέσα σε ένα λεπτό) και το παλιό σφάλμα διαγράφεται.

Αποσύνδεση και απεγκατάσταση

• Η αποσύνδεση στο admin του Magento τερματίζει τη σύνδεση: το Joryio σταματά τον συγχρονισμό, το διακριτικό πρόσβασης της ενσωμάτωσης "Joryio" του Magento ανακαλείται και τα συμβάντα σε αναμονή φυλάγονται (μετά την επανασύνδεση, το Retry now τα στέλνει). Το κλειδί API παραμένει έγκυρο - κάντε ξανά κλικ στο Connect με το ίδιο κλειδί (επέκταση v1.4.3 ή νεότερη· οι παλαιότερες το ανακαλούσαν).
• Η αποσύνδεση στο Joryio (Ρυθμίσεις → Ενσωματώσεις → Magento) ανακαλεί αμέσως το κλειδί API: την επόμενη φορά που η επέκταση στείλει συμβάν σταματά και δείχνει ειδοποίηση. Μια σύνδεση με αυτό το κλειδί λέει τότε «This key was revoked when the store was disconnected in Joryio» και η σελίδα Magento στο Joryio εξηγεί γιατί δεν υπάρχει κλειδί. Δημιουργήστε νέο κλειδί για να συνδεθείτε ξανά. Για να ανακαλέσετε και το διακριτικό πρόσβασης του Magento, κάντε κλικ στο Disconnect στο admin του Magento.
• Ένα κατάστημα, ένας χώρος εργασίας. Ένα κατάστημα συνδεδεμένο σε έναν χώρο εργασίας του Joryio δεν μπορεί να συνδεθεί σε άλλον: η σύνδεση εμφανίζει «This store is already connected to another Joryio workspace.» Αποσυνδέστε το πρώτα στον άλλον χώρο εργασίας.
• Απεγκατάσταση με bin/magento module:uninstall Joryio_Connect (εγκατάσταση με composer) ή bin/magento module:uninstall --non-composer Joryio_Connect (εγκατάσταση στο app/code). Αποσυνδέει το κατάστημα, ανακαλεί το κλειδί API (v1.4.3 ή νεότερη), διαγράφει την ενσωμάτωση "Joryio" και αφαιρεί τους πίνακες και τις ρυθμίσεις της επέκτασης. Η διαγραφή των αρχείων χωρίς module:uninstall δεν κάνει τίποτα από αυτά - κάντε πρώτα κλικ στο Disconnect.

Ανάκτηση εγκαταλελειμμένων καλαθιών

1. Η επέκταση παρακολουθεί τα καλάθια καθώς οι πελάτες ψωνίζουν
2. Μετά από 60 λεπτά αδράνειας (ρυθμιζόμενο), το καλάθι επισημαίνεται ως εγκαταλελειμμένο
3. Το Joryio λαμβάνει το καλάθι με ένα URL ανάκτησης
4. Χρησιμοποιήστε ένα journey για να στείλετε μηνύματα ανάκτησης με τον σύνδεσμο επαναφοράς

Τι κάνει ο σύνδεσμος ανάκτησης (https://your-store.com/joryio/cart/restore?token=...) εξαρτάται από το ποιος τον ανοίγει (επέκταση v1.4.8 ή νεότερη). Το Magento κρατά ένα καλάθι λογαριασμού πελάτη μόνο όσο ο πελάτης αυτός είναι συνδεδεμένος, οπότε:

• Ο ίδιος ο πελάτης, συνδεδεμένος - το αποθηκευμένο καλάθι του επανέρχεται.
• Κανείς συνδεδεμένος (η συνήθης περίπτωση: ο σύνδεσμος ανοίγει από email σε άλλη συσκευή) - τα προϊόντα, με τις επιλογές, τις ποσότητες και τον κωδικό έκπτωσης αν ισχύει ακόμη, αντιγράφονται σε καλάθι σε αυτόν τον browser με τη σημείωση "Sign in to use your saved details at checkout." Αν συνδεθεί μετά, μένει ένα καλάθι· οι ποσότητες δεν διπλασιάζονται ποτέ.
• Καλάθι επισκέπτη - τα προϊόντα αντιγράφονται επίσης. Το όνομα, το email και οι διευθύνσεις του επισκέπτη όχι, οπότε ένας προωθημένος σύνδεσμος δεν δείχνει στοιχεία κανενός.
• Συνδεδεμένος άλλος πελάτης - απορρίπτεται με "This cart belongs to a different account. Sign out to open it as a guest." Τίποτα δεν προστίθεται στο καλάθι του και κανείς δεν κατονομάζεται.
• Συνδεδεμένος πελάτης ανοίγει καλάθι επισκέπτη, ή το καλάθι αυτού του browser έχει ήδη προϊόντα - μια σελίδα ρωτά "Add these products from your saved cart to your current cart?"· τίποτα δεν προστίθεται πριν πατηθεί Add to my cart.
• Το καλάθι έχει ήδη γίνει παραγγελία - "You already completed this order."
• Άνοιγμα ξανά - ο ίδιος browser πηγαίνει στο καλάθι που ήδη έχει· άλλος browser ή άλλη συσκευή παίρνει νέο καλάθι με τα αποθηκευμένα προϊόντα (παρακάτω). Καλάθι πελάτη που έχει ήδη περάσει σε αυτόν με τη σύνδεση δείχνει "This link was already used - sign in to see your cart."

Ένας σύνδεσμος δεν αλλάζει ποτέ το υπάρχον καλάθι κάποιου άλλου: φορτωμένος από άλλον ιστότοπο ως εικόνα ή πλαίσιο δεν κάνει τίποτα, και η προσθήκη σε υπάρχον καλάθι θέλει πάντα επιβεβαίωση. Αν η επιβεβαίωση σταλεί αφού έληξε η συνεδρία της σελίδας, ο αγοραστής βλέπει "Your session has expired. Please open the cart link again." και τίποτα δεν αλλάζει.

Ένας σύνδεσμος ανοίγει μόνο στο store view όπου αποθηκεύτηκε το καλάθι (επέκταση v1.4.10 ή νεότερη): σε άλλο store view του ίδιου καταστήματος δείχνει "This cart was saved in another of our stores. Please open the link from your email again." και δεν αλλάζει τίποτα. Οι σύνδεσμοι που στάλθηκαν από v1.4.9 και παλαιότερες λειτουργούν, με τον ίδιο έλεγχο, έως τις 31 Ιανουαρίου 2027.

Το "Your cart has been restored." εμφανίζεται μόνο όταν η σελίδα του καλαθιού δείχνει τα προϊόντα. Όσα προϊόντα δεν αγοράζονται πια παραλείπονται και κατονομάζονται. Η παραγγελία από αντιγραμμένο καλάθι μετράει στο Joryio ως ανάκτηση εκείνου του καλαθιού, ακόμη κι αν ο αγοραστής ολοκληρώσει ως επισκέπτης με άλλο email.

Η επέκταση v1.4.7 και παλαιότερες έδειχνε "Your cart has been restored." πάνω από άδειο καλάθι όταν ο πελάτης δεν ήταν συνδεδεμένος - αναβαθμίστε σε v1.4.8.

Άνοιγμα του συνδέσμου: σελίδα επαναφοράς, ένα καλάθι ανά σύνδεσμο

Από την επέκταση 1.4.18, το άνοιγμα του συνδέσμου από μόνο του δεν αλλάζει τίποτα. Οι προεπισκοπήσεις συνδέσμων στις εφαρμογές συνομιλίας και οι σαρωτές ασφαλείας email (Outlook Safe Links, Gmail και άλλοι) ανοίγουν τους συνδέσμους πριν από τον αγοραστή, και κάθε τέτοιο άνοιγμα αντέγραφε παλιότερα το καλάθι άλλη μία φορά - ένας σύνδεσμος μπορούσε να αφήσει πολλά αντίγραφα.

• Το άνοιγμα του συνδέσμου δείχνει μια σύντομη σελίδα, "Restoring your saved cart...", που δεν αποθηκεύεται ποτέ σε cache και δεν ευρετηριάζεται. Το script της επαναφέρει το καλάθι και συνεχίζει στη σελίδα του καλαθιού· χωρίς script ο αγοραστής πατά Restore my cart. Μια προεπισκόπηση ή ένας σαρωτής που δεν εκτελεί script δεν επαναφέρει τίποτα. Η σελίδα επιβεβαίωσης παραπάνω εξακολουθεί να περιμένει το κλικ του αγοραστή.
• Ένα καλάθι ανά σύνδεσμο, ανά browser - το καλάθι που επανέφερε ο σύνδεσμος απομνημονεύεται μαζί με τον browser στον οποίο επανήλθε (ένα cookie). Αν ο ίδιος σύνδεσμος ανοιχτεί ξανά σε αυτόν τον browser (για παράδειγμα μετά τη λήξη της συνεδρίας του), επιστρέφει το ίδιο καλάθι αντί για νέο αντίγραφο, για 7 ημέρες: Stores > Configuration > Joryio > Tracking > Recovery Link Reuses Its Cart For (days), 1-30. Άλλος browser ή άλλη συσκευή - ή σαρωτής που εκτέλεσε τη σελίδα - δεν παίρνει ποτέ αυτό το καλάθι: παίρνει νέο καλάθι μόνο με τα προϊόντα και τον εκπτωτικό κωδικό του αποθηκευμένου καλαθιού, ώστε ό,τι πληκτρολόγησε κάποιος στο checkout σε έναν browser να μη φαίνεται ποτέ σε άλλον. Από εκεί και πέρα ο σύνδεσμος θυμάται το καλάθι του πιο πρόσφατου browser. Και τα δύο καλάθια μετρούν ως το ίδιο αποθηκευμένο καλάθι: μια παραγγελία από οποιοδήποτε είναι μία ανάκτηση, και στέλνεται μόνο μία υπενθύμιση "εγκαταλείφθηκε ξανά" ανά αρχικό καλάθι.
• Έχει ήδη παραγγελθεί - όταν το καλάθι που επανέφερε ο σύνδεσμος έγινε παραγγελία, ο σύνδεσμος λέει "You already completed this order." και δεν επαναφέρει τίποτα.
• Το πολύ 10 επαναφορές ανά σύνδεσμο την ώρα - μετά από αυτό, "Too many attempts with this cart link. Please try again later."

Τα αντίγραφα που έφτιαξαν ήδη παλαιότερες εκδόσεις εξακολουθούν να παίρνουν το πολύ μία υπενθύμιση ανά αρχικό καλάθι (Ανακτημένο καλάθι που εγκαταλείφθηκε ξανά). Το bin/magento setup:upgrade στην 1.4.18 αφαιρεί επίσης τις σημάνσεις που έμειναν σε ανακτημένα καλάθια που έχουν ήδη παραγγελθεί και συμπληρώνει το αρχικό τους καλάθι· τα σύνολα γράφονται στο var/log/joryio.log.

Απόδοση των παραγγελιών ανάκτησης

Από την επέκταση 1.4.12, ο σύνδεσμος ανάκτησης κρατά τις παραμέτρους απόδοσης που προσθέτει η παρακολούθηση κλικ του Joryio (jr_cid, jr_jid, utm_*) όταν στέλνει τον αγοραστή στο καλάθι, ώστε η παραγγελία να αποδίδεται στο μήνυμα που έστειλε τον σύνδεσμο. Μεταφέρονται μόνο αυτές οι παράμετροι, η καθεμία ελεγμένη για τη μορφή της - ποτέ το διακριτικό του συνδέσμου ή οτιδήποτε άλλο. Όταν ο αγοραστής ανοίγει τον σύνδεσμο και ολοκληρώνει με άλλο email, το Joryio αποδίδει την παραγγελία στο κλικ της επαφής στην οποία στάλθηκε το μήνυμα. Δείτε Καλάθια.

Ανακτημένο καλάθι που εγκαταλείφθηκε ξανά

Από την επέκταση 1.4.13, η ανάκτηση ενός καλαθιού δεν σημειώνει τίποτα ως εγκαταλελειμμένο. Ένα ανακτημένο αντίγραφο που ο αγοραστής εγκαταλείπει ξανά αναφέρεται άλλη μία φορά μετά τον κανονικό χρόνο εγκατάλειψης, με reabandonedAfterRecovery: true και originalSessionId στο συμβάν Cart Abandoned· κάθε επόμενο αδρανές αντίγραφο του ίδιου αρχικού καλαθιού μέσα σε 30 ημέρες δεν αναφέρεται. Ένα καλάθι που είχε ήδη προϊόντα και δέχτηκε τα αποθηκευμένα είναι κανονικό καλάθι. Μια παραγγελία από οποιοδήποτε αντίγραφο μετράει ως μία ανάκτηση του αρχικού. Δείτε Καλάθια.

Το ανακτημένο αντίγραφο ενός επισκέπτη δεν έχει email (ο σύνδεσμος δεν το αντιγράφει ποτέ)· από την 1.4.18 αναφέρεται κανονικά, χωρίς email, και το Joryio στέλνει τη μία υπενθύμιση στην επαφή του αρχικού καλαθιού - δείτε Καλάθια.

Από την έκδοση 1.4.22, κάθε συμβάν καλαθιού ενός αντιγράφου ανάκτησης αναφέρει από ποιο καλάθι ανακτήθηκε (restoredFromSessionId), οπότε το αντίγραφο ενός επισκέπτη εμφανίζεται στο E-Commerce → Καλάθια ως Αντίγραφο ανάκτησης του καλαθιού της αρχικής επαφής και όχι ως καλάθι Χωρίς επαφή, και δεν μετράει ως ακόμη ένα εγκαταλελειμμένο καλάθι - δείτε Καλάθια.

Από την επέκταση 1.4.23, κάθε συμβάν καλαθιού φέρει τον σύνδεσμο ανάκτησης του καλαθιού και αν είναι καλάθι επισκέπτη, και η επέκταση αναφέρει το Track Guest Carts και τον χρόνο εγκατάλειψης με κάθε αίτημα, οπότε ένα καλάθι που το Joryio σημειώνει μόνο του ως εγκαταλελειμμένο τα ακολουθεί - δείτε Καλάθια. Το email που πληκτρολογεί ένας επισκέπτης στο βήμα email της ολοκλήρωσης αγοράς φτάνει στο καλάθι μόνο όταν ο αγοραστής συνεχίσει στο βήμα αποστολής (τότε το αποθηκεύει το Magento)· πριν από αυτό αναγνωρίζει μόνο το πρόγραμμα περιήγησης και το καλάθι δεν αναφέρεται.

Οι εκδόσεις 1.4.8 έως 1.4.12 σημείωναν ένα ανακτημένο καλάθι ως ήδη αναφερμένο τη στιγμή της ανάκτησης, οπότε ένας αγοραστής που το εγκατέλειπε ξανά δεν λάμβανε υπενθύμιση. Το bin/magento setup:upgrade στην 1.4.13 αφαιρεί αυτές τις σημάνσεις (μόνο όσες μπήκαν τη στιγμή της ανάκτησης, χωρίς συμβάν εγκατάλειψης πίσω τους) και γράφει τα σύνολα στο var/log/joryio.log.

Αντιμετώπιση προβλημάτων

Συμβάντα κολλημένα / τίποτα δεν φτάνει στο Joryio

Αυτό οφείλεται σχεδόν πάντα στο ότι δεν τρέχει το cron του Magento. Η επέκταση βάζει τα συμβάντα σε τοπική ουρά και ένα cron ανά λεπτό τα παραδίδει - χωρίς cron, δεν αποστέλλεται τίποτα.

• Βεβαιωθείτε ότι το cron έχει ρυθμιστεί: bin/magento cron:install (ή ελέγξτε το crontab σας)
• Εκτελέστε το χειροκίνητα για δοκιμή: bin/magento cron:run
• Ελέγξτε το var/log/joryio.log στον ριζικό κατάλογο του Magento για σφάλματα παράδοσης
• Ελέγξτε το Stores → Configuration → Joryio → Event Queue (επέκταση v1.4.0 ή νεότερη): δείχνει τα συμβάντα σε αναμονή και όσα δεν παραδόθηκαν, με το τελευταίο σφάλμα. Δείτε Παράδοση και επαναλήψεις

Η σύνδεση αποτυγχάνει

Από την έκδοση 1.4.2 της επέκτασης, το Connect ελέγχει πρώτα το νέο διακριτικό πρόσβασης στο κατάστημά σας, όπως θα το ελέγξει το REST API του Magento: τη ρύθμιση Bearer του OAuth για την προβολή καταστήματος που καλεί το Joryio, τον έλεγχο του ίδιου του Magento για το διακριτικό, τα δικαιώματα της ενσωμάτωσης "Joryio" και ένα αίτημα από τον διακομιστή σας προς το δικό του URL καταστήματος. Όταν κάποιο αποτύχει, το Connect σταματά πριν εμπλακεί το Joryio και ονομάζει την αιτία· δεν μένει τίποτα πίσω. Το αποτέλεσμα γράφεται επίσης στο var/log/joryio.log (η γραμμή που αρχίζει με Joryio connect self-test). Δίπλα στα κουμπιά, η σελίδα ρυθμίσεων δείχνει αν η ρύθμιση Bearer είναι ήδη ενεργή.

Το μήνυμα λέει	Τι να κάνετε
Το "Allow OAuth Access Tokens to be used as standalone Bearer tokens" είναι No για την προβολή καταστήματος που καλεί το Joryio	Ορίστε το σε Yes - ελέγξτε και τα επίπεδα ιστότοπου και προβολής καταστήματος, μια τιμή εκεί υπερισχύει του Default Config. Δείτε Αποδοχή διακριτικών πρόσβασης OAuth ως διακριτικών Bearer
Στην ενσωμάτωση "Joryio" λείπουν αυτά τα δικαιώματα	Εκτελέστε bin/magento setup:upgrade και bin/magento cache:flush και κάντε ξανά κλικ στο Connect. Ελέγξτε στο System → Extensions → Integrations → Joryio → API ότι οι πόροι της λίστας είναι επιλεγμένοι
Το URL του καταστήματός σας απαντάται από άλλη εγκατάσταση Magento	Το βασικό URL στο Stores → Configuration → General → Web δείχνει σε άλλο αντίγραφο του καταστήματος (π.χ. staging). Διορθώστε το και συνδεθείτε
Ο διακομιστής web αφαιρεί την κεφαλίδα Authorization	Δείτε «Η κεφαλίδα Authorization αφαιρείται» παρακάτω
Ένα αίτημα με το νέο διακριτικό στο rest/V1/store/storeConfigs απορρίφθηκε	Ένα module ασφαλείας, firewall ή κανόνας του διακομιστή web μπροστά από το REST API του Magento το απορρίπτει. Επιτρέψτε αιτήματα στο /rest/ με κεφαλίδα Authorization
Το κατάστημα δέχεται το διακριτικό από τον δικό του διακομιστή, αλλά το απέρριψε όταν κάλεσε το Joryio	Κάτι μπροστά από το κατάστημα χειρίζεται διαφορετικά τα αιτήματα από έξω (firewall, CDN, WAF, προστασία από bots). Αφήστε να περνούν τα αιτήματα στο /rest/ με κεφαλίδα Authorization
Ενημερώστε την επέκταση Joryio Connect στην 1.4.2 ή νεότερη	Η επέκτασή σας είναι παλαιότερη. Αναβαθμίστε (παρακάτω) και κάντε ξανά κλικ στο Connect
Το Joryio δεν μπόρεσε να φτάσει στο κατάστημά σας	Το URL του καταστήματος πρέπει να είναι δημόσιο και ενεργό, με έγκυρο πιστοποιητικό HTTPS. Οι ιδιωτικές και εσωτερικές διευθύνσεις απορρίπτονται
This store is already connected to another Joryio workspace	Αποσυνδέστε το πρώτα σε εκείνον τον χώρο εργασίας - δείτε Αποσύνδεση και απεγκατάσταση
Μη έγκυρο κλειδί API	Αντιγράψτε ξανά το κλειδί API και το URL διακομιστή από τις Ρυθμίσεις → Ενσωματώσεις → Magento στο Joryio. Ένα κλειδί το γνωρίζει μόνο ο διακομιστής της περιοχής του

Η κεφαλίδα Authorization αφαιρείται. Το Connect το αναφέρει μόνο όταν το δικό του αίτημα προς το κατάστημα έφτασε χωρίς την κεφαλίδα. Συνήθως την αφαιρεί ο Apache που εκτελεί PHP ως CGI ή FastCGI. Το .htaccess του ίδιου του Magento τη μεταβιβάζει· αν το δικό σας αντικαταστάθηκε ή ο πάροχος φιλοξενίας το αγνοεί, προσθέστε τα παρακάτω στο .htaccess του ριζικού φακέλου του Magento (και στο pub/ όταν αυτός είναι ο ριζικός φάκελος του ιστότοπου):

RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Αναβάθμιση στην 1.4.2: αντικαταστήστε τα αρχεία της επέκτασης με το zip της v1.4.2 από τον πίνακα ελέγχου του Joryio και εκτελέστε bin/magento setup:upgrade, bin/magento setup:di:compile (σε λειτουργία production) και bin/magento cache:flush. Οι εκδόσεις 1.4.0 και 1.4.1 έχαναν τα δικαιώματα της ενσωμάτωσης "Joryio" κάθε φορά που την ενεργοποιούσαν ή την απενεργοποιούσαν· το setup:upgrade τα επαναφέρει και το Connect χρησιμοποιεί την υπάρχουσα ενσωμάτωση, εκδίδει νέο διακριτικό και την ενεργοποιεί - δεν χρειάζεται να τη διαγράψετε. Στο Stores → Configuration → Joryio ελέγξτε το Server URL, κάντε κλικ στο Save Config και μετά στο Connect.

Αναβάθμιση στην 1.4.4

Αντικαταστήστε τα αρχεία της επέκτασης με το zip της v1.4.4 από τον πίνακα ελέγχου του Joryio και εκτελέστε bin/magento setup:upgrade, bin/magento setup:di:compile (σε λειτουργία production) και bin/magento cache:flush. Το setup:upgrade επιτρέπει στην ενσωμάτωση "Joryio" να διαβάζει κατηγορίες και απόθεμα (μαζί με τις πηγές MSI, όταν το κατάστημα τις χρησιμοποιεί) - δεν χρειάζεται νέα σύνδεση. Έπειτα, στο Joryio, ανοίξτε Ρυθμίσεις → Ενσωματώσεις → Magento και κάντε κλικ στο Συγχρονισμός όλων: ο συγχρονισμός ενώνει τα θυγατρικά προϊόντα με τα διαμορφώσιμα προϊόντα τους και συμπληρώνει απόθεμα, κατηγορίες και ποσά κουπονιών σε ό,τι έχει ήδη συγχρονιστεί.

«Invalid API key» / αναντιστοιχία κλειδιού

• Το κλειδί πρέπει να αρχίζει με jry_mg_ και να ταιριάζει με αυτό που εμφανίζεται τώρα στις Ρυθμίσεις → Ενσωματώσεις → Magento στο Joryio
• Το άνοιγμα της σελίδας ρύθμισης ξανά στο Joryio δεν αλλάζει το κλειδί - μόνο μια αποσύνδεση το ανακαλεί. Αν το κλειδί στο Magento διαφέρει από αυτό που εμφανίζεται στο Joryio, επικολλήστε αυτό του Joryio και κάντε ξανά κλικ στο Connect
• Ελέγξτε ότι το URL διακομιστή αντιγράφηκε επακριβώς
• Μια αποσύνδεση στο admin του Magento κρατά το κλειδί (v1.4.3 ή νεότερη): κάντε ξανά κλικ στο Connect με αυτό. Μια αποσύνδεση στο Joryio ή η απεγκατάσταση της επέκτασης το ανακαλεί - και η σύνδεση το λέει· δημιουργήστε νέο κλειδί στις Ρυθμίσεις → Ενσωματώσεις → Magento και επικολλήστε το πριν πατήσετε ξανά Connect. Αν η σύνδεση εμφανίσει «This store is already connected to another Joryio workspace», αποσυνδέστε το πρώτα σε εκείνον τον χώρο εργασίας - δείτε Αποσύνδεση και απεγκατάσταση

Λείπουν ιστορικά δεδομένα

• Παραγγελίες παλαιότερες από το παράθυρο συγχρονισμού (90 ημέρες από προεπιλογή) δεν εισάγονται
• Ο ιστορικός συγχρονισμός εκτελείται με σειρά: προϊόντα, έπειτα πελάτες, έπειτα παραγγελίες - δώστε σε ένα μεγάλο κατάστημα λίγο χρόνο να ολοκληρώσει

Η παρακολούθηση δεν λειτουργεί

• Ελέγξτε ότι ο διακόπτης του αποσπάσματος παρακολούθησης είναι ενεργός στο Stores → Configuration → Joryio
• Η επέκταση 1.4.6 ή νεότερη καθαρίζει μόνη της τις αποθηκευμένες σελίδες όταν αποθηκεύετε τον διακόπτη· με παλαιότερη έκδοση εκτελέστε bin/magento cache:flush (δείτε Μετά την αλλαγή ρυθμίσεων)
• Επαληθεύστε ότι το απόσπασμα φορτώνεται στα εργαλεία προγραμματιστή του προγράμματος περιήγησής σας

Λείπει η προσθήκη στο καλάθι, full-page cache και Varnish

• Η full-page cache και το Varnish δεν δημιουργούν πρόβλημα: το απόσπασμα μεταφέρει μόνο δεδομένα της σελίδας και η προσθήκη στο καλάθι φτάνει στον browser μέσω των δεδομένων πελάτη του ίδιου του Magento (customer/section/load), που δεν μπαίνουν ποτέ σε cache. Μην προσθέτετε κανόνα που βάζει αυτή τη διεύθυνση σε cache
• Υποστηρίζονται θέματα βασισμένα στο Luma και το Hyva. Ένα headless ή PWA κατάστημα δεν φορτώνει το απόσπασμα - στείλτε συμβάντα με το Web SDK
• Μετά την αναβάθμιση της επέκτασης εκτελέστε bin/magento setup:upgrade και bin/magento cache:flush, ώστε να καταχωριστεί το νέο section δεδομένων πελάτη

Το ταμείο κολλάει στο εικονίδιο φόρτωσης, "Mismatched anonymous define()"

• Με την επέκταση 1.4.6, το ταμείο ενός καταστήματος βασισμένου στο Luma μπορούσε να μένει στο εικονίδιο φόρτωσης μέχρι να ξαναφορτωθεί η σελίδα. Η κονσόλα του browser έδειχνε Mismatched anonymous define() module (από το αρχείο του Joryio web SDK) και templateEngine must inherit from ko.templateEngine. Το snippet φόρτωνε το web SDK με ένα απλό script tag, και σε σελίδα που χρησιμοποιεί RequireJS το αρχείο του SDK καταχωριζόταν με τρόπο που το RequireJS απέδιδε σε ένα από τα modules του ταμείου του ίδιου του Magento
• Η επέκταση 1.4.7 φορτώνει το web SDK μέσω του RequireJS όταν η σελίδα το έχει (Luma και θέματα βασισμένα σε αυτό), και με απλό script tag μόνο όπου δεν το έχει (Hyva). Αναβαθμίστε, εκτελέστε bin/magento setup:upgrade, bin/magento setup:static-content:deploy σε production mode και bin/magento cache:flush
• Έλεγχος: ανοίξτε το ταμείο με ανοιχτή την κονσόλα - δεν εμφανίζεται κανένα από τα δύο μηνύματα, και το window.joryio.sdk υπάρχει μόλις φορτωθεί η σελίδα (όταν είναι ενεργά τα μηνύματα in-app ή το web push)

Τα καλάθια επισκεπτών δεν σημειώνονται ως εγκαταλελειμμένα

• Το Magento κρατά το email ενός επισκέπτη στη διεύθυνση χρέωσης (ή αποστολής) του καλαθιού όσο βρίσκεται στο ταμείο, και το αντιγράφει στο ίδιο το καλάθι μόνο όταν γίνει η παραγγελία. Η επέκταση 1.4.6 και παλαιότερες έλεγχαν μόνο το καλάθι, οπότε ένας επισκέπτης που έγραψε email στο ταμείο και έφυγε δεν σημειωνόταν ποτέ ως εγκαταλελειμμένος. Από την 1.4.7 μετράει και το email της διεύθυνσης χρέωσης ή αποστολής (κρατήστε ενεργό το Track Guest Carts)
• Τα καλάθια επισκεπτών μετρούν από τη στιγμή που εγκαθίσταται η επέκταση 1.4.9 (την καταγράφει το bin/magento setup:upgrade)· καλάθια επισκεπτών που έμειναν αδρανή πριν από αυτό δεν στέλνονται όλα μαζί. Με τις 1.4.7 και 1.4.8 κανένα καλάθι επισκέπτη δεν αναφέρθηκε μέσω του email της διεύθυνσης (η ώρα έναρξης δεν αποθηκευόταν) - αναβαθμίστε στην 1.4.9. Για δοκιμή, ξεκινήστε νέο ταμείο ως επισκέπτης, γράψτε email, φύγετε και περιμένετε τον χρόνο εγκατάλειψης συν έως 15 λεπτά (το διάστημα του cron)
• Ένα καλάθι σημειώνεται ως εγκαταλελειμμένο μία φορά. Ένας αγοραστής που δεν έγραψε ποτέ email (και δεν είναι συνδεδεμένος) δεν είναι προσβάσιμος και δεν στέλνεται
• Από την 1.4.11 το var/log/joryio.log το δείχνει: Joryio: guest-cart start time set to <date> UTC (...) (ή already set (<date> UTC), kept.) στο setup:upgrade, και Joryio: cart abandon queued: quote <id>, store <id>. για κάθε σύνδεσμο ανάκτησης που δημιουργείται (μόνο αναγνωριστικά - χωρίς email, σύνδεσμο ή token)

Προσθήκη στο καλάθι ή παρακολούθηση που μπλοκάρεται από προστασία bot

Ορισμένα εργαλεία ασφαλείας της φιλοξενίας - για παράδειγμα η προστασία bot του Imunify360 - μπορεί να μπλοκάρουν τα αιτήματα του ίδιου του καταστήματος (προσθήκη στο καλάθι, κλήσεις παρακολούθησης) με "Access denied by Imunify360 bot-protection". Τότε το Joryio δεν λαμβάνει συμβάντα προσθήκης στο καλάθι ή προβολής σελίδων και οι αγοραστές μπορεί να δουν να αποτυγχάνει η προσθήκη στο καλάθι. Στον πίνακα ελέγχου της φιλοξενίας, επιτρέψτε τις διαδρομές AJAX του καταστήματος και τις διαδρομές του Joryio (/joryio/..., /customer/section/load, /checkout/cart/add), ή μειώστε την ευαισθησία της προστασίας bot για τον τομέα του καταστήματος. Ο πάροχος φιλοξενίας μπορεί να σας πει ποιος κανόνας ενεργοποιήθηκε.