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

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

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

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

‫Dynamic Link פרמטרים

פרמטר של קישור עומק (פרמטר מטען ייעודי (payload))

קישור

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

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

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

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

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