Κατανόηση του Συγχρονισμού Δεδομένων Shopify με το Brevo

Το Tajo μετακινεί δεδομένα του Shopify προς το Brevo με δύο τρόπους. Η εφαρμογή Shopify του Tajo επεξεργάζεται τα webhooks του Shopify καθώς φτάνουν. Οι κανόνες συγχρονισμού είναι εγκεκριμένοι από άνθρωπο, μονής κατεύθυνσης, εκτελούνται σε παρτίδες και καταγράφονται από άκρη σε άκρη. Αυτό το άρθρο εξηγεί και τα δύο, τι δεν περιλαμβάνουν και τα λίγα πράγματα που η εφαρμογή Shopify του Tajo γράφει πίσω στο Shopify.

Γρήγορος έλεγχος Αυτό το άρθρο προϋποθέτει ότι έχετε συνδέσει το Shopify και το Brevo και έχετε δημοσιεύσει τουλάχιστον έναν κανόνα συγχρονισμού. Αν όχι, ξεκινήστε με το άρθρο σύνδεση του Tajo με το Shopify.

Καθώς συμβαίνουν τα γεγονότα: η εφαρμογή Shopify του Tajo

Η εφαρμογή Shopify του Tajo εγγράφεται στα webhooks του Shopify και επεξεργάζεται το καθένα μόλις φτάσει. Οι αλλαγές σε πελάτες και προϊόντα περιμένουν πρώτα περίπου τέσσερα δευτερόλεπτα. Πελάτες, παραγγελίες, checkouts, προϊόντα, συλλογές και επίπεδα αποθέματος φτάνουν στο Brevo με αυτόν τον τρόπο, μαζί με συμβάντα όπως τα order_paid και cart_abandoned. Ο οδηγός ενσωμάτωσης Shopify παραθέτει κάθε θέμα και τι γράφει στο Brevo.

Η μορφή ενός κανόνα συγχρονισμού

Ένας κανόνας συγχρονισμού είναι ένας ελεγμένος, εγκεκριμένος ορισμός του τι ακριβώς μετακινείται και πώς. Ένας πράκτορας τον δημιουργεί από την περιγραφή σας και ένας άνθρωπος τον εγκρίνει. Ένας κανόνας έχει τέσσερα μέρη που μπορείτε να εξετάσετε στη σελίδα του, στην ενότητα Connections > Syncs and mappings:

Ένας κανόνας συγχρονισμού μετακινεί δεδομένα προς μία κατεύθυνση: από την πηγή σας προς το Brevo. Δεν γράφει ποτέ στο Shopify. Η εφαρμογή Shopify του Tajo γράφει όμως λίγα πράγματα πίσω στο Shopify, όπως ανακλήσεις συγκατάθεσης και ετικέτες επιπέδου πιστότητας. Το Shopify permissions explained απαριθμεί κάθε εγγραφή και πότε γίνεται.

Πότε εκτελείται ένας κανόνας συγχρονισμού

Οι κανόνες συγχρονισμού εκτελούνται σε παρτίδες. Οι κανόνες συγχρονισμού επαφών εκτελούνται από προεπιλογή κάθε 15 λεπτά. Ένας ενεργός, δημοσιευμένος κανόνας Shopify orders → Brevo orders εκτελείται επίσης κάθε 15 λεπτά, αλλά μόνο με το φίλτρο opt-in μάρκετινγκ του αγοραστή που έχει το πρότυπο. Ένας κανόνας του οποίου το φίλτρο έχει τροποποιηθεί εκτελείται μόνο όταν τον ξεκινήσετε εσείς. Η πρώτη προγραμματισμένη εκτέλεση ενός κανόνα παραγγελιών ξεκινά λίγα λεπτά πριν από εκείνη τη στιγμή και δεν στέλνει παλαιότερες παραγγελίες. Κάθε επόμενη εκτέλεση στέλνει τις παραγγελίες που ενημερώθηκαν από την προηγούμενη. Οι παλαιότερες παραγγελίες φτάνουν στο Brevo μόνο όταν εκτελέσετε τον κανόνα εσείς. Η σελίδα ενός ενεργού κανόνα έχει το κουμπί Test run (1 batch), και ο πράκτορας Sync Operator εκτελεί τους ενεργούς κανόνες όταν του το ζητήσετε. Οι εκτελέσεις σε παρτίδες είναι αυτό που κάνει κάθε εγγραφή ελέγξιμη, εντός προϋπολογισμού και αποδοτέα σε μια συγκεκριμένη εκτέλεση.

Κάθε εκτέλεση διαβάζει τις νέες και τις αλλαγμένες εγγραφές από το σημείο του cursor και μετά, εφαρμόζει το φίλτρο, αντιστοιχίζει τα πεδία και εγγράφει στο Brevo. Η εγγραφή της εκτέλεσης δείχνει ακριβώς πόσες εγγραφές διαβάστηκαν, εγγράφηκαν και απέτυχαν.

Οι εγγυήσεις διακυβέρνησης

Η συγκατάθεση αποτυγχάνει κλειστά

Ένας κανόνας που γράφει προσωπικά δεδομένα στο Brevo δεν μπορεί να δημοσιευτεί χωρίς το φίλτρο συγκατάθεσης και αποκλεισμού. Κατά την εκτέλεση, μια επαφή που γράφεται σε κοινό μάρκετινγκ χωρίς αποδείξιμη συγκατάθεση απορρίπτεται. Όταν η συγκατάθεση δεν μπορεί να τεκμηριωθεί, το Tajo αρνείται την εγγραφή αντί να μαντέψει. Ο τρόπος αποτυχίας είναι πάντα «υπερβολικά προσεκτικός», ποτέ «υπερ-αποστολή».

Οι εκτελέσεις είναι ταυτοδύναμες (idempotent)

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

Όλα ελέγχονται

Η δημοσίευση ενός κανόνα, οι εγκρίσεις που ακυρώθηκαν και οι αυτόματες παύσεις καταγράφονται στο Activity. Κάθε απόφαση έγκρισης συνοδεύεται από γραπτή αιτιολόγηση. Κάθε εκτέλεση καταγράφεται στο ιστορικό εκτελέσεων του κανόνα. Η έγκριση που εξουσιοδότησε μια δημοσίευση δεσμεύεται σε ένα digest του ακριβούς κανόνα που πέρασε από προεπισκόπηση. Η τροποποίηση του κανόνα τον επιστρέφει σε προσχέδιο και ακυρώνει την έγκριση, ώστε αυτό που εκτελείται να είναι πάντα αυτό που εξουσιοδοτήθηκε.

Οι αποτυχίες θέτουν τον κανόνα σε παύση

Αν αποτύχουν πέντε διαδοχικές εκτελέσεις, ένας μηχανισμός ασφαλείας (circuit breaker) θέτει αυτόματα τον κανόνα σε παύση και εμφανίζει το τελευταίο σφάλμα στη σελίδα του κανόνα. Διορθώστε την αιτία και, στη συνέχεια, δημοσιεύστε ξανά για να συνεχιστεί η λειτουργία. Μια μερικώς αποτυχημένη εκτέλεση αναφέρει τον αριθμό των αποτυχιών της, ώστε να βλέπετε ακριβώς τι δεν έφτασε στον προορισμό του.

Πώς γίνονται σεβαστές οι απεγγραφές

• Όταν μια επαφή απεγγράφεται μέσω του συνδέσμου στο υποσέλιδο ενός email του Brevo, αυτή η εξαίρεση (opt-out) καταγράφεται στην επαφή, και το Brevo την εξαιρεί από περαιτέρω καμπάνιες.
• Στον συγχρονισμό πελατών σε παρτίδες, η εφαρμογή Shopify του Tajo συγκρίνει τον χρόνο της συγκατάθεσης στο Shopify με τον χρόνο της απεγγραφής στο Brevo και κρατά τον πιο πρόσφατο.
• Μια αλλαγή συγκατάθεσης που φτάνει από το Shopify ως webhook γράφεται στο Brevo όπως την αναφέρει το Shopify.
• Αν η επαφή ήταν εγγεγραμμένη στο Shopify, η εφαρμογή Shopify του Tajo την επισημαίνει ως απεγγεγραμμένη και εκεί. Ένα συμβάν του Brevo μετακινεί έναν πελάτη μόνο από εγγεγραμμένο σε απεγγεγραμμένο. Δεν εγγράφει ποτέ κανέναν, οπότε μια εγγραφή στο Brevo δεν αλλάζει το Shopify.

Ποια δεδομένα είναι διαθέσιμα

Η εφαρμογή Shopify του Tajo στέλνει επαφές, παραγγελίες, συμβάντα παραγγελιών και καλαθιού, τον κατάλογο προϊόντων και το απόθεμα. Το τι στέλνει ένας κανόνας συγχρονισμού εξαρτάται από την αντιστοίχιση πεδίων του. Για τους πελάτες του Shopify, το πρότυπο αντιστοιχίζει πεδία ταυτότητας, συνολική δαπάνη, αριθμό παραγγελιών, ετικέτες και το opt-in σε χαρακτηριστικά επαφών του Brevo, τα οποία μπορείτε να χρησιμοποιήσετε σε τμήματα και καμπάνιες. Η ακριβής αντιστοίχιση για τον χώρο εργασίας σας δεν κρύβεται σε κάποια περιγραφή: ανοίξτε τον κανόνα συγχρονισμού και διαβάστε τον πίνακα αντιστοίχισης πεδίων. Αυτός ο πίνακας είναι η έγκυρη απάντηση στο ερώτημα «τι συγχρονίζεται».

Τι δεν κάνει το Tajo σήμερα

Η ακρίβεια σχετικά με τα όρια έχει μεγαλύτερη σημασία από μια μακριά λίστα λειτουργιών:

• Δεν υπάρχουν κανόνες συγχρονισμού αμφίδρομης κατεύθυνσης. Ένας κανόνας συγχρονισμού γράφει μόνο στο Brevo. Οι εγγραφές της ίδιας της εφαρμογής Shopify στο Shopify (ανακλήσεις συγκατάθεσης, metafields αλληλεπίδρασης και πιστότητας του Brevo, ετικέτες επιπέδου πιστότητας) αναφέρονται στο Shopify permissions explained.
• Δεν υπάρχουν κανόνες συγχρονισμού σε πραγματικό χρόνο. Οι κανόνες συγχρονισμού εκτελούνται σε παρτίδες. Μόνο ο συγχρονισμός μέσω webhooks της εφαρμογής Shopify του Tajo λειτουργεί καθώς φτάνουν τα συμβάντα.
• Δεν υπάρχει κουμπί επαναφοράς αποθέματος (back-in-stock). Η εφαρμογή διατηρεί ενημερωμένο το απόθεμα προϊόντων στο Brevo και στέλνει ένα συμβάν back_in_stock στους αγοραστές που ζήτησαν ειδοποίηση. Το αίτημα πρέπει να προέρχεται από τη βιτρίνα σας: η εφαρμογή δεν προσθέτει κουμπί «Ειδοποιήστε με» στο θέμα σας.

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

Πού να δείτε τα δεδομένα σας

• Στο Tajo: ανοίξτε τον κανόνα συγχρονισμού στην ενότητα Connections > Syncs and mappings για το ιστορικό εκτελέσεων, τη θέση του cursor και τους μετρητές ανά εκτέλεση. Το Activity καταγράφει δημοσιεύσεις και αυτόματες παύσεις.
• Στο Brevo: ανοίξτε τις Επαφές και εξετάστε τα χαρακτηριστικά οποιασδήποτε επαφής για να επιβεβαιώσετε ότι τα αντιστοιχισμένα πεδία συμπληρώνονται. Δημιουργήστε τμήματα πάνω σε αυτά τα χαρακτηριστικά για στόχευση.

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

• Οι επαφές δεν εμφανίζονται στο Brevo: ελέγξτε την πιο πρόσφατη εκτέλεση του κανόνα για αποτυχίες, καθώς και την κατάστασή του (ένας κανόνας σε παύση δεν εκτελείται). Δείτε το άρθρο contacts missing in Brevo.
• Οι εκτελέσεις αποτυγχάνουν επανειλημμένα: ο μηχανισμός ασφαλείας θα θέσει τον κανόνα σε παύση και θα εμφανίσει το τελευταίο σφάλμα. Δείτε το άρθρο data not syncing.
• Διπλότυπες επαφές: οι εγγραφές είναι ταυτοδύναμες ανά εγγραφή προέλευσης, αλλά τα προϋπάρχοντα διπλότυπα στο Brevo παραμένουν. Δείτε το άρθρο duplicate contacts.

Συχνές ερωτήσεις

Μπορώ να κάνω τον συγχρονισμό πιο γρήγορο; Η σελίδα ενός ενεργού κανόνα έχει το κουμπί Test run (1 batch). Για αλλαγές τη στιγμή που συμβαίνουν, ο συγχρονισμός μέσω webhooks της εφαρμογής Shopify του Tajo καλύπτει ήδη πελάτες, παραγγελίες, checkouts, προϊόντα και απόθεμα.

Τι συμβαίνει αν μια εκτέλεση αποτύχει στη μέση; Η εκτέλεση αναφέρει τον αριθμό των αποτυχιών της, το cursor προχωρά μόνο πάνω σε ό,τι επεξεργάστηκε, και η επόμενη εκτέλεση καλύπτει ξανά το έδαφος με ασφάλεια. Τα κλειδιά ταυτοδυναμίας αποτρέπουν τα διπλότυπα.

Μπορώ να αλλάξω το τι συγχρονίζεται; Ναι. Ζητήστε από τον πράκτορα να αλλάξει την αντιστοίχιση πεδίων ή το φίλτρο του κανόνα. Η επεξεργασία επιστρέφει τον κανόνα σε προσχέδιο, και πρέπει να περάσει ξανά από προεπισκόπηση και έγκριση πριν εκτελεστεί ξανά.

Γιατί ο κανόνας μου μπήκε μόνος του σε παύση; Οι διαδοχικές αποτυχίες εκτελέσεων ενεργοποιούν τον μηχανισμό ασφαλείας. Η σελίδα του κανόνα δείχνει τον αριθμό αποτυχιών και το τελευταίο σφάλμα· διορθώστε το πρόβλημα και δημοσιεύστε ξανά.

Σχετικά άρθρα

• Σύνδεση του Tajo με το Shopify
• Βασικές αρχές τμηματοποίησης
• Αντιμετώπιση προβλημάτων: τα δεδομένα δεν συγχρονίζονται
• Αντιμετώπιση προβλημάτων: επαφές που λείπουν από το Brevo

Λάβετε βοήθεια

Επικοινωνήστε με την ομάδα.