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

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

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

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

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

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

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

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

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

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

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

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

הסשן הזה מסתיים באמצעות בקשה אחת ל-Place Details‏ (New) שבה מבקשים את כל השדות שמוגדרים על ידי SKU: Place Details (Location Only).

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

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

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

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

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

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

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

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

השלמה אוטומטית של פרטי התשלום והמשלוח

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

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

  • כל הבקשות מסוג 'השלמה אוטומטית (חדשה)' מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
  • בקשה אחת עם SKU: Address Validation Preferred:
    • חיוב בסך 25 $לכל 1,000 בקשות, עד 100,000 בקשות
    • חיוב בסך 80 ש"ח לכל 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.