Μαζική εισαγωγή (CSV / JSON)
Η Μαζική εισαγωγή σάς επιτρέπει να φορτώσετε δεδομένα στο Joryio από αρχείο: προφίλ χρηστών, ιστορικά συμβάντα ή γραμμές για τις προσαρμοσμένες οντότητές σας. Ανοίξτε το Δεδομένα → Μαζική εισαγωγή (/users/import) στο dashboard, αποθέστε ένα αρχείο CSV ή JSON, αντιστοιχίστε τις στήλες του και το Joryio το επεξεργάζεται στο παρασκήνιο ενώ παρακολουθείτε την πρόοδο.
Αυτή η σελίδα καλύπτει τις μεταφορτώσεις αρχείων. Ο ξεχωριστός connector Data Import στο Δεδομένα → Data Import αντλεί δεδομένα χρηστών από αποθήκες δεδομένων (Snowflake, BigQuery) μέσω σύνδεσης που ρυθμίζετε μία φορά. Χρησιμοποιήστε τη Μαζική εισαγωγή για μεμονωμένα αρχεία - μια εξαγωγή CRM, μια παλαιά λίστα, ένα backfill συμβάντων· χρησιμοποιήστε το Data Import όταν η πηγή αλήθειας βρίσκεται σε αποθήκη δεδομένων.
Απαιτήσεις αρχείου
| Μορφές | .csv (πρώτη γραμμή = κεφαλίδες στηλών) ή .json (πίνακας αντικειμένων - οτιδήποτε άλλο απορρίπτεται). |
| Μέγεθος μεταφόρτωσης | Έως 100 MB ανά αρχείο από το dashboard. |
| Γραμμές | Έως 1.000.000 γραμμές ανά εισαγωγή (στον διακομιστή· γραμμές πέρα από το όριο δεν επεξεργάζονται). |
| Ταυτόχρονη εκτέλεση | Μία εισαγωγή τη φορά ανά χώρο εργασίας - η εκκίνηση δεύτερης ενώ μία επεξεργάζεται απορρίπτεται. |
Τα αρχεία μεταφορτώνονται απευθείας στην αποθήκευση μέσω presigned URL και στη συνέχεια ένας background worker επεξεργάζεται την εργασία. Τα μεταφορτωμένα αρχεία διαγράφονται μετά την επεξεργασία και λήγουν ούτως ή άλλως μετά από 24 ώρες.
Τύποι εισαγωγής
Επιλέξτε τον τύπο πριν από τη μεταφόρτωση - αλλάζει τους διαθέσιμους στόχους αντιστοίχισης:
- Χρήστες - δημιουργία ή ενημέρωση προφίλ επαφών.
- Συμβάντα - backfill ιστορικών συμβάντων στο αναλυτικό αποθετήριο.
- Οντότητες - φόρτωση γραμμών σε μία από τις προσαρμοσμένες οντότητες (επιλέγετε ποια).
Αντιστοίχιση στηλών
Αφού επιλέξετε αρχείο, μπορείτε να προσθέσετε αντιστοιχίσεις πεδίων: κάθε γραμμή αντιστοιχίζει μια στήλη προέλευσης (πληκτρολογημένη ακριβώς όπως εμφανίζεται στο αρχείο σας) σε ένα πεδίο προορισμού (από αναπτυσσόμενη λίστα).
Αν δεν προσθέσετε αντιστοιχίσεις, οι εισαγωγές χρηστών κάνουν αυτόματη ανίχνευση: τα externalId / external_id / userId / user_id γίνονται το εξωτερικό ID, τα email και phone αντιστοιχίζονται στον εαυτό τους, στήλες που μοιάζουν με στήλες κατάστασης συνδρομής (πρόθεμα καναλιού συν κατάληξη τύπου κατάστασης, π.χ. email_subscription_status, sms_opt_in) ορίζουν τη συγκατάθεση καναλιού και κάθε άλλη στήλη γίνεται προσαρμοσμένο χαρακτηριστικό με το δικό της όνομα.
Με ρητές αντιστοιχίσεις, εισάγονται μόνο οι αντιστοιχισμένες στήλες. Πεδία προορισμού για εισαγωγές χρηστών:
| Προορισμός | Σημασία |
|---|---|
externalId | Το σταθερό σας ID χρήστη - το προτιμώμενο αναγνωριστικό. |
email / phone | Αναγνωριστικά επαφής. Το email μετατρέπεται σε πεζά και καθαρίζεται· το τηλέφωνο κανονικοποιείται σε E.164. |
attributes.firstName, attributes.lastName, attributes.<anything> | Χαρακτηριστικά προφίλ (επιλέξτε Custom Attribute... και πληκτρολογήστε το κλειδί). |
subscriptions.email / sms / whatsapp / push | Κατάσταση συγκατάθεσης σε επίπεδο καναλιού. |
Group: <name> (<channel>) | Συγκατάθεση ανά ομάδα - ορίζει την κατάσταση της επαφής σε συγκεκριμένη ομάδα συνδρομής / κατηγορία συγκατάθεσης (αποθηκεύεται ως subscriptions.list.<listId>.<channel>). Δείτε τη Διαχείριση συνδρομών. |
Πώς γίνεται η αντιστοίχιση χρηστών (dedup / identify)
Κάθε γραμμή χρήστη πρέπει να φέρει externalId ή email - γραμμές χωρίς κανένα από τα δύο παραλείπονται και εμφανίζονται στην αναφορά σφαλμάτων.
- Αν η γραμμή έχει
externalId, το Joryio αντιστοιχίζει βάσει αυτού (εντός του χώρου εργασίας). - Διαφορετικά αντιστοιχίζει βάσει του κανονικοποιημένου
email. - Μια αντιστοίχιση ενημερώνει το υπάρχον προφίλ (γράφονται μόνο τα πεδία που υπάρχουν στη γραμμή - χαρακτηριστικά εκτός αρχείου μένουν ανέγγιχτα)· χωρίς αντιστοίχιση δημιουργείται νέα επαφή.
Η σύνοψη της εργασίας αναφέρει τα δύο αποτελέσματα ξεχωριστά ως Δημιουργήθηκαν και Ενημερώθηκαν. Η επανεισαγωγή του ίδιου αρχείου είναι ασφαλής: οι γραμμές απλώς καταλήγουν σε ενημερώσεις.
Καταστάσεις συνδρομής και ασφάλεια συγκατάθεσης
Τα κελιά κατάστασης ερμηνεύονται ελαστικά: τα subscribed / true / yes / 1 σημαίνουν εγγεγραμμένος· τα unsubscribed / false / no / 0 / opt_out σημαίνουν απεγγεγραμμένος· τα opted_in / double_opt_in / confirmed σημαίνουν επιβεβαιωμένη εγγραφή. Κενές ή μη αναγνωρίσιμες τιμές αφήνουν το κανάλι ανέγγιχτο.
Από προεπιλογή (πλαίσιο ελέγχου απενεργοποιημένο), εφαρμόζονται κανόνες προστασίας συγκατάθεσης ανά κανάλι και ανά ομάδα:
- Οι απεγγραφές στο αρχείο εφαρμόζονται πάντα.
- Μια προηγούμενη απεγγραφή δεν επανεγγράφεται ποτέ σιωπηλά από εισαγωγή.
- Μια επιβεβαιωμένη εγγραφή δεν υποβαθμίζεται ποτέ σε απλή εγγραφή.
Επιλέγοντας «Εφαρμογή κατάστασης συνδρομής σε όλες τις γραμμές...», το αρχείο αντιμετωπίζεται ως πηγή αλήθειας - μπορεί να επανεγγράψει προηγούμενες απεγγραφές και να υποβαθμίσει εγγραφές. Επιβεβαιώνετε ότι έχετε συγκατάθεση για επικοινωνία με αυτούς τους χρήστες. Σε κάθε περίπτωση, κάθε αλλαγή μιας εισαγωγής καταγράφεται στο ιστορικό συνδρομών της επαφής με πηγή import.
Εισαγωγές συμβάντων
Πεδία προορισμού: userId (αντιστοιχίζεται με το externalId), email, eventName, timestamp και properties.<key> για ιδιότητες συμβάντος. Κανόνες που επιβάλλει ο worker:
- Κάθε γραμμή χρειάζεται
eventNameκαιuserIdήemail- και ο χρήστης πρέπει να υπάρχει ήδη στον χώρο εργασίας, αλλιώς η γραμμή παραλείπεται (εισαγάγετε πρώτα τους χρήστες). - Το
timestampείναι προαιρετικό· μη αναγνώσιμη τιμή αποτυγχάνει τη γραμμή, και μη ρεαλιστικές τιμές (πάνω από ~2 έτη στο παρελθόν ή 1 ώρα στο μέλλον) περιορίζονται στο τώρα - ίδιος κανόνας με τη ζωντανή παρακολούθηση συμβάντων. - Οι ιδιότητες έχουν τις ίδιες προστασίες με τη ζωντανή διαδρομή
/track: όρια μεγέθους/αριθμού κλειδιών/βάθους και απόκρυψη PII. - Οι εισαγωγές είναι ασφαλείς σε επανάληψη: η επανεκτέλεση της ίδιας εργασίας δεν μπορεί να εισαγάγει διπλά συμβάντα.
Τα εισαγόμενα συμβάντα καταλήγουν στην ίδια ροή συμβάντων με τα ζωντανά, οπότε είναι ορατά σε τμήματα και αναλυτικά στοιχεία.
Εισαγωγές οντοτήτων
Επιλέξτε πρώτα την οντότητα-στόχο· τα πεδία της γίνονται οι στόχοι αντιστοίχισης. Χωρίς αντιστοιχίσεις, οι στήλες αντιστοιχίζονται απευθείας στα ονόματα πεδίων της οντότητας. Γραμμές χωρίς υποχρεωτικό πεδίο οντότητας παραλείπονται με σφάλμα. Αν μια γραμμή φέρει στήλη _id / id, η γραμμή κάνει upsert (ενημερώνει την υπάρχουσα εγγραφή ή τη δημιουργεί)· διαφορετικά εισάγεται νέα εγγραφή. Η διαχείριση εκδόσεων και η ήπια διαγραφή ακολουθούν τις ρυθμίσεις της ίδιας της οντότητας.
Παρακολούθηση εισαγωγής
Ο πίνακας Πρόσφατες εισαγωγές εμφανίζει κάθε εργασία με τον τύπο, τη μορφή, τη γραμμή προόδου, την κατάσταση και ποιος την ξεκίνησε, με αυτόματη ανανέωση όσο κάτι εκτελείται. Καταστάσεις:
| Κατάσταση | Σημασία |
|---|---|
| Σε αναμονή / Σε επεξεργασία | Σε ουρά, στη συνέχεια επεξεργάζεται το αρχείο σε παρτίδες. |
| Ολοκληρώθηκε | Τελείωσε - ελέγξτε τους μετρητές ανά γραμμή. |
| Απέτυχε | Η ίδια η εργασία απέτυχε (π.χ. το μεταφορτωμένο αρχείο δεν βρέθηκε)· εμφανίζεται το μήνυμα σφάλματος. Οι αποτυχημένες εργασίες επαναλαμβάνονται μία φορά αυτόματα πριν καταλήξουν εδώ. |
| Έληξε | Παλιά ολοκληρωμένη εργασία της οποίας το αρχείο και η αναφορά σφαλμάτων έχουν καθαριστεί (24 ώρες). |
Κάντε κλικ στο Προβολή σε μια εργασία για το παράθυρο λεπτομερειών: συνολικές γραμμές, μετρητές Δημιουργήθηκαν / Ενημερώθηκαν / Παραλείφθηκαν / Απέτυχαν και - όταν κάποιες γραμμές είχαν προβλήματα - σύνδεσμο Λήψη σφαλμάτων με τον αριθμό κάθε προβληματικής γραμμής και την αιτία (οι τιμές αναγνωριστικών αποκρύπτονται). Ο σύνδεσμος της αναφοράς σφαλμάτων είναι διαθέσιμος για 24 ώρες μετά την ολοκλήρωση.
Μια γραμμή είναι Παραλείφθηκε όταν αποτυγχάνει στην επικύρωση (λείπει αναγνωριστικό, άγνωστος χρήστης σε εισαγωγή συμβάντων, λείπει υποχρεωτικό πεδίο οντότητας)· το Απέτυχαν μετρά πραγματικά σφάλματα εγγραφής.
Σχετικές σελίδες
- Data Import (αποθήκες δεδομένων) - προγραμματισμένος συγχρονισμός από Snowflake / BigQuery.
- Τμήματα - τα εισαγόμενα χαρακτηριστικά είναι άμεσα διαθέσιμα για τμηματοποίηση.
- Διαχείριση συνδρομών - ομάδες και κατηγορίες συγκατάθεσης στις οποίες γράφουν οι στόχοι εισαγωγής ανά ομάδα.