הרשמה למועדון הלקוחות של משתמשים

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

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

סקירה כללית

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

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

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

הגדרת שיעור בדיקה ב-Google Wallet

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

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

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

פיתוח דפי הרשמה וכניסה שמשתמשים בנתוני משתמש של Google Wallet

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

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

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

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

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

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

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

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

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

שדה צירוף כניסה
אימייל ✓ ✓
firstName ✓  
lastName ✓  
addressLine [1-3] ✓  
עיר ✓  
state ✓  
מיקוד ✓  
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"
}

יישום דחייה מיידית של כרטיס מועדון הלקוחות ב-Google Wallet

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

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

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

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

זרימת תקשורת טיפוסית

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

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

בקשת אימות והפעלה

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

לאחר בדיקה מלאה של ההטמעה כדי לוודא שהפונקציונליות הנכונה בשילוב עם אפליקציית 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.