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

סקירה

web 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

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

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

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

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

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

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

הנה דוגמה לבקשת מזהה המקום של משרד 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.

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

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

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

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

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

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

הבקשה הבאה של Place Details מחזירה את הכתובת, הקואורדינטות, האתר, מספר הטלפון, הדירוג ושעות הפעילות בפלט 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 | Maps Static API זמין גם: 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
חתימה דיגיטלית (כך חותמים על בקשה דיגיטלית) חתימה=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

אפשרויות נוספות של פרמטרים מפורטות במאמרי העזרה של Maps Static API.

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

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

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