חיפוש ]

כיצד להשתמש ב Waze Deep Links

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

הטמעה של Waze באתרים ואפליקציות – Deep Links

Waze תומכת ב API שמאפשר למפתחים לפתוח את אפליקציית Waze (או עמוד אינטרנטי של Waze) באמצעות כתובת URL חיצונית. אותה כתובת URL יכולה להיות נגישה מאפליקציית מובייל אחרת או מעמוד אינטרנטי במובייל.

הבסיס של כתובת ה URL לשימוש עם Waze Deep Links נראה כך:

https://waze.com/ul

או בסופו של דבר, כתובת זו תופיע כקישור סטנדרטי, זה נראה כך:

<a href="https://waze.com/ul">ניווט לעסק</a>

באמצעות כתובת זו אפליקציית Waze יכולה למצוא כתובת, לסמן כתובת על המפה, או להתחיל סשיין ניווט לאותה כתובת וזאת בהתאם לפרמטרים שאתם מעבירים עם אותה כתובת URL.

איך אותם Deep Links עובדים?

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

  • דסקטופ – Waze תפתח עמוד אינטרנטי.
  • מכשיר מובייל (ואפליקציית Waze מותקנת) – אפליקציית Waze תפתח.
  • מכשיר מובייל (ואפליקציית Waze אינה מותקנת) – Waze תפתח עמוד אינטרנטי.

שימוש ב Waze Deep Links

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

https://waze.com/ul?param_name=value[&param_name=value]

הנה דוגמה למספר פעולות שכיחות של Waze Deep Links:

1. ניווט למיקום מסוים – Navigate to Specific Location

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

  • פתחו את Waze Live Map וחפשו את המיקום אליו אתם מעוניינים לנווט.
  • לחצו על אייקון השיתוף המופיע תחת ״המיקום שלך״ (ראו תמונה)
  • במסך שייפתח, לחצו על ״שיתוף הנסיעה שלך״ והעתיקו את כתובת ה URL.

הערה – רמת ה Zoom בה תשתמשו ב Waze Live Map תשתקף בקוד ההטמעה (כתובת ה URL). באפשרותכם לשנות את אותו Zoom באמצעות הפרמטר zoom.

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

ניווט למיקום מסוים - Waze Deep Links

דוגמה

הדוגמה הבאה למשל תמרכז את המפה על Times Square בניו-יורק:

https://www.waze.com/ul?ll=40.75889500%2C-73.98513100&navigate=yes&zoom=17

2. ניווט למיקום מועדף – Navigate to Favorite

ניתן לנווט לכתובות המועדפות הבאות השמורות באפליקציית Waze:

  • עבודה – work
  • בית – home

השתמשו בכתובת ה URL הבאה כדי לנווט למיקום מועדף מאלו שציינו למעלה:

https://waze.com/ul?favorite=favorite&navigate=yes

דוגמה

הנה דוגמה שקובעת ניווט למיקום מועדף (עבודה במקרה זה):

https://waze.com/ul?favorite=work&navigate=yes

3. חיפוש – Search

לחיפוש כתובת השתמשו בסינטקס הבא:

https://waze.com/ul?q=search_terms

שימו לב – הערכים שאתם מעבירים בפרמטרים חייבים להיות URL Encoded. למשל, אתם חייבים להחליף סימני ריווח ב %20.

דוגמה

הדוגמה הבאה תחפש את הכתובת "66 Acacia Avenue":

https://waze.com/ul?q=66%20Acacia%20Avenue

אם אתם מוסיפים פרמטר utm_source (השייך ל-UTM Parameters) בקישור שהטמעתם, Waze יוכלו לשייך את השימוש עם שותפים ספציפיים. אם מתרחשת שגיאה המשפיעה על האינטגרציה, אותו utm_source יאפשר ל-Waze לעדכן את אותו שותף ולספק חוויה טובה יותר.

שאלות נפוצות

שאלות נפוצות על Waze Deep Links:

מה קורה אם אפליקציית Waze לא מותקנת במכשיר של המשתמש?
אם Waze לא מותקנת, הקישור יפתח את אתר Waze בדפדפן במקום את האפליקציה. המשתמש עדיין יוכל לראות את המיקום על המפה ולקבל הנחיות ניווט, אך לא ייהנה מהחוויה המלאה של האפליקציה.
האם אפשר להשתמש ב-Waze Deep Links באתרי דסקטופ?
כן. בדסקטופ הקישור יפתח את עמוד Waze באינטרנט במקום את האפליקציה. המשתמש יוכל לצפות במיקום על המפה ולתכנן מסלול.
האם צריך לבצע URL Encoding לערכים בפרמטרים?
כן. כל הערכים שמועברים בפרמטרים חייבים להיות מקודדים בפורמט URL Encoding. למשל, רווחים צריכים להיות מוחלפים ב-%20.
מה ההבדל בין waze:// לבין https://waze.com/ul?
הכתובת https://waze.com/ul עובדת בכל מכשיר ונופלת בחזרה לאתר Waze אם האפליקציה לא מותקנת. לעומת זאת, הסכמה waze:// עובדת רק אם האפליקציה מותקנת - אם היא לא מותקנת, שום דבר לא יקרה. השתמשו ב-waze:// רק באפליקציות נייטיב שבהן אתם יכולים לבדוק מראש אם Waze מותקנת.
למה כדאי להוסיף utm_source לקישור של Waze?
הוספת utm_source מאפשרת ל-Waze לשייך את השימוש לאינטגרציה שלכם. אם מתרחשת תקלה, Waze יוכלו לזהות את השותף המושפע ולטפל בבעיה מהר יותר.

סיכום

Waze Deep Links מציעים דרך פשוטה לשלוח משתמשים מהאתר או מהאפליקציה שלכם ישירות לאפליקציית Waze לצורך ניווט. ה-API משתמש במבנה URL נקי עם מספר פרמטרים למיקום, חיפוש, מועדפים ורמת זום.

לנושא קשור, ראו את המדריך על הוספת Google Maps לוורדפרס באמצעות Maps API.

דיון ותגובות
5 תגובות  ]
  • איש נחמד 24 ינואר 2022, 18:49

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

  • אודי בורג 22 אפריל 2022, 11:48

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

השאירו תגובה

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

Savvy WordPress Development official logo