דף זה תורגם על ידי 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. אפשר להשתמש באפשרות הזו כדי לציין התנהגות שונה במחשב, למשל הצגת דף אינטרנט מלא של תוכן האפליקציה/מטען הייעודי (כפי שצוין על ידי הקישור של הפרמטר) עם קישור דינמי אחר להתקנת האפליקציה.

פרמטרים של תגי Meta של רשתות חברתיות
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.