คุณสร้าง Dynamic Links แบบสั้นหรือแบบยาวได้โดยใช้ Firebase Dynamic Links API API ใช้โครงสร้างพารามิเตอร์ที่ไม่บังคับหลายรายการเพื่อสร้างลิงก์ นอกจากนี้ คุณยังสร้างลิงก์แบบสั้นจากลิงก์แบบยาวที่สร้างไว้ก่อนหน้านี้ได้ด้วย Firebase Dynamic Links จะสร้าง URL ดังต่อไปนี้
https://example.page.link/WXYZ
C++ SDK ใช้งานได้กับทั้ง Android และ iOS โดยต้องมีการตั้งค่าเพิ่มเติมสำหรับแต่ละแพลตฟอร์ม
ก่อนเริ่มต้น
คุณต้องดำเนินการต่อไปนี้ก่อนจึงจะใช้ Firebase Dynamic Links ได้
ลงทะเบียนโปรเจ็กต์ C++ และกำหนดค่าให้ใช้ Firebase
หากโปรเจ็กต์ C++ ใช้ Firebase อยู่แล้ว โปรเจ็กต์ดังกล่าวจะได้รับการลงทะเบียนและกำหนดค่าสำหรับ Firebase แล้ว
เพิ่ม Firebase C++ SDK ลงในโปรเจ็กต์ C++
โปรดทราบว่าการเพิ่ม Firebase ลงในโปรเจ็กต์ C++ เกี่ยวข้องกับงานทั้งในFirebaseคอนโซลและในโปรเจ็กต์ C++ ที่เปิดอยู่ (เช่น คุณดาวน์โหลดไฟล์การกําหนดค่า Firebase จากคอนโซล แล้วย้ายไฟล์เหล่านั้นไปยังโปรเจ็กต์ C++)
Android
- ในคอนโซล Firebase ให้เปิดส่วน Dynamic Links
หากยังไม่ได้ยอมรับข้อกำหนดในการให้บริการและตั้งค่าคำนำหน้า URI สำหรับ Dynamic Links ให้ดำเนินการเมื่อได้รับข้อความแจ้ง
หากคุณมีคำนำหน้า URI Dynamic Links อยู่แล้ว ให้จดคำนำหน้านั้นไว้ คุณต้องระบุคำนำหน้า URI Dynamic Links เมื่อสร้าง Dynamic Links ด้วยโปรแกรม
- แนะนํา: ระบุรูปแบบ URL ที่อนุญาตให้ใช้ใน Deep Link และลิงก์สำรอง ซึ่งจะช่วยป้องกันไม่ให้บุคคลที่ไม่ได้รับอนุญาตสร้าง Dynamic Links ที่เปลี่ยนเส้นทางจากโดเมนของคุณไปยังเว็บไซต์ที่คุณไม่ได้ควบคุม ดูรูปแบบ URL ของรายการที่อนุญาตพิเศษ
iOS
- ในคอนโซล Firebase ให้เปิดส่วน Dynamic Links
หากยังไม่ได้ยอมรับข้อกำหนดในการให้บริการและตั้งค่าคำนำหน้า URI สำหรับ Dynamic Links ให้ดำเนินการเมื่อได้รับข้อความแจ้ง
หากคุณมีคำนำหน้า URI Dynamic Links อยู่แล้ว ให้จดคำนำหน้านั้นไว้ คุณต้องระบุโดเมน Dynamic Links เมื่อสร้าง Dynamic Links ด้วยโปรแกรม
- Firebase Dynamic Links ไลบรารีไคลเอ็นต์ C++ ใช้รูปแบบ URL ที่กําหนดเองใน iOS เพื่อประมวลผลลิงก์ คุณต้องเพิ่มรูปแบบ URL ที่กําหนดเองลงในแอปเพื่อรองรับการรับ Dynamic Links ดังนี้
- หากต้องการเปิดการกําหนดค่าโปรเจ็กต์ ให้ดับเบิลคลิกชื่อโปรเจ็กต์ในมุมมองแผนภูมิต้นไม้ทางด้านซ้าย เลือกแอปจากส่วนเป้าหมาย จากนั้นเลือกแท็บข้อมูล แล้วขยายส่วนประเภท URL
- คลิกปุ่ม + แล้วเพิ่มรูปแบบ URL สำหรับรหัสไคลเอ็นต์ที่กลับด้าน หากต้องการค้นหาค่านี้ ให้เปิด
ไฟล์การกําหนดค่า แล้วมองหาคีย์GoogleService-Info.plist REVERSED_CLIENT_ID
คัดลอกค่าของคีย์นั้น แล้ววางลงในช่องรูปแบบ URL ในหน้าการกําหนดค่า เว้นช่องอื่นว่างไว้ - คลิกปุ่ม + แล้วเพิ่มรูปแบบ URL รายการที่ 2 รหัสนี้เหมือนกับรหัส App Bundle ของแอป เช่น หากรหัสกลุ่มคือ
com.example.ios
ให้พิมพ์ค่านั้นลงในช่องรูปแบบ URL คุณจะดูรหัสชุดของแอปได้ในแท็บทั่วไปของการกําหนดค่าโปรเจ็กต์ (ข้อมูลประจําตัว > รหัสชุด)
ใช้คอนโซล Firebase
หากต้องการสร้าง Dynamic Link รายการเดียวเพื่อวัตถุประสงค์ในการทดสอบหรือเพื่อให้��ี������รตลาดสร้างลิงก์ที่ใช้ในโพสต์โซเชียลมีเดียได้ง่ายๆ วิธีง่ายที่สุดคือไปที่คอนโซล Firebase แล้วสร้าง Dynamic Link ด้วยตนเองโดยทำตามแบบฟอร์มทีละขั้นตอน
โดเมนที่กำหนดเอง
คุณจะมีการควบคุมการสร้างแบรนด์ของ Dynamic Link ได้มากขึ้นโดยใช้โดเมนของคุณเองแทนโดเมนย่อย goo.gl
หรือ page.link
ทำตามวิธีการเหล่านี้เพื่อตั้งค่าโดเมนที่กำหนดเองสำหรับโปรเจ็กต์
การใช้ Firebase Dynamic Links API
สร้างและเริ่มต้นแอป
คุณต้องสร้างและเริ่มต้นออบเจ็กต์ firebase::App
ก่อนจึงจะสร้าง Dynamic Links ได้
รวมไฟล์ส่วนหัวสําหรับ firebase::App
#include "firebase/app.h"
ส่วนถัดไปจะแตกต่างกันไปตามแพลตฟอร์มของคุณ
Android
สร้าง firebase::App
โดยส่งผ่านสภาพแวดล้อม JNI และjobject
การอ้างอิงไปยังกิจกรรม Java เป็นอาร์กิวเมนต์
app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);
iOS
สร้าง firebase::App
app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));
เริ่มต้นคลัง Dynamic Links
ก่อนสร้าง Dynamic Link คุณต้องเริ่มต้นไฟล์ Dynamic Links ดังนี้
::firebase::dynamic_links::Initialize(app, null);
การสร้าง Dynamic Link แบบยาวจากพารามิเตอร์
หากต้องการสร้าง Dynamic Link ให้สร้างออบเจ็กต์ DynamicLinkComponents โดยตั้งค่าสมาชิกที่ไม่บังคับสำหรับการกำหนดค่าเพิ่มเติม แล้วส่งไปยัง dynamic_links::GetShortLink
หรือ dynamic_links::GetLongLink
ตัวอย่างขั้นต่ำต่อไปนี้สร้างลิงก์แบบไดนามิกแบบยาวไปยัง https://www.example.com/ ที่เปิดขึ้นด้วยแอป Android com.example.android.package_name และแอป iOS com.example.ios
firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios"); firebase::dynamic_links::AndroidParameters android_parameters( "com.example.android.package_name"); firebase::dynamic_links::DynamicLinkComponents components( "https://www.example.com/", "example.page.link"); components.android_parameters = &android_parameters; components.ios_parameters = &ios_parameters; firebase::dynamic_links::GeneratedDynamicLink long_link = firebase::dynamic_links::GetLongLink(components);
การสร้าง Shorts Dynamic Link
หากต้องการสร้างลิงก์แบบสั้นแบบไดนามิก ให้ส่งลิงก์แบบยาวที่สร้างไว้ก่อนหน้านี้ไปยัง GetShortLink
หรือสร้าง DynamicLinkComponents
ในลักษณะเดียวกับด้านบน
GetShortLink
จะใช้พารามิเตอร์การกําหนดค่า DynamicLinkOptions
เพิ่มเติมกับ PathLength
หรือไม่ก็ได้ ซึ่งจะช่วยให้คุณควบคุมวิธีสร้างลิงก์ได้ การสร้างลิงก์สั้นต้องใช้คําขอเครือข่ายไปยังแบ็กเอนด์ Firebase ดังนั้น GetShortLink
จึงเป็นแบบไม่พร้อมกันและแสดงผล Future<GeneratedLink>
เช่น
firebase::dynamic_links::DynamicLinkOptions short_link_options; short_link_options.path_length = firebase::dynamic_links::kPathLengthShort; firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result = firebase::dynamic_links::GetShortLink(components, short_link_options);
หากโปรแกรมม��ลูปการอัปเดตที่ทำงานเป็นประจำ (เช่น 30 หรือ 60 ครั้งต่อวินาที) คุณจะตรวจสอบผลลัพธ์ได้ 1 ครั้งต่อการอัปเดต ดังนี้
if (result.status() == firebase::kFutureStatusComplete) { if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) { firebase::dynamic_links::GeneratedDynamicLink link = *result.result(); printf("Create short link succeeded: %s\n", link.url.c_str()); } else { printf("Created short link failed with error '%s'\n", result.error_message()); } }