Με την ενσωμάτωση του Bloomreach, κάθε άτομο που εγγράφεται δημιουργείται ή ενημερώνεται ως πελάτης στο project σας στο Bloomreach Engagement, με αναγνωριστικό τη διεύθυνση email του. Μπορείτε επίσης να του αποδώσετε μια συγκατάθεση Bloomreach, ώστε να έχετε τη δυνατότητα να του στέλνετε μηνύματα μάρκετινγκ.
Τι χρειάζεστε
- Ένα project στο Bloomreach Engagement και έναν χρήστη που μπορεί να διαχειρίζεται την πρόσβαση API στις ρυθμίσεις του project (συνήθως έναν διαχειριστή του project).
Βήμα 1: Δημιουργήστε ένα κλειδί API στο Bloomreach
- Στο Bloomreach Engagement, ανοίξτε το project και μεταβείτε στις επιλογές Project settings > Access management > API.
- Αντιγράψτε το Project token και το API base URL που εμφανίζονται στη σελίδα.
- Στις ομάδες API, δημιουργήστε μια νέα ομάδα με Private access και δώστε της ένα όνομα, για παράδειγμα «Scratcher».
- Δημιουργήστε ένα νέο κλειδί API στην ομάδα. Αντιγράψτε το API key ID και το API secret. Το secret εμφανίζεται μόνο μία φορά.
- Δώστε στην ομάδα τα παρακάτω δικαιώματα και αποθηκεύστε.
Δικαιώματα που χρειάζεται το κλειδί
Στα δικαιώματα της ομάδας, επιτρέψτε τα εξής:
- Customer properties: get και set, για την αναζήτηση πελατών και τη δημιουργία ή ενημέρωσή τους, καθώς και για την εμφάνιση των ιδιοτήτων πελατών σας στην αντιστοίχιση πεδίων.
- Events: set, για το συμβάν
consent, ώστε το Scratcher να μπορεί να καταγράφει συγκαταθέσεις.
Δεν χρειάζεται τίποτα άλλο. Χωρίς τα δικαιώματα set, οι αποστολές αποτυγχάνουν με το σφάλμα πρόσβασης του ίδιου του Bloomreach.
Βήμα 2: Συνδέστε το Bloomreach με το Scratcher
- Στο Scratcher, μεταβείτε στις Ρυθμίσεις > Ενσωματώσεις και κάντε κλικ στο Bloomreach.
- Επικολλήστε το API base URL, το project token, το API key ID και το API secret στα αντίστοιχα πεδία.
- Κάντε κλικ στο Εγκατάσταση ενσωμάτωσης. Το Scratcher επαληθεύει τα στοιχεία με το Bloomreach.
Βήμα 3: Ενεργοποιήστε την σε μια καμπάνια
- Στον Επεξεργαστή, μεταβείτε στις επιλογές Σύνδεση > Ενσωματώσεις > Bloomreach και κάντε κλικ στο Ενεργοποίηση.
- Αν έχετε συνδέσει περισσότερα από ένα project, επιλέξτε το επιθυμητό στο Επιλογή λογαριασμού.
- Στην ενότητα Αντιστοιχίσεις πεδίων, κάντε κλικ στο Προσθήκη αντιστοίχισης πεδίου και αντιστοιχίστε κάθε Πεδίο Scratcher σε μια ιδιότητα πελάτη του Bloomreach, για παράδειγμα το «Lead - Όνομα» στο first_name.
- Επιλέξτε την κατηγορία συγκατάθεσης που θα λαμβάνουν οι συμμετέχοντες, για παράδειγμα «newsletter», ή καμία.
- Στην ενότητα Φιλτράρισμα βάσει αδειών (προαιρετικό), επιλέξτε το πλαίσιο ελέγχου συγκατάθεσης μάρκετινγκ, ώστε να αποστέλλονται μόνο όσοι το έχουν τσεκάρει.
- Κάντε κλικ στο Αποθήκευση και, στη συνέχεια, στο Δοκιμή.
Καλό να γνωρίζετε: Το Bloomreach δεν διαθέτει λίστες. Όλοι καταχωρούνται στο project και τους ομαδοποιείτε με segments μέσα στο Bloomreach. Επομένως, το Scratcher ξεκινά την αποστολή μόλις κάνετε κλικ στο Ενεργοποίηση. Ενεργοποιήστε την πριν από την έναρξη της καμπάνιας ή ρυθμίστε την αμέσως.
Αντιστοίχιση πεδίων
- Η διεύθυνση email αποστέλλεται πάντα και χρησιμοποιείται για τον εντοπισμό του πελάτη. Δεν χρειάζεται να την αντιστοιχίσετε.
- Η λίστα Πεδίο προορισμού εμφανίζει τις ιδιότητες πελατών του project σας. Αν λείπει κάποια ιδιότητα, δημιουργήστε την πρώτα στο Bloomreach.
- Για να επισημάνετε από πού προήλθαν οι πελάτες, αντιστοιχίστε μια Χρήση προσαρμοσμένης τιμής, όπως «Scratcher summer game», σε μια ιδιότητα που χρησιμοποιείτε για την πηγή.
Συγκατάθεση
Αν επιλέξετε κατηγορία συγκατάθεσης, το Scratcher καταγράφει ένα συμβάν consent με ενέργεια accept και ως πηγή το όνομα της καμπάνιας. Η κατηγορία πρέπει να υπάρχει στο Bloomreach (στις ρυθμίσεις συγκατάθεσης, στο Project settings). Χρησιμοποιήστε το Φιλτράρισμα βάσει αδειών, ώστε τη συγκατάθεση να λαμβάνουν μόνο όσοι τσέκαραν το πλαίσιο μάρκετινγκ.
Τι αποστέλλεται και πότε
Οι νέες εγγραφές αποστέλλονται μέσα σε ένα με δύο λεπτά. Όταν ενεργοποιείτε την ενσωμάτωση, αποστέλλονται επίσης τα υπάρχοντα leads της καμπάνιας. Όταν κάποιος συμμετέχει ξανά, ο πελάτης ενημερώνεται. Ελέγξτε κάθε αποστολή στις Ρυθμίσεις > Ενσωματώσεις > Κατάσταση αποστολής. Δείτε τον οδηγό Έλεγχος κατάστασης αποστολής και επαναποστολή leads.
Αντιμετώπιση προβλημάτων
- «All or some of the fields are invalid...» κατά την εγκατάσταση: ελέγξτε το API base URL και το project token και αντιγράψτε ξανά το key ID και το secret.
- Οι αποστολές αποτυγχάνουν με σφάλμα πρόσβασης: από την ομάδα API λείπει κάποιο από τα παραπάνω δικαιώματα. Επεξεργαστείτε την στο Bloomreach.
- Η συγκατάθεση δεν εμφανίζεται στον πελάτη: η κατηγορία συγκατάθεσης δεν υπάρχει στο Bloomreach ή είναι γραμμένη διαφορετικά.
- Το Bloomreach διαθέτει δικούς του οδηγούς για τα κλειδιά API. Αναζητήστε «API access management» στην τεκμηρίωση του Bloomreach, αν τα μενού φαίνονται διαφορετικά.