android 集成Play Install Referrer

android 集成Play Install Referrer

旧版

在之前集成Google广告归因是采用广播的形式，定义一个匹配INSTALL_REFERRER的广播接收器：

   <receiver
            android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"
            android:enabled="true"
            android:exported="true">
            <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
            </intent-filter>
        </receiver>

或者自己定义一个也是可以的。
旧版其中逻辑就是，Google Play提供了这么一个广播机制，利用归因网址创建器生成网址—google-play-url-builder。生成一个地址后，打开链接会到google-play对于的app下载页面（也可以通过网页的play商店推送至app），在用户下载后发送一条携带归因参数的广播到app，完成信息的采集。

相关介绍

归因网址创建器介绍：

例如，生成的网址：
https://play.google.com/store/apps/details?id={你的包名}&referrer=utm_source%3Dtaobao%26utm_medium%3Dbanner%26utm_term%3Drunning%26utm_content%3Ddebug%26anid%3Dadmob

广告参数介绍：

新版-Play Install Referrer

由于广播的不可靠性和不安全性，其他app可以偷偷摸摸主动发送INSTALL_REFERRER广播去抢归因，完全就说欺诈行为。才有新版的Play Install Referrer。
新版的逻辑是用户点击推广链接到应用市场安装APP，应用市场就会获取推广参数传递，APP安装后，首次打开的时APP就会主动通过应用市场的API去查询获取渠道信息，然后上传。之间的通信是采用AIDL语言来实现的，可靠又安全。

集成也很简单：
app下的build.gradle下配置：

implementation "com.android.installreferrer:installreferrer:2.2"

在启动的时候去监听：

 private lateinit var referrerClient: InstallReferrerClient
    private fun installReferrer(){
        referrerClient = InstallReferrerClient.newBuilder(this).build()
        referrerClient.startConnection(object : InstallReferrerStateListener {

            override fun onInstallReferrerSetupFinished(responseCode: Int) {
                when (responseCode) {
                    InstallReferrerClient.InstallReferrerResponse.OK -> {
                        // Connection established.
                        val response = referrerClient.installReferrer
                        ZusLog.myLog("referrerClient url: ${response.installReferrer}")
                        ZusLog.myLog("referrerClient click: ${response.referrerClickTimestampSeconds.toString()}")
                        ZusLog.myLog("referrerClient click-server: ${response.referrerClickTimestampServerSeconds}")
                        ZusLog.myLog("referrerClient install: ${response.installBeginTimestampSeconds.toString()}")
                        ZusLog.myLog("referrerClient install-server: ${response.installBeginTimestampServerSeconds}")

                        ZusLog.myLog("referrerClient version: ${response.installVersion}")

                        referrerClient.endConnection()
                    }
                    InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED -> {
                        // API not available on the current Play Store app.
                    }
                    InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
                        // Connection couldn't be established.
                    }
                }
            }

            override fun onInstallReferrerServiceDisconnected() {

            }
        })
    }

然后调用完成即可关闭了。我这里仅打印log，一般是要埋点的。

测试结果：

url: utm_source=taobao&utm_medium=banner&utm_term=running&utm_content=debug&anid=admob
 click: 1627635033
 click-server: 1627635034
 install: 1627635036
 install-server: 1627635036
 version: 7.12.0

再卸载后，直接adb安装，测试结果：

url: utm_source=google-play&utm_medium=organic
click: 0
click-server: 0
install: 1627635036
install-server: 1627635036
version: 7.12.0 

其实我adb安装的包，版本为7.13.0，google商店的线上包为7.12.0，所以这个版本信息还是以Google-play 的版本号为主。

覆盖安装测试：安装时间还是第一次安装的时间。
卸载后安装后还是重google play 打开 安装时间还是上次。
卸载后，重新打开新的链接安装，安装时间为当前。

如何测试？

由于链接是到google商店的，而上面对应的可能是没有Play Install Referrer代码，这里提供两种方法：1，打测试人员的包测试。2，链接到google商店后，点击安装进行下载，同时在用adb安装含Play Install Referrer代码的包，再取消google上面的下载就行了。