השלמה אוטומטית (חדש) ותמחור סשן

בחירת פלטפורמה: Android iOS JavaScript Web Service

Google ממליצה להשתמש בסשנים עם השלמה אוטומטית (חדש). סשנים עוזרים לפשט את התמחור ומספקים מודל תמחור עקבי לשימוש עם השלמה אוטומטית (חדש).

תמחור הסשן מתחיל בבקשה הראשונה מסוג 'השלמה אוטומטית (חדש)' שכוללת אסימון סשן, ממשיך בכל בקשה נוספת מסוג 'השלמה אוטומטית (חדש)', ולאחר מכן מסתיים בבקשה מסוג 'פרטי מקום (חדש)' או 'אימות כתובת' שמשתמשת באסימון הסשן.

אחרי סיום הסשן, כל קריאה להשלמה אוטומטית (חדש), לפרטים של מקום (חדש) או לאימות כתובת שמשתמשת באסימון הסשן שפג תוקפו מחויבת כאילו לא היה אסימון סשן.

על סשנים חלקיים, כלומר סשנים שלא הסתיימו בבקשה לפרטים של מקום (חדש) או באימות כתובת, תחויבו רק על בקשות ההשלמה האוטומטית באמצעות המק"ט SKU: Autocomplete Requests.

שלושת התרחישים הנפוצים ביותר של תמחור הם:

  • השלמה אוטומטית של נתוני מיקום
  • השלמה אוטומטית לצורך גילוי מקומות
  • השלמה אוטומטית בתהליך התשלום ובבחירת אופן המשלוח

השלמה אוטומטית של נתוני מיקום

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

פרטי המיקום יכולים לכלול את הפרטים הבאים של המקום:

  • כתובת
  • מיקום כקואורדינטות של קו רוחב וקו אורך
  • Plus Code
  • סוגים
  • אזור התצוגה

הסשן מסתיים בעקבות בקשה אחת לפרטי מקום (חדש) עם בקשה לשדות שמוגדרים על ידי SKU: פרטי מקום (מיקום בלבד).

לאחר מכן תחויבו באופן הבא:

  • כל בקשה של השלמה אוטומטית (חדשה), עד 12 בקשות לכל היותר, באמצעות SKU: Autocomplete Requests.
    • חיוב בסך 2.83 $לכל 1,000 בקשות, עד 100,000 בקשות
    • חיוב של 2.27 $לכל 1,000 בקשות של עד 500,000 בקשות
  • בקשות להשלמה אוטומטית (חדשות) מס' 13 ואילך שנשלחות במהלך סשן פעיל מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
  • בקשה אחת לקבלת פרטי מקומות באמצעות מק"ט: פרטי מקום (מיקום בלבד):
    • חיוב בסך 5.00 $‎ לכל 1,000 בקשות, עד 100,000 בקשות
    • חיוב בסך 4 $לכל 1,000 בקשות, עד 500,000 בקשות

השלמה אוטומטית לזיהוי מקומות

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

  • אפשרויות נגישות
  • שעות הפתיחה הנוכחיות
  • אפשרויות החניה
  • ביקורות
  • דירוגים

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

לאחר מכן תחויבו באופן הבא:

  • כל הבקשות מסוג Autocomplete (חדש) מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
  • בקשה אחת מסוג SKU: פרטי מקום (מועדף):
    • חיוב בסך 25 $לכל 1,000 בקשות, עד 100,000 בקשות
    • חיוב בסך 80 ש"ח לכל 1,000 בקשות, עד 500,000 בקשות

השלמה אוטומטית בקופה ובשלב הבחירה של אופן המשלוח

Address Validation API הוא שירות שמקבל כתובת. הוא מזהה את רכיבי הכתובת ומאמת אותם. הוא גם מסדיר את הכתובת לצורך משלוח דואר ומוצא את קואורדינטות קו האורך וקו הרוחב הידועות ביותר שלה.

בתרחיש של השלמה אוטומטית לקופה ולמשלוח, מסיימים את הסשן באמצעות בקשה ל-Address Validation API כדי לאמת את הכתובת שנבחרה. לאחר מכן תחויבו באופן הבא:

  • כל הבקשות מסוג Autocomplete (חדש) מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
  • בקשה אחת עם הערך SKU: Address Validation Preferred:
    • חיוב בסך 25.00 $לכל 1,000 בקשות של עד 100,000 בקשות
    • חיוב בסך 20.00 $לכל 1,000 בקשות של עד 500,000 בקשות

דוגמאות לתמחור

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

תרחיש דוגמה לבקשה מק"טים שחויבו מחיר לאלף בקשות
נתוני מיקום
  • 5 בקשות להשלמה אוטומטית (חדש) – חיוב בסך 2.83$ (עד 12 בקשות לסשן)
  • בקשה אחת לפרטים על מקום (חדש) שחויבה בסך 5$
גילוי מקומות
  • 5 בקשות להשלמה אוטומטית (חדש) שחויבו ב-0$
  • בקשה אחת לפרטים של מקום (חדש) בחיוב של 25$
תשלום ומשלוח
  • 5 בקשות להשלמה אוטומטית (חדש)
  • בקשה אחת ל-Address Validation
  • 5 בקשות להשלמה אוטומטית (חדש) חויבו ב-0$
  • בקשה אחת לאימות כתובת מועדף, ב-25$

דוגמה לתמחור ללא סשנים

אם לא משתמשים בסשנים, החיוב מתבצע לפי בקשה להשלמה אוטומטית (חדשה) באמצעות המק"ט Autocomplete Requests (בקשות להשלמה אוטומטית) בסכום של 2.83 $לכל 1,000 בקשות.

תמחור חלופי לסשנים חלקיים או סגורים

אם סשן מסוים לא הושלם, כלומר לא הסתיים בקריאה ל'פרטי המקום' (חדש) או ל'אימות כתובת', הבקשות להשלמה אוטומטית (חדש) חוזרות למודל התמחור לפי בקשה, והחיוב עליהן הוא 2.83$ לכל 1,000 בקשות, כפי שמוגדר ב-SKU: Autocomplete Requests.