如何將Firebase Analytics添加到NativeScript移動(dòng)應(yīng)用程序中

當(dāng)您想要盡快發(fā)布移動(dòng)應(yīng)用時(shí)，我們都知道這一點(diǎn)。 你工作了幾個(gè)月，經(jīng)過(guò)測(cè)試，它看起來(lái)不錯(cuò)，而你的重要人物甚至喜歡它。 您和已發(fā)布的應(yīng)用之間需要做的最后一件事是更多的工作。 然而，為您的應(yīng)用添加分析是一項(xiàng)值得投資的工作。只需半小時(shí)的工作，您就會(huì)知道用戶需要什么，如何滿足他們的需求，以及在哪里投入寶貴的開(kāi)發(fā)時(shí)間。

先決條件

在開(kāi)始之前，您需要使用自己的Google帳戶創(chuàng)建新的Firebase應(yīng)用程序。 只需點(diǎn)擊幾下即可實(shí)現(xiàn)。 Firebase提供免費(fèi)套餐，涵蓋了所有Google Analytics服務(wù)，因此您無(wú)需取出信用卡。 導(dǎo)航至 https://firebase.google.com ，使用您的Google憑據(jù)進(jìn)行身份驗(yàn)證，然后按照“添加項(xiàng)目”向?qū)нM(jìn)行操作。 通常，除非您具有與“分析”以外的服務(wù)相關(guān)的特定要求，否則您無(wú)需更改“步驟3”中的任何默認(rèn)選項(xiàng)。

在新創(chuàng)建的項(xiàng)目中，您必須導(dǎo)航到項(xiàng)目設(shè)置并添加iOS和Android應(yīng)用程序。 對(duì)于iOS中的Bundle ID或Android中的Package名稱，請(qǐng)使用 NativeScript應(yīng)用程序中 applicationId 設(shè)置 的 屬性 值 package.json 。 因此，您應(yīng)該擁有 GoogleServices-Info.plist 和 google-services.json 文件。 這些文件包含F(xiàn)irebase SDK用于將用戶交互與Google Analytics項(xiàng)目正確關(guān)聯(lián)的配置屬性。 您可以安全地跳過(guò)有關(guān)如何添加Firebase SDK以及如何向應(yīng)用添加初始化代碼的說(shuō)明，因?yàn)榇嗽O(shè)置將由插件處理。 以下是該過(guò)程對(duì)iOS的看法（Android非常相似）：

建立

首先，您需要安裝 nativescript-plugin-firebase 插件。 按照 Eddy Vebruggen（這個(gè)很棒的插件的作者）提供 的 安裝步驟 進(jìn)行操作。 你需要把 GoogleServices-Info.plist 該文件 App_Resources/iOS 夾以及 google-services.json 中 App_Resources/Android 的文件夾。 firebase.nativescript.json 一旦完成插件的安裝， 一個(gè)附加文件 將添加到項(xiàng)目的根目錄中。 在安裝過(guò)程中，您必須回答幾個(gè)有關(guān)您計(jì)劃使用的Firebase插件部分的問(wèn)題。 輸出是一個(gè) firebase.nativescript.json 文件，看起來(lái)應(yīng)該類似于：

{

“using_ios”：是的，

“using_android”：是的，

“firestore”：假的，

“realtimedb”：虛假，

“remote_config”：false，

“消息”：虛假，

“崩潰”：真的，

“crash_reporting”：false，

“存儲(chǔ)”：錯(cuò)誤，

“facebook_auth”：false，

“google_auth”：false，

“admob”：假的，

“邀請(qǐng)”：假，

“dynamic_links”：false，

“ml_kit”：false

}

注意： 您絕不應(yīng)將GoogleServices-Info.plist和google-services.json文件提交到公共存儲(chǔ)庫(kù)。 它們包含您的秘密，如果沒(méi)有得到適當(dāng)保護(hù)，其他人將能夠利用您帳戶中的數(shù)據(jù)。 理想情況下，應(yīng)該通過(guò)CI基礎(chǔ)結(jié)構(gòu)為生產(chǎn)構(gòu)建插入構(gòu)建時(shí)間。

下一步是在應(yīng)用程序中初始化插件。 最合適的地方是 Angular應(yīng)用程序 的 根組件  ，如 啟動(dòng)接線說(shuō)明中所述 。 它很簡(jiǎn)單：

app.component.ts

導(dǎo)入 *  的 火力 從 “nativescript-插件，火力點(diǎn)” ;

...

ngOnInit（）：void {

firebase。init（{

          }）。然后（

            instance  => {

              控制臺(tái)。log（“firebase.init done”）;

            }，

            error  => {

              控制臺(tái)。log（`firebase.init error：$ { error } `）;

            }

          ）;

};

如果您使用的是{N}核心框架，則可以使用該應(yīng)用程序的啟動(dòng)事件并附加到該框架：

app.js

申請(qǐng)。上（應(yīng)用。launchEvent，（ARGS）=> {

    firebase。init（{

          }）。然后（

            instance  => {

              控制臺(tái)。log（“firebase.init done”）;

            }，

            error  => {

              控制臺(tái)。log（`firebase.init error：$ { error } `）;

            }

          ）;

    };

}）;

完成安裝后，運(yùn)行 tns run 命令。 當(dāng)您的應(yīng)用程序在您的設(shè)備上啟動(dòng)時(shí)，您應(yīng)該會(huì)在Google Analytics信息中心的“最近30分鐘內(nèi)的用戶”磁貼中看到一些動(dòng)作。 車輪開(kāi)始旋轉(zhuǎn)的另一個(gè)跡象是，一旦第一個(gè)數(shù)據(jù)被注冊(cè)，iOS和Android項(xiàng)目旁邊的紅點(diǎn)就會(huì)消失：

完成所有這些后，您已經(jīng)領(lǐng)先于游戲，并且比Android和iOS開(kāi)發(fā)人員控制臺(tái)中的曝光更具洞察力。 火力地堡將開(kāi)始跟蹤一些事件為你的盒子，如：   first_open ，   screen_view ，和   session_start   （名單與自動(dòng)跟蹤的事件，可以發(fā)現(xiàn) 在文檔中 ）。 它還會(huì)報(bào)告有關(guān)您的用戶的一些人口統(tǒng)計(jì)信息 - 他們所在的國(guó)家/地區(qū)，性別，年齡，興趣，他們使用的設(shè)備以及他們未使用的設(shè)備。 此外，您的用戶將自動(dòng)報(bào)告為新用戶或返回用戶。 這將使您更好地了解您的受眾及其興趣，并調(diào)整您的應(yīng)用程序，使其更具吸引力。 您可以使用該 setUserProperty   方法 輕松地為用戶添加其他信息，   并進(jìn)一步將用戶群劃分為多個(gè)細(xì)分。

跟蹤頁(yè)面視圖

雖然Firebase會(huì) screen_view 自動(dòng) 跟蹤名為“  ”的 事件 ，但由于NativeScript的體系結(jié)構(gòu)，它們不會(huì)非常有用。 所有用戶的約定都將在Android的一個(gè)Activity或iOS的ViewController中報(bào)告。 因此，為了更好地理解我們的應(yīng)用程序的使用方式，我們需要實(shí)現(xiàn)一個(gè)自定義事件，并添加一些屬性。

出于本文的目的，我將此類活動(dòng)稱為“頁(yè)面瀏覽量”。 這個(gè)術(shù)語(yǔ)可能很模糊，根據(jù)您的應(yīng)用程序，具體細(xì)節(jié)可能意味著不同的東西。 此外，我們不僅要跟蹤頁(yè)面被查看，還要跟蹤哪個(gè)頁(yè)面，以便我們可以分析哪些頁(yè)面最有用。

所有這些都可以使用nativescript-plugin-firebase插件公開(kāi)的API輕松實(shí)現(xiàn)。 分析對(duì)象提供了   logEvent   完全符合我們需要的方法。 這是一個(gè)示例代碼段：

導(dǎo)入 *  的 火力 從 “nativescript-插件，火力點(diǎn)” ;

...

firebase。分析。logEvent（{

    key：“page_view”，

    參數(shù)：[

           {

                key：“page_id”，

                價(jià)值：“家”

           }

           //如果需要，可在此處添加其他參數(shù)

    ]

}）;

這將記錄一個(gè)名為“  page_view ”  的事件 ，其參數(shù)“  page_id ”的值為“  Home ”。 一種方法是在每個(gè)Component初始化時(shí)添加手動(dòng)調(diào)用。 這將是一項(xiàng)非常繁瑣且容易出錯(cuò)的任務(wù)，我們可以做得比這更好。 讓我們利用Angular路由器公開(kāi)的事件并在那里記錄事件，如下所示：

app.component.ts

這個(gè)。路由器。事件

    。pipe（filter（（event：any）=>  事件 instanceof  NavigationEnd））

    。subscribe（（event：NavigationEnd）=> {

        firebase。分析。logEvent（{

            key：“page_view”，

            參數(shù)：[{

                key：“page_id”，

                價(jià)值：事件。urlAfterRedirects

            }]

        }）;

    }）;

注意： 如果您使用的是{N}核心框架，則可以使用該  navigatedTo 事件并實(shí)現(xiàn)類似的邏輯。

這將使用URL作為   page_id   值。 在大多數(shù)情況下，它可以很好地表示訪問(wèn)哪些URL以及訪問(wèn)頻率。 當(dāng)然，如果您的URL架構(gòu)不合適，您可以滿足您的需求。

一個(gè)缺陷是您需要在開(kāi)始使用之前在Firebase控制臺(tái)中注冊(cè)參數(shù)。 要執(zhí)行此操作，請(qǐng)?jiān)贔irebase控制臺(tái)中打開(kāi)項(xiàng)目，打開(kāi)“事件”屏幕，單擊“  page_view ”事件并顯示“添加事件參數(shù)”按鈕。 從那里，添加您要跟蹤的參數(shù) - 在我們的例子中，這是'  page_id 。'

此時(shí)，您將了解應(yīng)用程序的哪些部分最有用。 通過(guò)此添加，您將獲得用戶的完整地圖以及他們與您的移動(dòng)應(yīng)用互動(dòng)的方式。 以下是它在Firebase控制臺(tái)中的外觀：

跟蹤轉(zhuǎn)化

根據(jù)應(yīng)用程序的用途，您可能需要跟蹤轉(zhuǎn)換的不同內(nèi)容。 默認(rèn)情況下，有ecommerce_purchase和in_app_purchase等事件。 您可以將任何現(xiàn)有事件標(biāo)記為轉(zhuǎn)換，具體取決于用戶的流程和業(yè)務(wù)邏輯。 要執(zhí)行此操作，只需導(dǎo)航到“轉(zhuǎn)換”屏幕并按照“新建轉(zhuǎn)換事件”向?qū)нM(jìn)行操作。

此外，您還可以創(chuàng)建渠道來(lái)跟蹤轉(zhuǎn)化的進(jìn)展情況，并確定用戶旅程中需要改進(jìn)的區(qū)域。 這也是從漏斗屏幕很容易實(shí)現(xiàn)的。

作為一個(gè)非常簡(jiǎn)單的例子，我準(zhǔn)備 了一個(gè)示例應(yīng)用程序 。 在主頁(yè)上，有兩個(gè)按鈕：“添加到購(gòu)物車”和“購(gòu)買”。 “購(gòu)買”按鈕將使用Firebase考慮轉(zhuǎn)化的其中一個(gè)內(nèi)置密鑰記錄新事件，稱為“ecommerce_purchase”。 另一個(gè)按鈕“添加到購(gòu)物車”正在記錄一個(gè)名為“add_to_cart”的新事件，我可以將其標(biāo)記為來(lái)自Firebase控制臺(tái)的轉(zhuǎn)換。 通過(guò)這種方式，我可以輕松構(gòu)建一個(gè)漏斗來(lái)跟蹤我的轉(zhuǎn)化，例如“first_open” - >“add_to_cart” - >“ecommerce_purchase”。 這將讓我深入了解我應(yīng)該在哪里改善用戶體驗(yàn)和轉(zhuǎn)化。 以下是漏斗在采取這些步驟后可以看到的方式：

顯然，現(xiàn)在我的虛擬漏斗中有一些東西需要解決！

故障排除

從Firebase控制臺(tái)中無(wú)法立即看到從您的應(yīng)用程序記錄的事件。 數(shù)據(jù)最多可能需要24小時(shí)才能獲得。 根據(jù)我的經(jīng)驗(yàn)，至少需要幾個(gè)小時(shí)。 這可能會(huì)使調(diào)試變得困難，因?yàn)槟仨毜却荛L(zhǎng)時(shí)間才能測(cè)試更改。

幸運(yùn)的是，F(xiàn)irebase控制臺(tái)中有一個(gè)名為“DebugView”的視圖。 您需要為您的應(yīng)用程序或設(shè)備啟用它，然后，一旦報(bào)告，您的設(shè)備上的事件就會(huì)立即顯示。 對(duì)于Android，這就像運(yùn)行一樣簡(jiǎn)單：

adb shell setprop debug.firebase.analytics.app <packageName，like：org.nativescript.nativescriptanalyticssample>

對(duì)于iOS，您必須在XCode中打開(kāi)項(xiàng)目并添加 -FIRDebugEnabled   要在啟動(dòng)時(shí)傳遞 的   參數(shù)。 有關(guān)如何實(shí)現(xiàn)此目標(biāo)的更多信息，請(qǐng)參閱 Firebase文檔 。

摘要

總而言之，添加Google Analytics非常簡(jiǎn)單，讓您更聰明，可以節(jié)省您的時(shí)間和金錢，而且絕對(duì)沒(méi)有理由不開(kāi)始這樣做。 Firebase免費(fèi)提供優(yōu)質(zhì)功能，但您還可以瀏覽其他優(yōu)秀的Google Analytics服務(wù)。 您需要做的最難的事情是考慮應(yīng)用程序成功的含義并定義如何衡量它。 實(shí)際測(cè)量現(xiàn)在很容易。