הרשמה של משתמשים למועדון לקוחות ושדרוגים של כרטיסים

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

הטמעה של התכונה הזו היא תנאי מוקדם להמרת כרטיסים 'סטטיים' שנוספו על ידי משתמשים לכרטיסים 'דינמיים' שמקושרים ל-API. במדריך הזה מוסבר על היתרונות של מועדון לקוחות ועל השלבים שצריך לבצע כדי לאפשר הרשמה למועדון, כניסה לחשבון ושדרוג כרטיס חבר.

סקירה כללית

כדי להתחיל, צריך לוודא שהגדרתם בעבר את הפרויקט ושיש לכם גישה ל-Google Wallet API.

כדי להטמיע את התכונה, צריך לבצע את ארבעת השלבים הבאים:

  1. הגדרת כיתת בדיקה: מגדירים את Google Wallet לבדיקת תהליכי העבודה.
  2. פיתוח דפים: אפשר ליצור דפי הרשמה או כניסה באמצעות ארנק Google SharedDataType.
  3. הטמעה של שליחה חזרה: שליחת כרטיס מועדון הלקוחות ל-Google Wallet אחרי הפעולה.
  4. שליחת בקשה לאימות: שולחים את הבקשה לבדיקה ומבקשים להפעיל את השדרוג.

למה כדאי להטמיע הרשמה למועדון?

כדי להבין את הערך של השילוב הזה, חשוב להבחין בין שני סוגי הכרטיסים שקיימים ב-Google Wallet: L1 (נוספו על ידי המשתמש) ו-L2 (הונפקו על ידי שותף).

ההבדל בין L1 ל-L2

תכונה כרטיס L1 (משתמש הוסיף) כרטיס L2 (הונפק על ידי שותף)
מקור נוצר כשמשתמש סורק כרטיס פיזי באופן ידני או מקליד מספר. נוצר ונשלח באמצעות Wallet API אחרי שהמשתמש נרשם או נכנס באמצעות התהליך שלכם.
בקרה סטטי. לשותף אין גישה לכרטיס הזה או שליטה בו. דינמיות לשותף יש שליטה מלאה באמצעות ה-API.
פונקציונליות תמונה סטטית של ברקוד. לא ניתן לעדכן. אפשר לעדכן את יתרת הנקודות, את סטטוס המועדון, להציג מבצעים בהתאמה אישית ולקבל התראות.

נתיבי השדרוג: 'הגשר' לתוכנית שלכם

כשמפתחים את תהליך ההצטרפות למועדון הלקוחות (היעד), מאפשרים ל-Google ליצור 'גשר' שמשדרג את המשתמשים מכרטיסים סטטיים ברמה 1 לכרטיסים הרשמיים ברמה 2. יש שני טריגרים עיקריים לשדרוג:

  1. שדרוגים של כרטיסים מ-L1 ל-L2: אם משתמש הוסיף בעבר את הכרטיס שלכם באופן ידני (L1), מערכת Google Wallet יכולה להציע לו לעבור לתהליך הכניסה החדש כדי לשדרג לכרטיס הרשמי והדינמי (L2).
  2. שדרוגים של כרטיסים שיובאו מ-Gmail: אם מערכת Google Wallet מזהה כרטיס מועדון לקוחות באמצעות Gmail של משתמש, היא יכולה להציע למשתמש להיכנס לתהליך שלכם ולאמת את עצמו כדי לקבל את הכרטיס הרשמי ברמה 2.

שלב 1: הגדרת כרטיס בדיקה ב-Google Wallet

מגדירים את כתובות ה-URL להרשמה ולכניסה, את הלוגו של התוכנית ואת שדות המשתמש שנבחרו. לאחר מכן, משתמשים בשדות המקוננים discoverableProgram בתוך loyaltyclass כדי להגדיר את הערכים המתאימים.

מגדירים את הערכים ב-discoverableProgram כדי ליצור טיוטה של מועדון הלקוחות עם אפשרות להצטרפות או להתחברות. כדי לוודא שהבודקים יכולים לראות את זה, צריך לוודא שיש להם גישה למסוף Google Pay ולמסוף Wallet. לפרטים על שיתוף הגישה למסוף Google Pay ול-Wallet עם אנשים אחרים, אפשר לעיין במאמר מידע על הדף 'משתמשים'.

כדי להשלים את האימות של הפונקציונליות של ההטמעה במהלך תהליך הפיתוח, אפשר לפנות אלינו באמצעות הווידג'ט ליצירת קשר עם התמיכה במסוף Google Pay ו-Wallet. במסוף, בוחרים באפשרות Google Wallet API בנושא, ואז בוחרים באפשרות Loyalty sign-in/enrollment בנושא המשנה.

שלב 2: פיתוח דפי הרשמה וכניסה

כשמשתמש בוחר להיכנס למועדון הלקוחות שלכם או להירשם אליו, הוא מועבר לדף מותאם אישית באתר שלכם כדי להשלים את תהליך ההרשמה או הכניסה. אם המשתמש יבחר להירשם, Google Wallet תבקש ממנו לאשר את שיתוף נתוני המשתמש איתכם.

עליך לספק אחד משני הדפים האלה, או את שניהם, שמאפשרים למשתמשים לבצע את הפעולות הבאות:

  1. כתובת URL לכניסה שבה משתמש יכול להיכנס לחשבון קיים.
  2. כתובת URL להרשמה שבה משתמש יכול ליצור חשבון חדש.

דפי הכניסה וההרשמה צריכים לעמוד בדרישות הבאות:

  • חוויית המשתמש צריכה להיות ידידותית לניידים.
  • לצמצם את מספר שדות החובה בתהליך ההרשמה.
  • לאפשר למשתמש להשלים את הכניסה או ההרשמה בדף אחד.
  • כדי להבטיח שנתוני המשתמשים מועברים בצורה מאובטחת, צריך להשתמש בהצפנה HTTPS עם אישור תקף.
  • חשוב לוודא שזמן הפעילות של דפי הכניסה וההרשמה הוא לפחות 99.9%.

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

  • בעזרת נתוני המשתמש שמופיעים בSharedDataType, אפשר ליצור חשבון ולשלוח מיד את כרטיס מועדון הלקוחות.
  • לאחר מכן אפשר לשלוח למשתמש סיסמה חד-פעמית או קישור להגדרת הסיסמה ופרטים אופציונליים של החשבון.
  • כך קטן הסיכוי שהמשתמשים ינטשו את תהליך ההרשמה, כי כל שלב נוסף עלול להוביל לנטישה נוספת.

כשמוצג דף הכניסה או ההרשמה, Google Wallet יוצרת Android WebView ומתבצעת בקשה לכתובת ה-URL שסיפקתם.POST נתוני המשתמשים מסופקים בפרמטר SharedDataType שכלול בבקשה POST עם ערך Content-Type של application/x-www-form-urlencoded וקידוד UTF-8. הערך של הפרמטר SharedDataType הוא אובייקט JSON בקידוד Base64.

בהתאם לפעולה שהמשתמש בחר ולשדות שציינתם לבקש מהמשתמש, אובייקט ה-JSON עשוי להכיל את השדות הבאים.

שדה צירוף
אימייל ✓
firstName ✓
lastName ✓
addressLine [1-3]‎ ✓
עיר ✓
הסמוי הסופי ✓
מיקוד ✓
country ✓
טלפון ✓

בדוגמה הבאה מוצג אובייקט JSON מפוענח שמופיע ב-SharedDataType.

משאב

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

שלב 3: הטמעה של העברה מיידית של נתונים בחזרה אל Google Wallet

אחרי שהמשתמש מאומת (מתבצעת כניסה) או אחרי יצירת החשבון (ההרשמה), הדף צריך להעביר באופן מיידי את כרטיס מועדון הלקוחות של המשתמש בחזרה ל-Google Wallet.

אפשר להעביר את כרטיס מועדון הלקוחות בחזרה ל-Google Wallet על ידי הפניה לקישור שכולל את המבנה הבא.

https://pay.google.com/gp/v/save/{jwt_generated}

האורך הבטוח של כתובת URL הוא 2,000 תווים. הקישורים לא צריכים לחרוג מהמגבלה הזו. אובייקטים שמקודדים ב-JWT צריכים להיות קטנים, ולהכיל רק נתונים שספציפיים למשתמש. מומלץ לשמור את רוב הנתונים במחלקה של האובייקט, וליצור אותה לפני יצירת ה-JWT. אם מדובר באובייקטים גדולים יותר שלא חורגים מהמגבלה, כדאי ליצור קודם את האובייקט ב-Google Wallet API ולשלוח רק את מזהה האובייקט ב-JWT.

תהליך תקשורת אופייני

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

תהליכי כניסה להרשמה

שלב 4: שולחים בקשת אימות והפעלה

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

  1. עוברים אל המסוף העסקי של Google Pay ו-Wallet.
  2. משתמשים בווידג'ט פנייה לתמיכה.
  3. מודיעים לצוות התמיכה שסיימתם את השילוב של ההרשמה למועדון הלקוחות.

אחרי שנבדוק את ההטמעה שלכם ונוודא שהיא פועלת בצורה תקינה בשילוב עם אפליקציית Google Wallet, נשיק באופן פומבי את התכונה 'הצטרפות למועדון לקוחות או כניסה לחשבון' במועדון הלקוחות שלכם.

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

שאלות נפוצות

  • האם יש דרישות לגבי התמונות שבהן אני משתמש במועדון הלקוחות שלי? כן, התמונות צריכות להיות מאוחסנות בHTTPS מיקום, אחרת הן לא יוצגו ב-Google Wallet.

  • האם יש כלים שמפשטים את ההטמעה וניפוי הבאגים של JWT? כן, פלטפורמות כמו www.jwt.io מאפשרות לכם לפענח ולנפות באגים באסימונים במהלך תהליך הפיתוח, וכך לאמת את התוכן שאתם שולחים. חשוב לדעת: ל-Google אין קשר לאף אחד מהצדדים השלישיים האלה, והיא לא ממליצה על אף אחד מהם באופן ספציפי.

  • איך מטפלים בצורה נכונה בנתוני SharedDataType שמקודדים ב-Base64? חשוב לוודא שאתם משתמשים בקידוד UTF-8 לאורך כל התהליך. מחרוזת ה-JSON מקודדת קודם בפורמט UTF-8 ואחר כך מקודדת באמצעות android.util.Base64 עם האפשרויות NO_WRAP ו-URL_SAFE. הערך הזה תואם ל-RFC 3548, סעיף 4.