Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

דף זה תורגם על ידי Cloud Translation API.

בנייה ידנית של כתובת אתר של קישור דינמי

אפשר ליצור Dynamic Link על ידי בניית כתובת URL באופן ידני בפורמט הבא:

https://your_subdomain.page.link/?link=your_deep_link&apn=package_name[&amv=minimum_version][&afl=fallback_link]

פרמטרים של Dynamic Link

פרמטר של קישור עומק (פרמטר של עומס נתונים)

קישור

פרמטר של קישור עומק (פרמטר של עומס נתונים)
קישור	הקישור שבו האפליקציה תיפתח. מציינים כתובת URL שהאפליקציה יכולה לטפל בה. בדרך כלל, זוהי כתובת ה-URL של התוכן או של עומס העבודה (payload) של האפליקציה, שמפעילה לוגיקה ספציפית לאפליקציה (למשל, הקצאת זיכוי למשתמש באמצעות שובר או הצגת מסך קבלת פנים). הקישור הזה חייב להיות כתובת URL בפורמט תקין, עם קידוד כתובת URL תקין, עם HTTP או HTTPS, ולא יכול להיות קישור דינמי אחר. כשמשתמשים פותחים Dynamic Link בדפדפן אינטרנט במחשב, הם יטענו את כתובת ה-URL הזו (אלא אם צוין הפרמטר `ofl`). אם אין לכם תוכן אינטרנט מקביל לתוכן המקושר, כתובת ה-URL לא צריכה להפנות למשאב אינטרנט תקין. במקרה כזה, צריך להגדיר הפניה אוטומטית מכתובת ה-URL הזו, לדוגמה לדף הבית.

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

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

פרמטרים של Android
apn	שם החבילה של אפליקציית Android שבה רוצים להשתמש כדי לפתוח את הקישור. צריך לחבר את האפליקציה לפרויקט דרך הדף Overview במסוף Firebase. נדרשת כדי ש-Dynamic Link תוכל לפתוח אפליקציה ל-Android.
afl	הקישור שייפתח כשהאפליקציה לא מותקנת. מציינים את האפשרות הזו כדי לבצע פעולה אחרת מלהתקין את האפליקציה מחנות Play כשהיא לא מותקנת, למשל לפתוח את גרסת האינטרנט לנייד של התוכן או להציג דף קידום מכירות של האפליקציה.
amv	`versionCode` של הגרסה המינימלית של האפליקציה שיכולה לפתוח את הקישור. אם האפליקציה המותקנת היא גרסה ישנה יותר, המשתמש מועבר לחנות Play כדי לשדרג את האפליקציה.

פרמטרים של iOS
ibi	מזהה החבילה של אפליקציית iOS שבה נעשה שימוש כדי לפתוח את הקישור. צריך לחבר את האפליקציה לפרויקט דרך הדף Overview במסוף Firebase. נדרשת כדי לאפשר ל-Dynamic Link לפתוח אפליקציה ל-iOS.
ifl	הקישור שייפתח כשהאפליקציה לא מותקנת. מציינים את האפשרות הזו כדי לבצע פעולה אחרת מלהתקין את האפליקציה מ-App Store כשהיא לא מותקנת, למשל לפתוח את גרסת האינטרנט לנייד של התוכן או להציג דף קידום מכירות של האפליקציה.
ius	הסכימה של כתובת ה-URL בהתאמה אישית של האפליקציה, אם היא מוגדרת כמשהו אחר מאשר מזהה החבילה של האפליקציה
ipfl	הקישור שצריך לפתוח ב-iPad כשהאפליקציה לא מותקנת. מציינים את האפשרות הזו כדי לבצע פעולה אחרת מלהתקין את האפליקציה מ-App Store כשהיא לא מותקנת, למשל לפתוח את גרסת האינטרנט של התוכן או להציג דף קידום מכירות של האפליקציה.
ipbi	מזהה החבילה של אפליקציית iOS שתשמש לפתוח את הקישור ב-iPad. צריך לחבר את האפליקציה לפרויקט דרך הדף Overview במסוף Firebase.
isi	מזהה האפליקציה ב-App Store, שמשמש לשליחת משתמשים ל-App Store כשהאפליקציה לא מותקנת
imv	מספר הגרסה של הגרסה המינימלית של האפליקציה שיכולה לפתוח את הקישור. הדגל הזה מועבר לאפליקציה כשהיא נפתחת, והאפליקציה צריכה להחליט מה לעשות איתו.
efr	אם הערך מוגדר כ-'1', הדף עם התצוגה המקדימה של האפליקציה יודלג כאשר Dynamic Link נפתח, ובמקום זאת תתבצע הפניה אוטומטית לאפליקציה או לחנות. דף התצוגה המקדימה של האפליקציה (מופעל כברירת מחדל) יכול לשלוח משתמשים ליעד המתאים ביותר בצורה מהימנה יותר כשהם פותחים Dynamic Links באפליקציות. עם זאת, אם אתם מצפים ש-Dynamic Link ייפתח רק באפליקציות שיכולות לפתוח את Dynamic Links בצורה מהימנה בלי הדף הזה, תוכלו להשבית אותו באמצעות הפרמטר הזה. הפרמטר הזה ישפיע על ההתנהגות של Dynamic Link רק ב-iOS.

פרמטרים אחרים של פלטפורמה
ofl	הקישור לפתיח בפלטפורמות שאינן Android ו-iOS. אפשר להשתמש באפשרות הזו כדי לציין התנהגות שונה במחשב, למשל הצגת דף אינטרנט מלא של תוכן האפליקציה/מטען הייעודי (כפי שצוין על ידי הקישור של הפרמטר) עם קישור דינמי אחר להתקנת האפליקציה.

פרמטרים של מטא תגים ברשתות חברתיות
st	הכותרת שתשמש לשיתוף Dynamic Link בפוסט ברשתות החברתיות.
sd	התיאור שישמש כשה-Dynamic Link ישותף בפוסט ברשתות החברתיות.
si	כתובת ה-URL של תמונה שקשורה לקישור הזה. התמונה צריכה להיות בגודל 300x200 פיקסלים לפחות, ובגודל של פחות מ-300KB.

פרמטרים של Analytics
utm_source utm_medium utm_campaign utm_term utm_content	פרמטרים של ניתוח נתונים ב-Google Play.
at ct mt pt	פרמטרים של ניתוח נתונים ב-iTunes Connect.

הערה: אפשר לשלב פרמטרים ל-Android ול-iOS כדי ליצור Dynamic Link שאפשר להשתמש בו בשתי הפלטפורמות. לדוגמה:

https://example.page.link/?link=https://www.example.com/someresource&apn=com.example.android&amv=3&ibi=com.example.ios&isi=1234567&ius=exampleapp

ניפוי באגים בכתובת URL

כדי לנפות באגים ב-Dynamic Link, אפשר להשתמש בכתובת URL ארוכה או קצרה ולצרף אליה פרמטר לניפוי באגים.

https://example.page.link/?link=https://www.example.com&d=1
https://example.page.link/WXYZ?d=1

פרמטר של ניפוי באגים
י'	במקום לטעון את Dynamic Link, אפשר ליצור תרשים זרימה שבעזרתו תוכלו לראות תצוגה מקדימה של ההתנהגות של Dynamic Links בפלטפורמות ובהגדרות שונות.

השלבים הבאים

אחרי שיוצרים Dynamic Link, צריך להגדיר את האפליקציה לקבלת Dynamic Links ולשלוח משתמשים למקום הנכון באפליקציה אחרי שהם פותחים אותם.

כדי לקבל את Dynamic Links באפליקציה, אפשר לעיין במסמכים למפתחים של iOS,‏ Android,‏ C++‎ ו-Unity.