כרטיסי Wallet

Joryio יכולה להנפיק כרטיסי Apple Wallet ו-Google Wallet - כרטיסי נאמנות, קופונים, כרטיסים לאירועים וכרטיסים כלליים - ממותגים באמצעות פרטי הגישה שלכם ל-Apple ול-Google. מוסיפים קישור "Add to Wallet" לכל הודעה (אימייל, in‑app, SMS או WhatsApp); כל נמען מקבל כרטיס מותאם אישית משלו, וניתן לעדכן כרטיס שהונפק בכל רגע מתוך מסע - והשינוי נדחף ישירות למכשיר.

כך זה עובד

כרטיס Wallet אינו הודעה; יש לו שלושה שלבים:

1. הנפקה (Provision) - כשהנמענים מקישים על קישור ה־Add‑to‑Wallet, Joryio יוצרת כרטיס מותאם אישית וחותמת עליו באמצעות פרטי הגישה שלכם. ההנפקה מתבצעת רק בעת הלחיצה, כך שניתן להטמיע קישור לכל נמען בכל הודעה ללא חתימה בזמן השליחה.
2. הפצה (Distribute) - הקישור נמצא בתוך הודעה רגילה. ההודעה כפופה לאותם כללי הסכמה, חסימה, שעות שקט ותדירות כמו כל הודעה אחרת בערוץ שלה.
3. עדכון (Update) - כשמשנים כרטיס של איש קשר (למשל יתרת נקודות חדשה), העדכון נדחף לכל מכשיר שהתקין אותו (Apple דרך push, Google דרך ה-Wallet API). העדכונים עוברים ישירות בין המערכות ואינם כפופים להסכמה שיווקית, אך כרטיסו של איש קשר שנמחק או סומן כמי שאין ליצור איתו קשר יבוטל במקום להתעדכן.

1. חיבור פרטי הגישה

עברו אל Settings → Wallet Passes והוסיפו חשבון ספק. בכל חשבון מתועד מי יצר אותו ומי עדכן אותו לאחרונה.

Apple Wallet

נדרשים חשבון Apple Developer ותעודת Pass Type ID. יש שתי דרכים להוסיף אותה:

• CSR → תעודה (מומלץ): Joryio מייצרת עבורכם בקשת חתימה (CSR) להעלאה לפורטל Apple Developer; לאחר מכן מעלים בחזרה ל-Joryio את קובץ ה-.cer שהנפיקה Apple. המפתח הפרטי לעולם אינו עוזב את Joryio.
• העלאת .p12: העלאת תעודת Pass Type ID קיימת שייצאתם כקובץ .p12, יחד עם הסיסמה שלה.

ספקו את Team ID, את ה-Pass Type ID (למשל pass.com.yourcompany.loyalty) ומפתח APNs (כדי שניתן יהיה לדחוף עדכוני כרטיס). Joryio מתריעה כשהתעודה מתקרבת לתפוגה וחוסמת הנפקה לאחר שפג תוקפה - השתמשו ב-Update certificate בחשבון כדי לחדש אותה בלי ליצור חשבון חדש.

Google Wallet

נדרשים service account ב-Google Cloud עם תפקיד Wallet Object Issuer וכן ה-Issuer ID שלכם. העלו את ה-JSON של ה-service account והזינו את ה-Issuer ID.

פרטי הגישה מוצפנים בעת האחסון ומוצגים כשהם מוסווים לאחר השמירה; אפשר להחליפם בכל עת.

2. יצירת תבנית כרטיס

ב־Brand Studio → Wallet Templates, צרו תבנית באמצעות from scratch או התחילו מ־gallery preset. פרטי הבסיס - Name, Description, Tags, Pass type וחשבון Apple / Google - מופיעים בחלקו העליון של הבונה. כל השאר מאורגן בשלוש לשוניות:

• Front of Pass - הצד הגלוי של הכרטיס.
• Back of Pass - השורות שמוצגות כשמהפכים את הכרטיס.
• Features - יכולות ברמת הכרטיס (תפוגה, App deep links, מיקומים).

מימין יש תצוגה מקדימה חיה עם מתג Front / Back משלה, ומתג Apple Wallet / Google Wallet מאפשר לעצב כל פלטפורמה בנפרד.

ערכי השדות והברקוד הם תבניות Liquid שמעובדות לכל נמען - למשל ערך של שדה primary בנוסח {{ user.custom.points }} מציג לכל לקוח את יתרת הנקודות שלו. התצוגה המקדימה מציגה פריסה עם נתוני דוגמה; הטוקנים האמיתיים מוחלפים בערכים המתאימים לכל נמען בזמן השליחה.

Front of Pass

• Design - צבעי רקע, טקסט ותווית; טקסט לוגו; ותמונות (logo, icon, strip, hero). בכרטיסי Apple ניתן גם suppress strip shine.
• Fields - קבוצות header / primary / secondary / auxiliary‏ (key, label, value). כרטיסי אירוע מוסיפים Event info (שם אירוע, מקום); כרטיסי Google כלליים מוסיפים information rows.
• Barcode - QR / PDF417 / Aztec / Code 128, עם הערך המקודד וטקסט חלופי לפי הצורך.

Back of Pass

הצד האחורי מוצג כשמקישים כדי להפוך את הכרטיס. הוסיפו כמה שורות שתרצו ו-גררו ושחררו (drag & drop) כדי לשנות את הסדר. כל שורה היא מאחד משני סוגים:

• Link - Title, Display text ו-URL, שמוצגים כקישור לחיץ בצד האחורי של הכרטיס (למשל קישור "Manage account" או "View order").
• Text field - Title ו־value (למשל תנאים, תאריך הצטרפות או שעות תמיכה).

כל השדות בצד האחורי תומכים בטוקנים להתאמה אישית - כולל Display text וה־URL של קישור - כך שהקישור יכול להפנות ליעד ייחודי לכל נמען, למשל https://example.com/orders/{{ user.custom.orderId }}.

Features

יכולות ברמת הכרטיס שאינן מופיעות כשדות על הכרטיס.

Pass Expiry - הפעילו כדי לבטל אוטומטית את הכרטיס לאחר תאריך ושעה שתבחרו. המערכת מפרשת את השעה לפי אזור הזמן של סביבת העבודה.

אזהרה

כרטיסים שפגו מושבתים ואי אפשר להפעיל אותם מחדש. כדי לתת לאיש קשר כרטיס פעיל שוב יש להפיץ כרטיס חדש.

App Deep Links - מאפשרים לכרטיס לפתוח את האפליקציה שלכם מתוך הארנק.

• Apple - App Store ID וכן Launch URL. ה-Launch URL משמש רק כאשר מוגדר App Store ID.
• Google - Android Package Name ו-Web App URL.

אלה יכולות מובנות של הכרטיס: אפליקציית הארנק מציגה את הקישור, והקישור העמוק מטופל במכשיר עצמו.

Location-Based Messages - מציגים הודעה על מסך הנעילה כשאיש הקשר נמצא ברדיוס של כ-100 מטר ממיקום. הוסיפו נקודה אחת או יותר, כל אחת עם latitude, longitude ו־lock screen message. זו יכולת מובנית במכשיר ואינה דורשת התראת Push.

iPhone בלבד

ההודעה על מסך הנעילה היא יכולת של Apple Wallet (אייפון) בלבד. Google Wallet שומר את המיקום אך אינו יכול להציג הודעה מותאמת, והצגתה ב־Android אינה מובטחת - לגידור גאוגרפי אמין ב־Android השתמשו בהתראת Push שמופעלת לפי מיקום.

הערה

Linked Passes (איגוד כרטיסים קשורים כך שיותקנו יחד) ו-iBeacon (הודעת מסך נעילה ליד משואת Bluetooth) זמינים דרך Contact Support.

3. הוספת קישור "Add to Wallet" להודעה

אין "הודעת ארנק" נפרדת - מטמיעים את הקישור במקום שבו עורכים את ההודעה.

אימייל ו-In‑App (בלוק drag‑and‑drop)

בעורך האימייל או ה-in‑app, גררו את בלוק ה-Add to Wallet מחלונית ה-Blocks אל העיצוב. בחרו אותו ובחרו את ה־Pass template ואת ה־Platform בחלונית Settings מימין. גלגל השיניים שעל משטח העריכה פותח את Configure pass…, שם אפשר להגדיר Source / tracking label ו־per-field value overrides, לצד תצוגה מקדימה של הכרטיס שמתעדכנת בזמן אמת.

SMS ו-WhatsApp (Personalization)

הודעות SMS ו-WhatsApp הן טקסט חופשי, לכן פתחו + Personalize ובחרו Add to Wallet. בחרו תבנית, פלטפורמה, תווית מקור לפי הצורך וערכים חלופיים לשדות - תצוגה מקדימה שמתעדכנת בזמן אמת תציג את הכרטיס. הפעולה מוסיפה טוקן שהופך בזמן השליחה לקישור התקנה לכל נמען (הקישור מתקצר ל־/s/… כדי לא לחרוג ממכסת המקטעים של ה־SMS).

אפשרויות פלטפורמה

• Apple Wallet - קישור ל-Apple בלבד.
• Google Wallet - קישור ל-Google בלבד.
• Hybrid (auto-detect) - מומלץ; הקישור מזהה את המכשיר (iOS → Apple, Android → Google), ובמחשב שולחני או במכשיר לא מזוהה מציג דף נחיתה ממותג.

4. דף הנחיתה האוניברסלי

קישורי Hybrid שנפתחים במחשב שולחני או במכשיר לא מזוהה מציגים דף נחיתה ממותג עם כפתורי Add to Apple Wallet ו-Save to Google Wallet. כברירת מחדל, המיתוג נלקח מתבנית הכרטיס. ניתן להתאים אותו לכל סביבת עבודה תחת Settings → Wallet Passes → Install landing page (כותרת, טקסט משנה, לוגו, צבעי הדגשה ורקע).

5. ערכים חלופיים לשדות ותוויות מקור

גם בלוק העורך וגם בורר ה-Personalization מאפשרים:

• קביעת ערכים חלופיים בשדות לשליחה מסוימת (למשל יתרת מבצע חד‑פעמית) ללא עריכת התבנית המשותפת. ערך חלופי ריק משאיר את ברירת המחדל של התבנית.
• הגדרת Source / tracking label (למשל summer_promo). כאשר היא מוגדרת, היא מחליפה את השיוך האוטומטי לקמפיין או למסע עבור אותו קישור בדוחות.

כששולחים מקמפיין או ממסע ללא תווית ידנית, הכרטיס משויך אוטומטית לאותו קמפיין או מסע.

6. עדכון כרטיס בתוך מסע

ב-Journey Builder, צומת Update Wallet Pass מפיק מחדש את הכרטיס של איש הקשר לפי התבנית ודוחף את העדכון למכשיר שלו - למשל, "לאחר רכישה, רעננו את יתרת הנקודות." הצומת אינו שולח הודעה שיווקית, ולכן אינו כפוף להסכמה או לשעות שקט, אך כרטיסו של איש קשר שנחסם או נמחק מבוטל במקום להתעדכן.

עריכת תבנית לאחר הנפקת כרטיסים: נמענים חדשים - וכל מי שעדיין לא הוסיף את הכרטיס - יקבלו אוטומטית את התבנית הנוכחית בפעם הבאה שהקישור נפתח. מי שכבר הוסיף את הכרטיס לארנק יתעדכן רק כששולחים עדכון (צומת Update Wallet Pass) - עריכת תבנית לעולם אינה משכתבת אוטומטית כרטיסים שכבר נמצאים בטלפונים של המשתמשים.

7. מעקב וניתוח פעילות Wallet

כל פעולה בכרטיס ארנק נרשמת בציר הזמן של איש הקשר וזמינה לבניית סגמנטים ולטריגרים של מסע:

אירוע	מתי
pass.issued	הונפק כרטיס לאיש הקשר
pass.downloaded	קישור ההתקנה נפתח
pass.installed	הכרטיס נוסף לארנק במכשיר
pass.updated / pass.update_pushed	הכרטיס עודכן והעדכון נשלח למכשירים
pass.removed	הכרטיס הוסר מהארנק
pass.scanned	הברקוד נסרק/מומש
pass.voided	הכרטיס בוטל

פתחו איש קשר ועברו ללשונית Wallet כדי לראות את הכרטיסים שהונפקו לו, הסטטוס וההיסטוריה. לדיווח מצטבר, עברו אל Analytics → Wallet Analytics: משפך אימוץ (issued → downloaded → scanned) עם שיעורי התקנה/סריקה/שימור, מפולח לפי source, platform או template.

חיווי התקנה: Apple מול Google

אירוע pass.installed נרשם ב-Apple כשהמכשיר רושם את הכרטיס, וב-Google דרך קריאת ה-callback לשמירה או למחיקה ב-Wallet. הוסיפו תווית source לקישורים כדי להשוות ערוצים במשפך.

בניית סגמנטים לפי פעילות Wallet

בנו סגמנטים לפי אירועי כרטיסי ארנק עם מסנן ה-event הרגיל - למשל "ביצע pass.installed כאשר platform = apple", או "ביצע pass.scanned ‎≥ 2 ב-30 הימים האחרונים". ניתן לסנן לפי מאפייני אירוע כגון platform, passTemplateId ו-source. (אירוע כרטיס ארנק מופיע בבורר לאחר שנצפה לפחות פעם אחת.)

שאלות נפוצות - מתי נוצר כרטיס חדש?

האם כל קמפיין יוצר כרטיס חדש? לא. כרטיס מזוהה לפי איש קשר + תבנית (לכל פלטפורמה), לא לפי הקמפיין. השליחה הראשונה מנפיקה את הכרטיס; כל שליחה נוספת של אותה תבנית לאותו איש קשר משתמשת בו מחדש.

אם אשלח תזכורת, האם איש הקשר יקבל שני כרטיסים? לא - התזכורת משתמשת באותו כרטיס ובאותו קישור "Add to Wallet". הוספה חוזרת רק מרעננת את הכרטיס האחד שכבר בארנק.

מה אם אשלח את אותו הכרטיס ב-SMS ובאימייל? עדיין כרטיס אחד - שני הקישורים מובילים לאותו כרטיס עבור אותו איש קשר.

איך נותנים לאיש קשר שני כרטיסים שונים? יוצרים שתי תבניות. תבנית אחת = סוג כרטיס אחד = כרטיס חי אחד לכל איש קשר.

ערכתי את התבנית - למה כרטיס שכבר הונפק לא השתנה? כרטיס שכבר נמצא בטלפון מתעדכן רק דרך צומת Update Wallet Pass (או הוספה מחדש). כרטיסים שעדיין לא נוספו מקבלים את השינוי אוטומטית - ראו "עריכת תבנית לאחר הנפקת כרטיסים" למעלה.

הערות

• הכרטיס עצמו אינו מכיל קישור לביטול הרשמה - הסרת כרטיס היא הפעולה המובנית "remove from Wallet" המובנית בארנק, שמתעדת pass.removed.
• כרטיס אחד לכל איש קשר + תבנית. לאיש קשר יש כרטיס חי יחיד לכל תבנית; תזכורות, שליחות חוזרות ואותו כרטיס ב-SMS ובאימייל משתמשים בו מחדש, בלי ליצור עותק כפול. הקמפיין או המסע נרשמים לצורכי ייחוס בלבד ואינם חלק מזהות הכרטיס. לכרטיס שני ושונה - השתמשו בתבנית אחרת.
• בקשת מחיקת נתונים (DSR) מבטלת את כרטיסי איש הקשר ומוחקת את קובצי הכרטיס השמורים.