คุณสามารถสร้างลิงก์ไดนามิกแบบสั้นหรือแบบยาวได้ด้วย Firebase Dynamic Links Builder API API นี้ยอมรับ Dynamic Link แบบยาวหรืออ็อบเจ็กต์ที่มีพารามิเตอร์ Dynamic Link และส่งคืน URL เช่นตัวอย่างต่อไปนี้:
https://example.com/link/WXYZ
https://example.page.link/WXYZ
ตั้งค่า Firebase และ Dynamic Links SDK
ก่อนที่คุณจะสร้างลิงก์แบบไดนามิกในแอป Android คุณต้องรวม Firebase SDK หากแอปของคุณได้รับการตั้งค่าให้รับลิงก์แบบไดนามิก แสดงว่าคุณได้ทำตามขั้นตอนเหล่านี้เรียบร้อยแล้ว และคุณสามารถข้ามส่วนนี้ได้
ติดตั้งและเริ่มต้น Firebase SDK สำหรับ Flutter หากคุณยังไม่ได้ดำเนินการ
จากไดเรกทอรีรากของโปรเจ็กต์ Flutter ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน Dynamic Links:
flutter pub add firebase_dynamic_links
หากคุณกำลังสร้างแอป Android ให้เปิดหน้า การตั้งค่าโปรเจ็ กต์ของคอนโซล Firebase และตรวจสอบว่าคุณได้ระบุคีย์การลงนาม SHA-1 แล้ว หากคุณใช้ลิงก์แอป ให้ระบุคีย์ SHA-256 ด้วย
ในคอนโซล Firebase ให้เปิดส่วน ลิงก์แบบไดนามิก
หากคุณยังไม่ได้ตั้งค่าโดเมนสำหรับลิงก์แบบไดนามิก ให้คลิกปุ่ม เริ่มต้น ใช้งานและปฏิบัติตามคำแนะนำ
หากคุณมีโดเมน Dynamic Links อยู่แล้ว โปรดจดไว้ คุณต้องระบุโดเมนลิงก์แบบไดนามิกเมื่อคุณสร้างลิงก์แบบไดนามิกโดยทางโปรแกรม
แนะนำ : จากเมนู "เพิ่มเติม" (⋮) ให้ระบุรูปแบบ URL ที่อนุญาตในลิงก์ในรายละเอียดและลิงก์สำรอง การทำเช่นนี้เป็นการป้องกันไม่ให้บุคคลที่ไม่ได้รับอนุญาตสร้างลิงก์แบบไดนามิกที่เปลี่ยนเส้นทางจากโดเมนของคุณไปยังไซต์ที่คุณไม่ได้ควบคุม
โปรดดู ที่อนุญาตรูปแบบ URL เฉพาะ
สร้างไดนามิกลิงค์จากพารามิเตอร์
ในการสร้าง Dynamic Link ให้สร้าง DynamicLinkParameters
ใหม่และส่งต่อไปยัง buildLink()
หรือ buildShortLink()
ตัวอย่างขั้นต่ำต่อไปนี้จะสร้างลิงก์แบบไดนามิกแบบยาวไปยัง https://www.example.com/
ซึ่งเปิดขึ้นด้วย com.example.app.android
บน Android และแอป com.example.app.ios
บน iOS:
final dynamicLinkParams = DynamicLinkParameters(
link: Uri.parse("https://www.example.com/"),
uriPrefix: "https://example.page.link",
androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);
ในการสร้าง Dynamic Link แบบสั้น ให้ส่งอ็อบเจ็กต์ DynamicLinkParameters
ไปที่ buildShortLink()
การสร้างลิงก์แบบสั้นต้องมีการโทรผ่านเครือข่าย ตัวอย่างเช่น:
final dynamicLinkParams = DynamicLinkParameters(
link: Uri.parse("https://www.example.com/"),
uriPrefix: "https://example.page.link",
androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);
ตามค่าเริ่มต้น ลิงก์ไดนามิกแบบสั้นจะถูกสร้างขึ้นโดยมีคำต่อท้ายที่มีความยาวเพียงไม่กี่อักขระ แม้ว่าสิ่งนี้จะทำให้ลิงก์กระชับขึ้น แต่ก็ยังแนะนำความเป็นไปได้ที่อาจมีใครบางคนสามารถเดาลิงก์สั้น ๆ ที่ถูกต้องได้ บ่อยครั้งไม่มีอันตรายหากมีผู้ทำเช่นนั้น เนื่องจากลิงก์นำไปสู่ข้อมูลสาธารณะ
อย่างไรก็ตาม หากลิงก์สั้น ๆ ของคุณนำไปสู่ข้อมูลเฉพาะผู้ใช้ คุณควรสร้างลิงก์ที่ยาวขึ้นด้วยส่วนต่อท้าย 17 อักขระ ซึ่งทำให้ไม่น่าจะมีใครคาดเดาไดนามิกลิงก์ที่ถูกต้องได้ ในการดำเนินการดังกล่าว ให้ส่งผ่าน ShortDynamicLinkType.unguessable
ไปยัง buildShortLink()
:
final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
dynamicLinkParams,
shortLinkType: ShortDynamicLinkType.unguessable,
);
พารามิเตอร์ไดนามิกลิงค์
คุณสามารถใช้ Dynamic Link Builder API เพื่อสร้าง Dynamic Links ด้วยพารามิเตอร์ที่รองรับ ดูการ อ้างอิง API
ตัวอย่างต่อไปนี้สร้าง Dynamic Link พร้อมชุดพารามิเตอร์ทั่วไปหลายชุด:
final dynamicLinkParams = DynamicLinkParameters(
link: Uri.parse("https://www.example.com/"),
uriPrefix: "https://example.page.link",
androidParameters: const AndroidParameters(
packageName: "com.example.app.android",
minimumVersion: 30,
),
iosParameters: const IOSParameters(
bundleId: "com.example.app.ios",
appStoreId: "123456789",
minimumVersion: "1.0.1",
),
googleAnalyticsParameters: const GoogleAnalyticsParameters(
source: "twitter",
medium: "social",
campaign: "example-promo",
),
socialMetaTagParameters: SocialMetaTagParameters(
title: "Example of a Dynamic Link",
imageUrl: Uri.parse("https://example.com/image.png"),
),
);
final dynamicLink =
await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);
คุณสามารถตั้งค่าพารามิเตอร์ Dynamic Link ด้วยวิธีต่อไปนี้:
พารามิเตอร์ DynamicLink | |
---|---|
setLink | ลิงก์ที่แอปของคุณจะเปิดขึ้น ระบุ URL ที่แอปของคุณสามารถจัดการได้ โดยทั่วไปคือเนื้อหาหรือเพย์โหลดของแอป ซึ่งเริ่มต้นตรรกะเฉพาะแอป (เช่น ให้เครดิตผู้ใช้ด้วยคูปองหรือแสดงหน้าจอต้อนรับ) ลิงก์นี้ต้องเป็น URL ที่มีรูปแบบที่ดี มีการเข้ารหัส URL อย่างถูกต้อง ใช้ HTTP หรือ HTTPS และไม่สามารถเป็นลิงก์แบบไดนามิกอื่นได้ |
setDomainUriPrefix | คำนำหน้า URL ลิงก์แบบไดนามิกของคุณ ซึ่งคุณจะพบได้ในคอนโซล Firebase โดเมนไดนามิกลิงก์ดูเหมือนตัวอย่างต่อไปนี้: https://example.com/link https://example.page.link |
พารามิเตอร์ Android | |
---|---|
setFallbackUrl | ลิงก์สำหรับเปิดเมื่อไม่ได้ติดตั้งแอป ระบุสิ่งนี้เพื่อทำอย่างอื่นนอกเหนือจากการติดตั้งแอพของคุณจาก Play Store เมื่อไม่ได้ติดตั้งแอพนั้น เช่น เปิดเนื้อหาในเวอร์ชั่นเว็บบนมือถือ หรือแสดงหน้าโปรโมชั่นสำหรับแอพของคุณ |
setMinimumVersion | versionCode ของเวอร์ชันขั้นต่ำของแอปที่สามารถเปิดลิงก์ได้ หากแอปที่ติดตั้งเป็นเวอร์ชันเก่า ระบบจะนำผู้ใช้ไปที่ Play Store เพื่ออัปเกรดแอป |
IosParameters | |
---|---|
setAppStoreId | App Store ID ของแอปของคุณ ใช้เพื่อส่งผู้ใช้ไปยัง App Store เมื่อไม่ได้ติดตั้งแอป |
setFallbackUrl | ลิงก์สำหรับเปิดเมื่อไม่ได้ติดตั้งแอป ระบุสิ่งนี้เพื่อทำอย่างอื่นนอกเหนือจากการติดตั้งแอพของคุณจาก App Store เมื่อไม่ได้ติดตั้งแอพ เช่น เปิดเนื้อหาในเวอร์ชั่นเว็บบนมือถือ หรือแสดงหน้าโปรโมชั่นสำหรับแอพของคุณ |
setCustomScheme | สคีม URL ที่กำหนดเองของแอป หากกำหนดเป็นอย่างอื่นที่ไม่ใช่ Bundle ID . ของแอป |
setIpadFallbackUrl | ลิงก์สำหรับเปิดบน iPad เมื่อไม่ได้ติดตั้งแอป ระบุสิ่งนี้เพื่อทำอย่างอื่นนอกเหนือจากการติดตั้งแอพของคุณจาก App Store เมื่อไม่ได้ติดตั้งแอพ เช่น เปิดเนื้อหาในเวอร์ชั่นเว็บ หรือแสดงหน้าโปรโมชั่นสำหรับแอพของคุณ |
setIpadBundleId | ID บันเดิลของแอป iOS ที่จะใช้บน iPads เพื่อเปิดลิงก์ แอปต้องเชื่อมต่อกับโปรเจ็กต์ของคุณจากหน้าภาพรวมของคอนโซล Firebase |
setMinimumVersion | หมายเลขเวอร์ชันของเวอร์ชันขั้นต่ำของแอปที่สามารถเปิดลิงก์ได้ แฟล็กนี้จะถูกส่งต่อไปยังแอปของคุณเมื่อเปิด และแอปของคุณต้องตัดสินใจว่าจะทำอย่างไรกับแอปนั้น |
NavigationInfoParameters | |
---|---|
setForcedRedirectEnabled | หากตั้งค่าเป็น '1' ให้ข้ามหน้าแสดงตัวอย่างแอปเมื่อเปิดลิงก์แบบไดนามิก และเปลี่ยนเส้นทางไปยังแอปหรือร้านค้าแทน หน้าแสดงตัวอย่างแอป (เปิดใช้งานโดยค่าเริ่มต้น) สามารถส่งผู้ใช้ไปยังปลายทางที่เหมาะสมที่สุดได้อย่างน่าเชื่อถือมากขึ้นเมื่อพวกเขาเปิดลิงก์แบบไดนามิกในแอป อย่างไรก็ตาม หากคุณคาดว่าไดนามิกลิงก์จะเปิดเฉพาะในแอปที่สามารถเปิดลิงก์ไดนามิกได้อย่างน่าเชื่อถือโดยไม่ต้องมีหน้านี้ คุณสามารถปิดใช้งานได้ด้วยพารามิเตอร์นี้ พารามิเตอร์นี้จะส่งผลต่อการทำงานของ Dynamic Link บน iOS เท่านั้น |
SocialMetaTagParameters | |
---|---|
setTitle | ชื่อเรื่องที่จะใช้เมื่อมีการแชร์ลิงก์แบบไดนามิกในโพสต์โซเชียล |
setDescription | คำอธิบายที่จะใช้เมื่อมีการแชร์ลิงก์แบบไดนามิกในโพสต์โซเชียล |
setImageUrl | URL ไปยังรูปภาพที่เกี่ยวข้องกับลิงก์นี้ รูปภาพควรมีขนาดอย่างน้อย 300x200 พิกเซล และไม่เกิน 300 KB |
GoogleAnalyticsParameters | |
---|---|
setSource setMedium setCampaign setTerm setContent | พารามิเตอร์การวิเคราะห์ของ Google Play พารามิเตอร์เหล่านี้ (`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`) จะถูกส่งต่อไปยัง Play Store และผนวกเข้ากับเพย์โหลดของลิงก์ |
iTunesConnectAnalyticsParameters | |
---|---|
setProviderToken setAffiliateToken setCampaignToken | พารามิเตอร์การวิเคราะห์ iTunes Connect พารามิเตอร์เหล่านี้ (`pt`, `at`, `ct`) จะถูกส่งไปยัง App Store |