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

סקירה כללית

אינטרנט 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 כדי לחייב את הבקשה כקריאה ללא תשלום מסוג 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.

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

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

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

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

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

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

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

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

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

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

אם במסד הנתונים של המוכר יש כתובות רחוב אבל אין בו קואורדינטות גיאוגרפיות, ואתם עדיין לא מבקשים פרטי מקום, תוכלו להשתמש ב-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 של API סטטי של מפות Google עם סמן יחיד במיקום או בקו הרוחב/האורך של המוכר. אפשר להשתמש ב-Maps Static API באמצעות קריאה לשירות אינטרנט, שתצור גרסה של תמונה של מפה על סמך הפרמטרים שציינתם. בנייד, אפשר לדלג לקטע הבא הוספת מפה לאפליקציה לנייד.

בקריאה הבאה מוצגת מפת דרכים בגודל 640x480px, שממוקדת בסמן במשרדי 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?
גודל התמונה size=640x480
סמנים של מיקום המוכר (באמצעות קידוד כתובות URL) markers=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

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

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

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

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