בהשלמה האוטומטית של Google, המערכת משתמשת באסימוני סשן כדי לקבץ את שלבי השאילתה והבחירה של שלבי החיפוש בהשלמה האוטומטית של משתמש בסשן נפרד למטרות חיוב. הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומבצע קריאה לפרטי מקום. בכל פעילות באתר יכולות להיות מספר שאילתות להשלמה אוטומטית, ולאחר מכן בחירת מקום אחת. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להשתייך לאותו פרויקט במסוף Google Cloud. לאחר סיום הסשן, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן באתר. אם הפרמטר sessiontoken מושמט, או אם משתמשים שוב באסימון סשן, נחייב את הסשן כאילו לא סופק אסימון
לביקור (כל בקשה
מחויבת בנפרד).
מומלץ לפעול לפי ההנחיות הבאות:
- יש להשתמש באסימוני סשנים בכל הסשנים של ההשלמה האוטומטית.
- יוצרים אסימון חדש לכל סשן.
- צריך לוודא שמפתחות ה-API שמשמשים לכל הבקשות להשלמה אוטומטית של מקום ולפרטי מקום בסשן שייכים לאותו פרויקט במסוף Google Cloud.
- חשוב להקפיד להעביר אסימון ייחודי לכל סשן חדש. אם משתמשים באותו אסימון ליותר מסשן אחד באתר, נחייב את כל הבקשות בנפרד.
יש אפשרות להשמיט את אסימון הסשן של ההשלמה האוטומטית מבקשה. אם אסימון הסשן יושמט, כל בקשה תחויב בנפרד, ובעקבות זאת יופעל מק"ט השלמה אוטומטית – לכל בקשה. אם אתם עושים שימוש חוזר באסימון סשן, הסשן נחשב לא חוקי ויתבצע חיוב על הבקשות כאילו לא סופק אסימון סשן.
דוגמה
בזמן שהמשתמש מקליד שאילתה, הבקשה להשלמה אוטומטית מופעלת כל כמה הקשות (לא לפי תו) ומוחזרה רשימה של תוצאות אפשריות. כשמשתמש מבצע בחירה מרשימת התוצאות, הבחירה נספרת כבקשה, וכל הבקשות שמתבצעות במהלך החיפוש מקובצות ונספרות כבקשה יחידה. אם המשתמשים יבחרו מקום, שאילתת החיפוש תהיה ללא חיוב והחיוב יתבצע רק על הבקשה לנתוני המקום. אם המשתמש לא יבצע בחירה תוך מספר דקות מתחילת הסשן, נחייב רק את שאילתת החיפוש.
עכשיו נבחן את רצף האירועים מנקודת המבט של האפליקציה.
- משתמש מתחיל להקליד שאילתה כדי לחפש "פריז, צרפת".
- אחרי זיהוי קלט של משתמשים, האפליקציה יוצרת אסימון סשן חדש, 'אסימון A'.
- בזמן שהמשתמשים מקלידים, ה-API שולח בקשה להשלמה אוטומטית כל כמה
תווים, ומציג רשימה חדשה של תוצאות פוטנציאליות לכל אחד מהם:
"P"
"Par"
"Paris",
"Paris, Fr"
- כשהמשתמש מבצע בחירה:
- כל הבקשות שמתקבלות מהשאילתה מקובצות ומתווספות לסשן שמיוצג על ידי 'אסימון A', כבקשה יחידה.
- הבחירה של המשתמש נספרת כבקשה של פרטי מקום ומתווספת לסשן שמיוצג על ידי "אסימון A".
- הסשן הסתיים ו'אסימון A' נמחק מהאפליקציה.
אפשר לקרוא מידע נוסף על אופן החיוב של בקשות להשלמה אוטומטית במאמר שימוש וחיוב.
יצירת אסימוני סשן
כדי ליצור אסימון סשן, צריך לבצע קריאה ל-GMSAutocompleteSessionToken.init().