Εισαγωγή
Στην ενότητα αυτή περιγράφεται μια νέα λειτουργικότητα της Καμπάνιας, το Passbook, που προσφέρει τη δυνατότητα δημιουργίας pkpass files και αποστολής τους με email μέσω της Καμπάνιας.
Το pkpass file είναι μια ψηφιακή κάρτα που φορτώνεται στην εφαρμογή Apple wallet των iOS. Το Apple Wallet γνωστό και ως Passbook, είναι μια εφαρμογή για κινητά που αναπτύχθηκε από την Apple Inc. και περιλαμβάνεται στο iOS και το watchOS. Επιτρέπει στους χρήστες να αποθηκεύουν ψηφιακές κάρτες, όπως κουπόνια, κάρτες επιβίβασης, εισιτήρια εκδηλώσεων, κάρτες καταστημάτων και άλλα.
Πλέον έχουν αναπτυχθεί και Android εφαρμογές με δυνατότητα ανοίγματος και αποθήκευσης τέτοιων καρτών όπως η WalletPasses | Passbook Wallet. Επομένως μπορούν να γίνουν χρήση και σε iOS και σε Android συσκευές.
Παράμετροι στις Ρυθμίσεις
Στις ρυθμίσεις της εφαρμογής CRM | Γενικά | Εξωτερικοί Πάροχοι ενσωματώθηκε η σελίδα “Passbook” με ένα πλήθος παραμέτρων για τη δημιουργία passes.
Προκειμένου τα passes να είναι αναγνωρίσιμα από το Apple wallet πρέπει να είναι υπογεγραμμένα με πιστοποιητικό, που έχει εκδοθεί από την Apple που σχετίζεται με τον έναν λογαριασμό προγραμματιστή Apple.
Η σημασία των παραμέτρων είναι η εξής:
- Apple WWDR (WorldWide Developer Relations) certificate: Για να χρησιμοποιήσετε τα πιστοποιητικά σας που σχετίζεται με τον έναν λογαριασμό προγραμματιστή Apple, πρέπει να έχετε το ενδιάμεσο πιστοποιητικό υπογραφής της Apple του συστήματός σας.
- Passbook certificate: To παραγόμενο πιστοποιητικό υπογραφής passes από το λογαριασμό προγραμματιστή Apple.
- Passbook certificate key: To κλειδί του κρυπτογραφημένου πιστοποιητικού υπογραφής passes.
- Pass type identifier: To μοναδικό αναγνωριστικό του πιστοποιητικού υπογραφής passes.
- Team name: Το όνομα της ομάδας του λογαριασμού προγραμματιστή στις πληροφορίες memberhip.
- Team ID: To μοναδικό αναγνωριστικό της ομάδας του λογαριασμού προγραμματιστή στις πληροφορίες memberhip.
Στο τέλος της ενότητας υπάρχει παράρτημα με οδηγίες για την πλατφόρμα προγραμματιστή της Apple καθώς και οδηγίες δημιουργίας πιστοποιητικού στην πλατφόρμα.
Παράμετροι στην καμπάνια
Αν στη σελίδα “Κύριες πληροφορίες” της καμπάνιας επιλεγεί ως εξωτερικός πάροχος το Passbook,
τότε στη σελίδα “Κείμενο καμπάνιας”, εμφανίζεται η σελίδα “Passbook” για την εισαγωγή παραμέτρων δημιουργίας pass.
Standard Fields
Για τη δημιουργία ενός pass πρέπει όλα τα standard fields να έχουν τιμή.
- Περιγραφή : Σύντομη περιγραφή του pass, χρησιμοποιείται από τις τεχνολογίες προσβασιμότητας iOS. Δεν φαίνεται στο ίδιο το pass. Μην προσπαθήσετε να συμπεριλάβετε όλα τα δεδομένα του pass στην περιγραφή του, απλώς συμπεριλάβετε κάποιες λεπτομέρειες, για να ξεχωρίσετε τα passes ίδιου τύπου.
- Κείμενο Logo : To κείμενο που θέλετε να εμφανίζεται στο logo του pass.
- Logo, Logo2x, Logo3x: Η εικόνα που θέλετε να εμφανίζεται στο logo του pass. Επειδή τα passes ανοίγουν σε devices διάφορων μεγεθών το logo πρέπει να υπάρχει σε “3” διαφορετικά μεγέθη. Το Logo αφορά στο μέγεθος της οθόνης κινητού, το Logo2x αφορά στο μέγεθος της οθόνης tablet και το Logo2x αφορά στο μέγεθος της οθόνης υπολογιστή.
- Icon, Icon2x, Icon3x: Το εικονίδιο του pass. Εμφανίζεται στις ειδοποιήσεις και στα email που έχουν συνημμένο pass και στην οθόνη κλειδώματος. Για τον ίδιο λόγο με τον προηγούμενο, πρέπει να ανέβει σε “3” μεγέθη.
- Background color: Το χρώμα του Pass.
- Foreground color: Το χρώμα με το οποίο θα σχεδιαστεί το κείμενο του pass.
- Label color: Το χρώμα με το οποίο θα σχεδιαστούν τα Labels του κειμένου του pass.
- Στιλ: Τα passes έχουν πέντε διαφορετικά στιλ εμφάνισης:
- Boarding Pass
- Coupon
- Event ticket
- Generic
- Store card
Ανάλογα με τον επιλεγμένο τύπο, το pass θα εμφανίζεται διαφορετικά στο Wallet.
- Transit type: Αν το pass έχει style Boarding Pass, τότε μπορεί να διαλέξει ανάμεσα σε πέντε διαφορετικά Transit types:
- Air
- Boat
- Bus
- Generic
- Train
Ακολουθούν λεπτομέρειες
Lower-level fields
Οι σελίδες “Header fields”, “Primary fields”, “Secondary fields”, “Auxiliary fields” και “Back field” είναι πεδία που εμφανίζονται σε διάφορα μέρη του pass.
- Header fields: Πεδία που θα εμφανίζονται στην κεφαλίδα στο μπροστινό μέρος του Pass
- Primary fields: Πεδία που θα εμφανίζονται ευδιάκριτα στο μπροστινό μέρος του Pass
- Secondary fields: Πεδία που θα εμφανίζονται στο μπροστινό μέρος του Pass
- Auxiliary fields: Πρόσθετα πεδία που θα εμφανίζονται στο μπροστινό μέρος του Pass
- Back field: Πεδία που θα εμφανίζονται στο πίσω μέρος του Pass
Ανάλογα με το Style του Pass τα πεδία αυτά θα εμφανίζονται σε λίγο διαφορετικές θέσεις και σε διαφορετικό πλήθος.
Ακολουθούν λεπτομέρειες
Στα πεδία αυτά υπάρχει δυνατότητα να γίνει δυναμική αντικατάσταση του πεδίου “Value” κάθε πεδίου κατά τη δημιουργία του pass όπως γίνεται και με το κείμενο της Καμπάνιας. Έτσι για παράδειγμα όταν δημιουργηθεί το passbook για το back field “1” το Value @@email@@ θα αντικατασταθεί από το πεδίο email της επαφής.
Πατώντας διπλό κλικ σε κάποιο από τα διαθέσιμο πεδία της καμπάνιας (δεξί τμήμα), αυτό προστίθεται στο τέλος του “Value” του τρέχοντος επιλεγμένου πεδίου αριστερά.
- Barcodes: Στα passes υπάρχει η δυνατότητα σχεδιασμού ενός barcode (στο κάτω μέρος τους). Τα barcodes μπορεί να είναι “4” διαφορετικών τύπων: QR, PDF417, Aztec και code128. Στο barcode πρέπει να οριστεί σε string η κωδικοποίηση του barcode. Αυτή συνήθως είναι iso-8859-1, αλλά μπορείτε να χρησιμοποιήσετε και άλλη κωδικοποίηση, που υποστηρίζεται από δική σας υποδομή σάρωσης barcodes.
Το Σύστημα υποστηρίζει πίνακα με πολλά bracodes παρόλο που στην εμφάνιση του pass χρησιμοποιεί το πρώτο έγκυρο barcode του πίνακα. Μπορούν να προστεθούν επιπλέον barcodes ως εναλλακτικά.
Επιπλέον, υπάρχει η δυνατότητα και στα barcodes να γίνει δυναμική αντικατάσταση του πεδίου “Μήνυμα” κατά τη δημιουργία του pass όπως γίνεται και με το κείμενο της Καμπάνιας. Έτσι για παράδειγμα, όταν δημιουργηθεί το passbook το barcode message ##ReferenceNumber## θα αντικατασταθεί από το πεδίο “Reference Number” της επαφής.
Δημιουργία Passes από την Καμπάνια
Τα Passes δημιουργούνται μέσα από την Καμπάνια με δύο τρόπους:
- Send Test Passbook
Από την ενέργεια της οθόνης της Καμπάνιας “Προεπισκόπηση κειμένου καμπάνιας” μπορεί να επιλεγεί η νέα ενέργεια που δημιουργήθηκε “Αποστολή δοκιμαστικού passbook”.
Ανοίγει η οθόνη του email client με το pass file στα “Συνημμένα” του προς αποστολή email.
- Από τον οδηγό Δημιουργίας email από Καμπάνια
Αν μέσα από Καμπάνια με εξωτερικό πάροχο “Passbook” επιλέξετε από τις ενέργειες “Δημιουργία δραστηριότητας” και στη συνέχεια το email, τότε στον οδηγό εμφανίζεται ένα πεδίο “Create passbook”.
Αν επιλεγεί τότε για κάθε email θα δημιουργηθεί ένα pass στα attachments.
Η συγκεκριμένη λειτουργικότητα υποστηρίζεται και στην αποστολή email μέσω dispatcher.
Pass Styles
Όπως προαναφέραμε, τα passes έχουν πέντε διαφορετικά στιλ εμφάνισης:
- Boarding Pass
- Coupon
- Event ticket
- Generic
- Store card
Παραθέτουμε layouts με την εμφάνιση κάθε στιλ. Οι εικόνες προέρχονται από την Apple.
Για περισσότερες λεπτομέρειες ανατρέξτε εδώ
Boarding Pass
Στα Boarding Passes, ανάλογα με το transit type που έχει επιλεγεί το βελάκι της εικόνας εμφανίζεται διαφορετικά. Για παράδειγμα για Air εμφανίζεται ένα αεροπλανάκι και για Bus ένα λεωφορειάκι.
Coupon
Event ticket
Για τα event tickets δεν υποστήριζεται προς το παρόν background image.
Generic
Store card
H Εμφάνιση των Passes είναι λίγο διαφορετική στα Smart watches.
Παρατίθενται εικόνες και γι’ αυτά.
Coupon, Event ticket, Generic και Store card
Boarding Pass
Όπως προαναφέρθηκε το Style καθορίζει τον αριθμό των πεδίων που μπορούν να εμφανιστούν στο μπροστινό μέρος ενός Pass:
- Γενικά, ένα πάσο μπορεί να έχει έως τρία πεδία κεφαλίδας (Header fields), ένα μόνο κύριο πεδίο (Primary fields), έως τέσσερα δευτερεύοντα πεδία (Secondary fields) και έως τέσσερα βοηθητικά πεδία (Auxiliary fields).
- Τα Boarding passes μπορούν να έχουν έως δύο κύρια πεδία (Primary fields), και έως πέντε βοηθητικά πεδία (Auxiliary fields).
- Τα Coupon, Store card και τα Generic passes με τετράγωνο barcode μπορούν να έχουν συνολικά έως τέσσερα δευτερεύοντα (Secondary fields) και βοηθητικά πεδία (Auxiliary fields). Ο αριθμός των πεδίων που εμφανίζονται στα passes εξαρτάται επίσης από το μήκος του κειμένου σε κάθε πεδίο. Αν υπάρχει πάρα πολύ κείμενο, ορισμένα πεδία ενδέχεται να μην εμφανίζονται.
ΣΗΜΕΙΩΣΗ από το site της Apple
Μην συμπεριλάβετε περισσότερα πεδία από αυτά που εμφανίζονται στο μπροστινό μέρος του pass σας. Παρόλο που τα πρόσθετα πεδία ενδέχεται να μην εμφανίζονται σήμερα, οι διατάξεις ενδέχεται να αλλάξουν στο μέλλον και δεν θα θέλατε να γίνει ξαφνικά ορατό στους χρήστες ένα παλαιότερα κρυφό πεδίο.
Παράρτημα δημιουργίας πιστοποιητικού και άλλες πληροφορίες για το Developer Platform της Apples
Οδηγίες δημιουργίας πιστοποιητικού
-
Κάντε login στην Apple Developers platform και επιλέξτε Certificates, Identifiers & Profiles
-
Επιλέξτε Identifiers από το μενού στα αριστερά και στη συνέχεια Pass Type ID
-
Συμπληρώστε το επιθυμητό description ένα αναγνωριστικό στο ID.
- Επαληθεύστε το όνομα και το αναγνωριστικό σας και καταχωρίστε στη συνέχεια, το αναγνωριστικό τύπου Pas
-
Επιλέξτε Create Certificate στον Pass type Identifier που δημιουργήσατε
- Ακολουθήστε τις οδηγίες του άρθρου Create a certificate signing request, και μετά ανεβάστε το πιστοποιητικό πατώντας το “choose file”
- Κατεβάστε το νέο σας πιστοποιητικό. Κάντε διπλό κλικ για να προσθέσετε αυτό το πιστοποιητικό στο Keychain σας. Κάντε δεξί κλικ στο πιστοποιητικό σας μέσα στο Keychain Access για εξαγωγή σε ένα αρχείο .p12.
- Δώστε έναν κωδικό κρυπτογράφησης για το πιστοποιητικό. Αυτό τον κωδικό θα πρέπει να δηλώσετε στο πεδίο Passbook certificate key στις “Γενικές ρυθμίσεις του CRM”
Παράμετροι CRM
Κάντε login στην Apple Developers platform
- Apple WWDR (WorldWide Developer Relations) certificate: To Apple WWDR certificate βρίσκεται Certificates, Identifiers & Profiles.
Πατήστε το plus button
Και κατεβάστε το Worldwide Developer Relations - G4 στο Section Intermediate Certificates, που βρίσκεται κάτω τμήμα.
- Passbook certificate: To παραγόμενο που δημιουργήθηκε προηγουμένως
- Passbook certificate key: Ο κωδικός κρυπτογράφησης για το πιστοποιητικό που δόθηκε προηγουμένως (βήμα 8)
- Pass type identifier: To μοναδικό αναγνωριστικό που δόθηκε προηγουμένως κατά τη δημιουργία του Pass type identifier (βήμα 3)
-
Team name και Team ID: Στο Apple Developers platform, στο μενού αριστερά επιλέξτε Membership
Εμφανίζεται η κάρτα με τα στοιχεία σας όπου εκεί θα βρείτε τα Team Name .