התכונה 'הרשמה לכרטיס מתנה (כניסה)' מאפשרת למשתמשים לחפש של כרטיס המתנה ולהוסיף אותו ל-Google Wallet. המשתמשים יופנו לאתר הידידותי לנייד כדי להשלים את לאחר מכן הם יוכלו להוסיף את הכרטיס ל-Google Wallet.
המדריך הזה כולל סקירה כללית של שלבי ההטמעה הנדרשים כדי להפעיל את תוכנית כרטיסי המתנה עבור התכונה הזו.
סקירה כללית
כדי להתחיל, חשוב לוודא שהגדרתם את הפרויקט בעבר ושיש לכם גישה אל ממשק ה-API של Google Wallet.
כדי להטמיע את תכונת הכניסה, צריך לבצע את ארבעת השלבים הבאים עבור תוכנית כרטיסי המתנה:
- אפשר להגדיר כיתת בדיקה ב-Google Wallet כדי לבדוק את תהליך הכניסה.
- פיתוח דפי כניסה המשתמשים ב-
SharedDataTypeשל Google Wallet. - ישם את דחיית כרטיס המתנה ב-Google Wallet לאחר הכניסה.
- שולחים בקשה לאימות והפעלה.
הגדרת כיתת בדיקה ב-Google Wallet
מגדירים את כתובת ה-URL לכניסה ואת הלוגו של התוכנית. לאחר מכן:
להשתמש ב-discoverableProgram השדות המקוננים שבשדה
giftcardclass כדי להגדיר את
הערכים המתאימים.
צריך להגדיר את הערכים ב-discoverableProgram כדי ליצור גרסת טיוטה של
לתוכנית כרטיסי מתנה שמופעלת על ידי כניסה לחשבון. כדי לוודא שהמידע הזה יהיה גלוי לבודקים, צריך לאמת
לבודקים יש גישה למסוף Google Pay ולמסוף של Wallet. לקבלת פרטים על אופן השיתוף של
גישה של אנשים אחרים למסוף Google Pay ול-Wallet. למידע נוסף
מידע על הדף 'משתמשים'
כדי להשלים את האימות של פונקציונליות ההטמעה במהלך הפיתוח יש לפנות אלינו באמצעות הווידג'ט ליצירת קשר עם התמיכה במסוף Google Pay ובמסוף Wallet. בזמן השהייה במסוף, בוחרים בנושא Google Wallet ואז בוחרים באפשרות כניסה באמצעות כרטיס מתנה. נושא המשנה.
פיתוח דף כניסה שמשתמש בנתוני משתמשים של Google Wallet
כשמשתמש בוחר להוסיף כרטיס מתנה, הם מופנים לדף מותאם אישית באתר שלך תהליך הכניסה לחשבון.
עליכם לספק כתובת URL לכניסה שאליה משתמשים יכולים להיכנס לחשבון קיים.
דף הכניסה צריך לעמוד בדרישות הבאות:
- מומלץ לספק חוויית משתמש שמתאימה לניידים.
- המשתמש יכול להשלים את הכניסה בדף יחיד.
- צריך להשתמש בהצפנה של
HTTPSעם אישור חוקי כדי לוודא שנתוני המשתמש משודרת באופן מאובטח. - מוודאים שדף הכניסה פעיל לפחות ב-99.9%.
במהלך הצגת דף הכניסה, אפליקציית Google Wallet תיצור
WebView של Android ובקשת POST נשלחת אל
כתובת URL. נתוני המשתמשים סופקו בפרמטר SharedDataType
שכלול בבקשת POST באמצעות
סוג תוכן application/x-www-form-urlencoded וכן
קידוד UTF-8. הערך של SharedDataType
הוא אובייקט JSON בקידוד Base64.
יישום דחייה מיידית של כרטיס המתנה ל-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.