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

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

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

סקירה כללית

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

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

  1. אפשר להגדיר כיתת בדיקה ב-Google Wallet כדי לבדוק את תהליכי ההרשמה או הכניסה.
  2. פיתוח דפי הרשמה או כניסה המשתמשים ב-SharedDataType של Google Wallet.
  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 תיצור WebView של Android ובקשת POST נשלחת אל כתובת URL. נתוני המשתמשים סופקו בפרמטר SharedDataType שכלול בבקשת POST באמצעות סוג תוכן application/x-www-form-urlencoded וכן קידוד UTF-8. הערך של SharedDataType הוא אובייקט JSON בקידוד Base64.

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

שדה צירוף
אימייל ✓
firstName ✓
lastName ✓
שורת כתובת [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"
}

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