Ενσωμάτωση 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 διακομιστή
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.

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

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

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

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

Η επέκταση προσθέτει ένα ελαφρύ απόσπασμα παρακολούθησης στο κατάστημά σας (ενεργό από προεπιλογή - μπορείτε να το απενεργοποιήσετε στο Stores → Configuration → Joryio). Παρακολουθεί:

Συμβάν	Περιγραφή
Page View	Κάθε επίσκεψη σελίδας
Product Viewed	Όταν προβάλλεται μια σελίδα προϊόντος
Add to Cart	Είδη που προστίθενται στο καλάθι
Checkout Started	Όταν ξεκινά η ολοκλήρωση αγοράς
Identify	Καταγραφή email

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

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

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

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

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

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

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

• Βεβαιωθείτε ότι το cron έχει ρυθμιστεί: bin/magento cron:install (ή ελέγξτε το crontab σας)
• Εκτελέστε το χειροκίνητα για δοκιμή: bin/magento cron:run
• Ελέγξτε το var/log/joryio.log στον ριζικό κατάλογο του Magento για σφάλματα παράδοσης

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

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

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

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

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

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