מדריך להטמעה של עסקאות עשירות

סקירה כללית

אתר iOS ב-API

הפלטפורמה של מפות Google זמינה לאינטרנט (JS, TS), Android ו-iOS. וגם מציע ממשקי API של שירותי אינטרנט לקבלת מידע על מקומות, מסלולים, ומרחקים. הדוגמאות במדריך הזה כתובות לפלטפורמה אחת, אבל קישורים למסמכים זמינים להטמעה בפלטפורמות אחרות.

למשתמשים קשה בדרך כלל להבין הצהרות על עסקאות, באמצעות קיצורים כמו ACMEHCORP במקום שמות מוכרים כמו Acme Houseware, מה שעלול להוביל לעלייה במספר השיחות עם תמיכת הלקוחות ובמחלוקות יקרות. התכונה 'עסקאות משופרות' מפשטת את העסקאות האלה והופכת אותן לאינטואיטיביות לספק את השם המלא ואת הקטגוריה של העסק של המוכר, תמונה של של החנות, הכתובת והמיקום שלו במפה, פרטים מלאים ליצירת קשר ועוד. הזה מסייעת להגביר את שביעות הרצון והשקיפות של המשתמשים, והוא עלול גם להוביל לירידה שיחות לתמיכת לקוחות, הגדלת ה-NPS והגדלת זמן השימוש באפליקציה.

עסקאות עשירות – מדריך ההטמעה והטיפים להתאמה אישית שאנחנו מספקים בנושא הזה - הוא מה שמומלץ כשילוב האופטימלי של ממשקי API של הפלטפורמה של מפות Google ליצירת משתמשים מעולים בהיסטוריית עסקאות לחוויות שונות. במדריך ההטמעה הזה נסביר איך להתאים מיקום עם מוכר ספציפי ולהראות את המידע המפורט שלו.

מסכים לדוגמה של טרנזקציות
מסכים לדוגמה של טרנזקציות מוחזקות (יש ללחוץ להגדלה)

הפעלת ממשקי API

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

למידע נוסף על ההגדרה, ראה קבלת בפלטפורמה של מפות Google.

הקטעים של מדריך ההטמעה

בהמשך מפורטים היישומים וההתאמות האישיות שנעסוק בהם בנושא זה.

  • סמל סימן הווי הוא שלב מרכזי בהטמעה.
  • סמל הכוכב הוא התאמה אישית אופציונלית אבל מומלצת כדי לשפר את הפתרון.
התאמה של מוכרים לפלטפורמה של מפות Google שיוך של מוכר בהיסטוריית העסקאות למקום שנמצא ב- הפלטפורמה של מפות Google.
הצגה של פרטי מוֹכר להציג עסקאות עשירות בנתונים שמציגות מידע שימושי על כדי שהמשתמשים יוכלו לזהות במהירות את העסקה.
הוספת מפה של מיקום המוכר מוסיפים מפה של מיקום המוכר.

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

בדוגמה הזו: Places API

בתרשים הבא מוצג האופן שבו האפליקציה תואמת לעסקאות של מוכרים כדי להחזיר תוצאה באמצעות פרטי המקום ממסד נתונים קיים של מוֹכרים או באמצעות בקשה של 'חיפוש מקום':

מטריצת זרימה למוכר
מטריצת זרימה למוכר (יש ללחוץ כדי להגדיל)

קבלת מזהי מקומות בפלטפורמה של מפות Google

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

כדי לקבל את מזהה המקום של עסק, צריך לשלוח בקשה נקודת הקצה /findplacefromtext ב- Places API ולבקש רק את השדה place_id כדי לחייב את הבקשה ללא חיוב חיפוש מקום – תעודה מזהה בלבד שיחה. אם למוכר יש כמה מיקומים, צריך להשתמש בשם המוכר יחד עם שם העיר או הרחוב. איכות הנתונים שמחזירים הקריאה משתנה, לכן צריך לוודא שהתוצאות הוחזרו תואמים בפועל למוכר הרצוי.

הנה דוגמה לבקשת מזהה המקום של משרד Google בטייוואן באמצעות שם המוֹכר והעיר:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

חשוב להקפיד שכתובת ה-URL מקודדת פרמטר הקלט בבקשת ה-API.

אחסון מזהים של מקומות

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

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

במקרה שפרטי המקום שמוצגים לא תואמים למוכר שבו אם העסקה בוצעה, מומלץ לאפשר למשתמשים לספק משוב על איכות ההתאמה של המוכר.

מוצגים פרטי המוכר

בדוגמה הזו: Places API זמין גם: Places SDK ל-Android | Places SDK ל-iOS | ספריית מקומות, Maps JavaScript API

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

מסך של פרטי מוכר לדוגמה
מסך לדוגמה של פרטי המוכר (צריך ללחוץ כדי להגדיל)

כדי לבקש פרטי מקום, צריך את מזהה המקום של כל אחד מהמיקומים. איך מקבלים מזהי מקומות כדי לאחזר את מזהה המקום של המיקום שלכם.

הבקשה הבאה של פרטי מקום מחזירה את הכתובת, הקואורדינטות, האתר, מספר טלפון, דירוג ושעות פעילות בפלט json של Google Taipei 101 מזהה מקום:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

הוספת מפה של מיקום המוכר

בדוגמה הזו: Geocoding API | API סטטי של מפות Google זמין גם: Android | iOS

איך יודעים מה המיקום של המוכר

ה-API הסטטי של מפות Google מקבל כתובת או קואורדינטות סמן. אם ברשומת המוכר כבר יש כתובת, אפשר לדלג קדימה אל הקטע הבא, אבל מומלץ להשתמש בקואורדינטות על פני כתובות במפה, המדויק.

אם במסד הנתונים של המוכר יש כתובות של רחובות, אבל לא קואורדינטות גיאוגרפיות. ועדיין לא ביקשת את פרטי המקום, אפשר להשתמש ב-Geocoding API כדי להמיר כתובות קואורדינטות של קו רוחב/אורך בצד השרת, שמירת הקואורדינטות ורענון הקואורדינטות לפחות פעם אחת בכל 30 יום.

לפניכם דוגמה לשימוש ב-Geocoding API כדי לקבל קו הרוחב וקו האורך של מזהה המקום במשרד של Google בטאיפיי:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

הוספת סמן של מיקום המוכר במפה

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

באינטרנט לנייד ולמחשב, יש ליצור כתובת URL של Maps Static API עם סמן יחיד קו הרוחב/קו האורך או הכתובת של המוכר. אפשר להשתמש API סטטי של מפות Google באמצעות קריאה לשירות אינטרנט, שייצור גרסת תמונה של מפה בהינתן הפרמטרים שאתם מציינים. בנייד, אפשר לדלג אל הבא הוספת מפה בקטע של האפליקציה לנייד.

הקריאה הבאה מציגה מפת דרכים, בגודל של 640x480 פיקסלים, במרכז סמן במשרד Google בטייוואן ברמת הזום המוגדרת כברירת מחדל. כמו כן, סמן אדום למיקום המשלוח וסגנון מפה מבוסס-ענן:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

המידע הזה מחולק לקטעים הבאים:

כתובת ה-URL של ה-API https://maps.googleapis.com/maps/api/staticmap?
גודל התמונה גודל=640x480
סמנים של מיקום המוכר (באמצעות קידוד של כתובות URL) סמנים=color:red%7C25.033976%2C121.5645389
סגנון מפה מבוסס-ענן map_id=b224095f76859890
מפתח API key=YOUR_API_KEY
חתימה דיגיטלית (כך חותמים על בקשה דיגיטלית) signature=BASE64_SIGNATURE
פרמטר של ערוץ פתרונות (ראו את תיעוד פרמטרים) solution_channel=GMP_guides_enrichedtransactions_v1_a

זו תהיה התמונה שמוצגת כאן:

תמונת מפה סטטית של המשרד בטייפה של Google

ניתן גם להשתמש בכתובת בתור מיקום הסמן:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

אפשרויות נוספות של פרמטרים אפשר למצוא מסמכי תיעוד של ה-API הסטטי של מפות Google.

הוספת מפה לאפליקציה לנייד

אם משתמשים ב-SDK של מפות עבור Android או SDK של מפות ל-iOS, ניתן למקם סמן באמצעות מהמידע בקטע פרטי מקום.

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