Firebase – Android: Liên kết động

Thứ Hai, 27/04/2020

Tram Ho

Mình có giới thiệu về Dynamic Links rồi nên mọi người cũng biết nó là cái gì và nó sinh ra là để làm gì rồi đúng không? . Dĩ nhiên là có tổng quan thì phải có chi tiết thì mới hoàn chỉnh được chứ. Do vậy, hôm nay mình sẽ trình bày những kiến thức của mình tìm hiểu được về Dynamic Links nhé!

1. Các trường hợp nào nên sử dụng Dynamic Links?

Dưới đây là một số trường hợp app của bạn có thể sử dụng Dynamic Links:

a, Chuyển user từ web sang app

Ví dụ mình có một app bán hàng, nếu không có Dynamic Links, bạn đang dùng web để xem sản phẩm A bỗng nhiên cần phải điều hướng đến CH Play để cài app, sau khi cài app xong thì bạn không thể nào trở lại sản phẩm A mà bạn đang xem trước đó. Nhưng khi app có Dynamic Links thì bạn có thể trở lại xem sản phẩm A sau khi cài app. Điều này mang lại nhiều lợi ích cho app của bạn:

Sự chuyển đổi này làm cho người dùng cảm thấy thoải mái hơn
Người dùng có thể bắt đầu dùng app với nội dung đúng như đã xem trước đó trên web.
Mà lại không cần code nhiều nữa chứ.

b, Các chiến lược quảng cáo app trên mạng xã hội, email hoặc SMS

Ví dụ với app mua sắm đợt này đang có chiến dịch kích cầu, bạn gửi các chương trình khuyến mại bằng cách sử dụng các links có thể hoạt động trên bất kỳ nền tảng nào. Người dùng hiện tại và tương lai có thể đổi phiếu mua hàng của bạn cho dù họ sử dụng iOS, Android hoặc trình duyệt web và bất kể họ đã cài đặt app của bạn hay chưa.

c, User muốn chia sẻ cho nhau

Một trong những cách hiệu quả nhất để khiến người dùng mới cài đặt app của bạn là cho phép user chia sẻ nội dung từ app với bạn bè của họ. Với Dynamic Links, bạn có thể tạo ra những trải nghiệm chia sẻ giữa người dùng và người dùng một cách thuận tiện hơn: khi user nhận được link từ bạn bè, họ có thể nhấp vào link và được đưa trực tiếp đến nội dung được chia sẻ trong ứng dụng, ngay cả khi họ phải truy cập App Store hoặc Google Play Store để cài đặt ứng dụng của bạn trước.
Bằng cách kết hợp các lượt giới thiệu người dùng và sự thuận tiện của Dynamic Links, bạn có thể tạo các tính năng chia sẻ và giới thiệu giữa người dùng với người dùng mới để phục vụ các chương trình khuyến mãi cùng có lợi cho người giới thiệu và người được giới thiệu.

d, Chuyển người dùng từ desktop sang app

Tạo Dynamic Links khi người dùng web đánh dấu một trang hoặc gửi đi một link nào đó. Khi họ mở link ấy trên một thiết bị khác, họ sẽ có được trải nghiệm tốt nhất trên mọi thiết bị.

**Sơ đồ hệ thống Android sẽ như sau: **

2. Cách tạo Dynamic Links như thế nào?

Dynamic Links và Deep Links

Khái niệm Dynamic Links của Firebase đang bao hàm cả Deep link. Bởi thực chất, deep link vấn là link thực tế mà user muốn tương tác, muốn xem. Firebase sẽ dùng deep link đó, kết hợp với các thông tin khác để build thành một link cuối gọi là Dynamic Links. Dynamic Links mang theo nhiều thông tin hơn như là:

Domain
Deep Links
Project Information: một số thông tin của project như package name, version app,… cũng được gói vào trong link này.
Fallback url: link dự phòng trong trường hợp app không thể cài đặt trên target device.

Một sự khác biệt nữa đó là trong trường hợp app chưa được cài Dynamic Links sẽ điều hướng người dùng tới store để cài đặt app. Sau khi cài thành công sẽ mở màn hình tương ứng với thông tin deep link mang theo, còn Deep Links sẽ mở link trên browser.

So sánh nhỏ giữa Deep links và App Links:

Deep Links: Khi có một link mà bạn click vào, app của bạn sẽ handle Intent được gửi tới, nhưng nếu như có nhiều app khác cũng handle Intent này thì system sẽ mở ra hộp thoại để bạn lựa chọn một app trong những app được show ra:

Với App Links thì chỉ duy nhất app của bạn mới nhận và handle được cái Intent đó, khi bạn nhấp vào link thì user sẽ được điều hướng đến đúng app mà bạn muốn mở, không hiển thị hộp thoại lựa chọn. Vì App Links sử dụng HTTP URLs liên kết đến domain của web mà bạn sở hữu, không app nào có thể sử dụng link đó. Do vậy, một trong những yêu cầu của App Links đó là bạn phải xác minh domain mà bạn sở hữu thông qua website của Firebase. (cái này mình không đi sâu). Với App Links, bạn còn có thể mở trực tiếp content trong app khi click vào kết quả tìm kiếm trên công cụ Google Search, trong phần tìm kiếm trên màn hình Android hoặc Google Assistant.

Có 4 cách để tạo Dynamic Links như sau:

a. Sử dụng Firebase Console.

Cách này tốt trong trường hợp bạn tạo links để chia sẻ trên các phương tiện truyền thông xã hội. Bằng cách này, bạn có thể tự custom surffix link và tên của link trên Firebase console. Bạn cũng có thể theo dõi hiệu suất hoạt động của Dynamic Links này trên Firebase console hoặc Rest API Analytics.
Nếu các bạn chưa tạo 1 domain thì Firebase sẽ hiện lên form thông báo để bạn hoàn thành việc này. Domain này sẽ là tiền tố của Dynamic Links sau này. Nó sẽ có dạng như sau:

http<span class="token operator">:</span><span class="token operator">/</span><span class="token operator">/</span>myapp<span class="token punctuation">.</span>page<span class="token punctuation">.</span>link

1 2	http<span class="token operator">:</span><span class="token operator">/</span><span class="token operator">/</span>myapp<span class="token punctuation">.</span>page<span class="token punctuation">.</span>link

Bạn điền đầy đủ thông tin vào đây theo các bước là được nhé:

b. Sử dụng Dynamic Link Builder API trên IOS hoặc Android.

Đây là cách thích hợp để tự động tạo link trong ứng dụng của bạn để chia sẻ giữa người dùng với người dùng hoặc trong mọi tình huống mà cần nhiều links. Bạn cũng có thể theo dõi hiệu suất của Dynamic Link bằng Dynamic Links Analytics API.

c. Sử dụng REST API.

Cách này là cứ tinh của cách số 3, nếu platform nào mà không có Builder API thì dùng cách này. Analytics REST API có thể theo dõi được hiệu suất quảng cáo trên console.

d. Tự tạo thủ công.

Cách này thì dễ tính quá, nếu như bạn không cần quan tâm links dài hay ngắn, không cần quan tâm user click link hay không thì hãy sử dụng cách này. Tránh đi vòng vo như mấy cách trên. Và khi làm dự án thì mình cũng dùng cách này để test chỗ code Dynamic Links của mình trong dự án nó có chạy ổn hay không. Tất nhiên là sau này khách hàng sẽ tạo link sẵn cho mình rồi, mình không phải tạo.
Để tạo Dynamic Links thì bạn cần theo cái form sau:

https<span class="token operator">:</span><span class="token operator">/</span><span class="token operator">/</span>your_subdomain<span class="token punctuation">.</span>page<span class="token punctuation">.</span>link<span class="token operator">/</span><span class="token operator">?</span>link<span class="token operator">=</span>your_deep_link<span class="token operator">&amp;</span>apn<span class="token operator">=</span>package_name<span class="token punctuation">[</span><span class="token operator">&amp;</span>amv<span class="token operator">=</span>minimum_version<span class="token punctuation">]</span><span class="token punctuation">[</span><span class="token operator">&amp;</span>afl<span class="token operator">=</span>fallback_link<span class="token punctuation">]</span>

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

Các tham số trong link:

yoursubdomain: Cái này là domain nhé, app có domain như nào thì ném vào đây.
yourdeeplink: đây là deep link này, ném deep link của bạn vào đây.
packagename: lại vào project lôi cái package name ném vào đây. Package name là gía trị của tham số apn, dùng để liên kết ứng dụng của mình với Firebase console đấy.
minimumversion: đây là versionCode thấp nhất có thể mở được link. Đây là giá trị của tham số amv, nếu version trong link này mà lớn hơn version hiện tại bạn đang có, thì bạn phải lên Store để cài lại app. Đoạn này phải xử lý trong code, mình code như này:

if (BuildConfig.VERSION_CODE &lt; pendingDynamicLinkData.minimumAppVersion) { 
                       startActivity(
                            Intent(
                                Intent.ACTION_VIEW,
                                Uri.parse("https://play.google.com/store/apps/details?id=" + packageName)
                            )
                        )
                    }

if (BuildConfig.VERSION_CODE < pendingDynamicLinkData.minimumAppVersion) {

startActivity(

Intent(

Intent.ACTION_VIEW,

Uri.parse("https://play.google.com/store/apps/details?id=" + packageName)

)

}

fallbacklink: như đã nói thì đây là link dự phòng. Bạn có thể điều hướng người dùng đến bản web hoặc trang quảng cáo nếu như app chưa được cài.

3. Nhận Dynamic Links như thế nào?

Nếu app chưa liên kết với FireBase thì các bạn có thể tham khảo link hướng dẫn sau :
https://firebase.google.com/docs/android/setup

B1: thêm dependences vào file app/build.gradle:

implementation <span class="token string">'com.google.firebase:firebase-dynamic-links:19.1.0'</span>

1 2	implementation <span class="token string">'com.google.firebase:firebase-dynamic-links:19.1.0'</span>

B2: Thêm intent-filter vào Mainifest:

<span class="token operator">&lt;</span>intent<span class="token operator">-</span>filter<span class="token operator">&gt;</span>
    <span class="token operator">&lt;</span>action android<span class="token operator">:</span>name<span class="token operator">=</span><span class="token string">"android.intent.action.VIEW"</span><span class="token operator">/</span><span class="token operator">&gt;</span>
    <span class="token operator">&lt;</span>category android<span class="token operator">:</span>name<span class="token operator">=</span><span class="token string">"android.intent.category.DEFAULT"</span><span class="token operator">/</span><span class="token operator">&gt;</span>
    <span class="token operator">&lt;</span>category android<span class="token operator">:</span>name<span class="token operator">=</span><span class="token string">"android.intent.category.BROWSABLE"</span><span class="token operator">/</span><span class="token operator">&gt;</span>
    <span class="token operator">&lt;</span>data
        android<span class="token operator">:</span>host<span class="token operator">=</span><span class="token string">"example.com"</span>
        android<span class="token operator">:</span>scheme<span class="token operator">=</span><span class="token string">"https"</span><span class="token operator">/</span><span class="token operator">&gt;</span>
<span class="token operator">&lt;</span><span class="token operator">/</span>intent<span class="token operator">-</span>filter<span class="token operator">&gt;</span>

<intent-filter>

<data

android:host="example.com"

android:scheme="https"/>

</intent-filter>

Trong trường hợp , thiết bị đã cài app rồi, firebase sẽ dùng trực tiếp deep-link và mở app. Cũng như nếu thiết bị chưa cài app, mở store -> Sau khi cài xong và ấn Continue và mở app. Khi người dùng mở Dynamic Links, Intent-filter này sẽ lọc theo deep-link được gắn trong Dynamic link, đi đến Activity mà xử lý Intent này.

B3: Nhận và xử lý Dynamic Links:

Để nhận deep link, ta dùng function getDynamicLink() như sau:

FirebaseDynamicLinks<span class="token punctuation">.</span><span class="token function">getInstance</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
        <span class="token punctuation">.</span><span class="token function">getDynamicLink</span><span class="token punctuation">(</span><span class="token function">getIntent</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span>
        <span class="token punctuation">.</span><span class="token function">addOnSuccessListener</span><span class="token punctuation">(</span><span class="token keyword">this</span><span class="token punctuation">,</span> <span class="token keyword">new</span> <span class="token class-name">OnSuccessListener</span><span class="token generics function"><span class="token punctuation">&lt;</span>PendingDynamicLinkData<span class="token punctuation">&gt;</span></span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
            <span class="token annotation punctuation">@Override</span>
            <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">onSuccess</span><span class="token punctuation">(</span>PendingDynamicLinkData pendingDynamicLinkData<span class="token punctuation">)</span> <span class="token punctuation">{</span>
                <span class="token comment">// Get deep link from result (may be null if no link is found)</span>
                Uri deepLink <span class="token operator">=</span> null<span class="token punctuation">;</span>
                <span class="token keyword">if</span> <span class="token punctuation">(</span>pendingDynamicLinkData <span class="token operator">!=</span> null<span class="token punctuation">)</span> <span class="token punctuation">{</span>
                    deepLink <span class="token operator">=</span> pendingDynamicLinkData<span class="token punctuation">.</span><span class="token function">getLink</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
                <span class="token punctuation">}</span>
                <span class="token keyword">if</span> <span class="token punctuation">(</span>BuildConfig<span class="token punctuation">.</span>VERSION_CODE <span class="token operator">&lt;</span> pendingDynamicLinkData<span class="token punctuation">.</span>minimumAppVersion<span class="token punctuation">)</span> <span class="token punctuation">{</span> 
                       <span class="token function">startActivity</span><span class="token punctuation">(</span>
                            <span class="token function">Intent</span><span class="token punctuation">(</span>
                                Intent<span class="token punctuation">.</span>ACTION_VIEW<span class="token punctuation">,</span>
                                Uri<span class="token punctuation">.</span><span class="token function">parse</span><span class="token punctuation">(</span><span class="token string">"https://play.google.com/store/apps/details?id="</span> <span class="token operator">+</span> packageName<span class="token punctuation">)</span>
                            <span class="token punctuation">)</span>
                        <span class="token punctuation">)</span>
                    <span class="token punctuation">}</span>
                    <span class="token keyword">else</span> <span class="token punctuation">{</span>
                    <span class="token comment">// Handle open screen on app</span>
                    <span class="token punctuation">}</span>
            <span class="token punctuation">}</span>
        <span class="token punctuation">}</span><span class="token punctuation">)</span>
        <span class="token punctuation">.</span><span class="token function">addOnFailureListener</span><span class="token punctuation">(</span>OnFailureListener <span class="token punctuation">{</span>
                Log<span class="token punctuation">.</span><span class="token function">d</span><span class="token punctuation">(</span><span class="token string">"MainActivity"</span><span class="token punctuation">,</span> <span class="token string">"getDynamicLinks: ${it.message}"</span><span class="token punctuation">)</span>
            <span class="token punctuation">}</span><span class="token punctuation">)</span>

FirebaseDynamicLinks.getInstance()

.getDynamicLink(getIntent())

.addOnSuccessListener(this, new OnSuccessListener<PendingDynamicLinkData>() {

@Override

public void onSuccess(PendingDynamicLinkData pendingDynamicLinkData) {

// Get deep link from result (may be null if no link is found)

Uri deepLink = null;

if (pendingDynamicLinkData != null) {

deepLink = pendingDynamicLinkData.getLink();

}

if (BuildConfig.VERSION_CODE < pendingDynamicLinkData.minimumAppVersion) {

startActivity(

Intent(

Intent.ACTION_VIEW,

Uri.parse("https://play.google.com/store/apps/details?id=" + packageName)

)

}

else {

// Handle open screen on app

}

})

.addOnFailureListener(OnFailureListener {

Log.d("MainActivity", "getDynamicLinks: ${it.message}")

})

Đoạn này mình thường để trong MainActivity để ngay khi mở app sẽ xử lý điều hướng người dùng đến màn hình tương ứng.

Góc tìm bug : Khi làm việc với Dynamic Links thì mình có gặp một bug như trên stack như sau : https://stackoverflow.com/questions/47570230/how-to-solve-deep-link-enable-in-android-using-firebase

====>>> Và cách giải quyết là các bạn phải thêm thằng SHA256 vào chỗ setting nhé, thêm như này nài; https://support.google.com/firebase/answer/9137403?hl=en

Trên đây là những kiến thức về Dynamic Links mà mình học được, chúc mọi người code vui vẻ!

Tài liệu tham khảo:

Firebase docs: https://firebase.google.com/docs/dynamic-links

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo