Passbook | Galaxy CRM

Εισαγωγή

Στην ενότητα αυτή περιγράφεται μια νέα λειτουργικότητα της Καμπάνιας, το 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.

Graphical user interface, text, application, emailDescription automatically generated

Στο τέλος της ενότητας υπάρχει παράρτημα με οδηγίες για την πλατφόρμα προγραμματιστή της Apple καθώς και οδηγίες δημιουργίας πιστοποιητικού στην πλατφόρμα.

Παράμετροι στην καμπάνια

Αν στη σελίδα “Κύριες πληροφορίες” της καμπάνιας επιλεγεί ως εξωτερικός πάροχος το Passbook,

Graphical user interface, text, application</p>
<p>Description automatically generated

τότε στη σελίδα “Κείμενο καμπάνιας”, εμφανίζεται η σελίδα Passbook για την εισαγωγή παραμέτρων δημιουργίας pass.

Standard Fields

Για τη δημιουργία ενός pass πρέπει όλα τα standard fields να έχουν τιμή.

Graphical user interface, application</p>
<p>Description automatically generated

  • Περιγραφή : Σύντομη περιγραφή του 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 τα πεδία αυτά θα εμφανίζονται σε λίγο διαφορετικές θέσεις και σε διαφορετικό πλήθος.

Ακολουθούν λεπτομέρειες

 

Graphical user interface, application</p>
<p>Description automatically generated
Graphical user interface, text, application</p>
<p>Description automatically generated
Graphical user interface, application</p>
<p>Description automatically generated
Graphical user interface, application</p>
<p>Description automatically generated
Graphical user interface, application</p>
<p>Description automatically generated

Στα πεδία αυτά υπάρχει δυνατότητα να γίνει δυναμική αντικατάσταση του πεδίου “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” της επαφής.

Graphical user interface, application</p>
<p>Description automatically generated

Δημιουργία Passes από την Καμπάνια

Τα Passes δημιουργούνται μέσα από την Καμπάνια με δύο τρόπους:

  1. Send Test Passbook

Από την ενέργεια της οθόνης της Καμπάνιας “Προεπισκόπηση κειμένου καμπάνιας” μπορεί να επιλεγεί η νέα ενέργεια που δημιουργήθηκε “Αποστολή δοκιμαστικού passbook”.

Graphical user interface, applicationDescription automatically generated

Ανοίγει η οθόνη του email client με το pass file στα “Συνημμένα” του προς αποστολή email.

Graphical user interface, text, applicationDescription automatically generated

  1. Από τον οδηγό Δημιουργίας email από Καμπάνια

Αν μέσα από Καμπάνια με εξωτερικό πάροχο “Passbook” επιλέξετε από τις ενέργειες “Δημιουργία δραστηριότητας” και στη συνέχεια το email, τότε στον οδηγό εμφανίζεται ένα πεδίο “Create passbook”.

Graphical user interface, application</p>
<p>Description automatically generated

Αν επιλεγεί τότε για κάθε 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 ένα λεωφορειάκι.

Diagram</p>
<p>Description automatically generated

Coupon



Diagram</p>
<p>Description automatically generated

Event ticket


Για τα event tickets δεν υποστήριζεται προς το παρόν background image.

Chart</p>
<p>Description automatically generated with medium confidence

Generic


Store card 


 

 
 
 

H Εμφάνιση των Passes είναι λίγο διαφορετική στα Smart watches.

Παρατίθενται εικόνες και γι’ αυτά.

 

Coupon, Event ticket, Generic και Store card



Diagram</p>
<p>Description automatically generated

Boarding Pass


Diagram</p>
<p>Description automatically generated

Όπως προαναφέρθηκε το 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

Οδηγίες δημιουργίας πιστοποιητικού

  1. Κάντε login στην Apple Developers platform και επιλέξτε Certificates, Identifiers & Profiles
    Graphical user interface, application</p>
<p>Description automatically generated
  2. Επιλέξτε Identifiers από το μενού στα αριστερά και στη συνέχεια Pass Type ID
    Graphical user interface, text, application</p>
<p>Description automatically generated
  3. Συμπληρώστε το επιθυμητό description ένα αναγνωριστικό στο ID.
    Graphical user interface, text, application, email</p>
<p>Description automatically generated
  4. Επαληθεύστε το όνομα και το αναγνωριστικό σας και καταχωρίστε στη συνέχεια, το αναγνωριστικό τύπου Pas

Graphical user interface, text, application, email</p>
<p>Description automatically generated

  1. Επιλέξτε Create Certificate στον Pass type Identifier που δημιουργήσατε
    Graphical user interface, text, application, email</p>
<p>Description automatically generated
  2. Ακολουθήστε τις οδηγίες του άρθρου  Create a certificate signing request, και μετά ανεβάστε το πιστοποιητικό πατώντας το “choose file”

Graphical user interface, text, application</p>
<p>Description automatically generated

  1. Κατεβάστε το νέο σας πιστοποιητικό. Κάντε διπλό κλικ για να προσθέσετε αυτό το πιστοποιητικό στο Keychain σας. Κάντε δεξί κλικ στο πιστοποιητικό σας μέσα στο Keychain Access για εξαγωγή σε ένα αρχείο .p12.

Graphical user interface, application</p>
<p>Description automatically generated

  1. Δώστε έναν κωδικό κρυπτογράφησης για το πιστοποιητικό. Αυτό τον κωδικό θα πρέπει να δηλώσετε στο πεδίο Passbook certificate key στις “Γενικές ρυθμίσεις του CRM”

Graphical user interface, text, application</p>
<p>Description automatically generated

 

Παράμετροι CRM

Κάντε login στην Apple Developers platform

  • Apple WWDR (WorldWide Developer Relations) certificate: To Apple WWDR certificate βρίσκεται Certificates, Identifiers & Profiles.

Graphical user interface, application</p>
<p>Description automatically generated
Πατήστε το plus button

Graphical user interface, text, application, chat or text message</p>
<p>Description automatically generated

Και κατεβάστε το Worldwide Developer Relations - G4 στο Section Intermediate Certificates, που βρίσκεται κάτω τμήμα.

Graphical user interface, text, application, email</p>
<p>Description automatically generated

  • Passbook certificate: To παραγόμενο που δημιουργήθηκε προηγουμένως
  • Passbook certificate key: Ο κωδικός κρυπτογράφησης για το πιστοποιητικό που δόθηκε προηγουμένως (βήμα 8)
  • Pass type identifier: To μοναδικό αναγνωριστικό που δόθηκε προηγουμένως κατά τη δημιουργία του Pass type identifier (βήμα 3)
  • Team name και Team ID: Στο Apple Developers platform, στο μενού αριστερά επιλέξτε Membership
    Graphical user interface, application</p>
<p>Description automatically generated
    Εμφανίζεται η κάρτα με τα στοιχεία σας όπου εκεί θα βρείτε τα Team Name .