Google Play Install Referrer API 和 Facebook App Ads Referral 集成

介绍：

由于需要精准的获取投放广告的数据（投放的平台，防止数据的丢失等）。我们使用了Google Play Install Referrer API 和Facebook App Ads Referral结合采集数据，然后通过后台服务记录数据。最后服务器记录的数据与Facebook提供的数据对比，检查数据的真实性、丢包概况等。最后得出结论可以用于后续运营策略。

官网：

1. Google Install Referrer API

2. Google Play 网址构建工具

3. Facebook App Ads Referral

4. Facebook App管理平台

要求：

1. 解决网络问题。（您懂得）

2. 需要有Google Play 管理中心帐号。

3. 需要有Facebook 管理中心帐号。

4. 手机需要安装了 Google Play 应用版本 8.3.73 或更高版本的设备自动提供该 API。

集成前的准备

模拟广告链接：可以通过Google Play 网址构建工具生成。

我模拟生成的如下：

https://play.google.com/store/apps/details?id=com.UCMobile.intl&referrer=utm_source%3Dtaobao%26utm_medium%3Dbanner%26utm_term%3Drunning%26utm_content%3D%25E6%2588%2591%25E6%2598%25AF%25E5%25B0%258F%25E5%25BC%25BA%26utm_campaign%3D%25E6%2595%25B2%25E4%25BB%25A3%25E7%25A0%2581%25E7%259A%2584%25E5%25B0%258F%25E5%25BC%25BA%26anid%3Dadmob

Google Play Install Referrer API集成：

将以下行添加到应用的 build.gradle 文件的依赖项部分：

dependencies {
    implementation "com.android.installreferrer:installreferrer:2.2"
}

连接到 Google Play 获取安装引荐来源

提示：

1. 使用try catch。installVersion有可能会为null。会报空指针。

2. Log打印的地方，就是将response.installReferrer（已加密）结果传给后端。然后后端通过Facebook解密。得到投放广告的数据。

3. response.installReferrer返回的是已经加密的数据，需要解密需要拿到Facebook秘钥key解密。（下面会介绍到key的位置）

package com.UCMobile.intl

import android.content.Context
import android.util.Log
import com.android.installreferrer.api.InstallReferrerClient
import com.android.installreferrer.api.InstallReferrerStateListener
import com.android.installreferrer.api.ReferrerDetails

/**
 * @author 小强
 *
 * @time 2023/1/9  15:25
 *
 * @desc Google Play Install Referrer API库
 *
 */
class InstallReferrer {


    /**
     * 初始化Play Install Referrer 库
     */
     fun initReferrerClient(context : Context) {

        //启动并与 Play 商店应用的连接
        val referrerClient : InstallReferrerClient = InstallReferrerClient.newBuilder(context).build()

        referrerClient.startConnection(object : InstallReferrerStateListener {
            //onInstall Referrer安装完成
            override fun onInstallReferrerSetupFinished(responseCode : Int) {
                when (responseCode) {
                    InstallReferrerClient.InstallReferrerResponse.OK -> {
                        try {
                            //连接已建立后获取安装引荐来源
                            val response : ReferrerDetails = referrerClient.installReferrer
                            //已安装软件包的引荐来源网址。
                            val referrerUrl : String = response.installReferrer
                            //引荐来源网址点击事件发生时的客户端时间戳（以秒为单位）。
                            val referrerClickTime : Long = response.referrerClickTimestampSeconds
                            //应用安装开始时的客户端时间戳（以秒为单位）。
                            val appInstallTime : Long = response.installBeginTimestampSeconds
                            //引荐来源网址点击事件发生时的服务器端时间戳（以秒为单位）。
                            val appServerTime : Long = response.referrerClickTimestampServerSeconds
                            //首次安装应用时的应用版本。
                            val installVersion : String = response.installVersion
                            //表明应用的免安装体验是否为过去 7 天内发布的。
                            val instantExperienceLaunched : Boolean = response.googlePlayInstantParam
                            
                            //断开服务连接(断开连接将有助于避免出现泄露和性能问题。)
                            referrerClient.endConnection()

                            Log.e("hzq", "推荐url-->" + referrerUrl)
                            Log.e("hzq", "推荐点击事件发生时的时间戳(单位是秒)-->" + referrerClickTime)
                            Log.e("hzq", "app安装时间时间戳(单位是秒)-->" + appInstallTime)
                            Log.e("hzq", "服务器端时间戳(单位是秒)-->" + appServerTime)
                            Log.e("hzq", "首次安装应用时的应用版本-->" + installVersion)
                            Log.e("hzq", "免安装体验是否过去7天内发布的-->" + instantExperienceLaunched)

                        } catch (e : Exception) {

                        }

                    }
                    InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED -> {
                        //当前Play Store应用程序上没有API。
                    }
                    InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
                        //无法建立连接。
                    }
                }
            }

            //onInstall Referrer服务已断开连接
            override fun onInstallReferrerServiceDisconnected() {
                Log.e("hzq", "onInstall Referrer服务已断开连接")
                //尝试在下次请求时重新启动连接
                //通过调用startConnection（）方法来Google Play。
            }
        })
    }
}

打印结果：

 response-->com.android.installreferrer.api.ReferrerDetails@f2f9a14
 推荐url-->utm_source=%E6%B7%98%E5%AE%9D&utm_medium=banner&utm_term=%E5%B0%8F%E5%BC%BA&utm_content=%E6%88%91%E6%98%AF%E5%B0%8F%E5%BC%BA&utm_campaign=%E6%95%B2%E4%BB%A3%E7%A0%81%E7%9A%84%E5%B0%8F%E5%BC%BA&anid=admob
 推荐点击事件发生时的时间戳(单位是秒)-->1673259864
 app安装时间时间戳(单位是秒)-->1673259870
 服务器端时间戳(单位是秒)-->1673259863
 首次安装应用时的应用版本-->13.4.0.1306
 免安装体验是否过去7天内发布的-->false

重点：模拟安装测试（手机应用必须需要有Google Play应用商店）

1. 如果Google Play 应用商店 已经有自己应用的情况下：可以在模拟广告链接的时候把自己的应用包名填上去。点击广告投放链接进入到应用商店，点击安装。然后再取消安装。然后再本地项目中运行到手机上。最后安装成功后启动应用就会有InstallReferrerClient信息。

2. 如果Google Play 应用商店 没有自己应用的情况下：我们需要把我们的应用包名改成应用商店已有的应用包名。我当前项目模拟的时候就是使用UC的包名（com.UCMobile.intl）。然后点击广告投放链接进入到应用商店，点击安装。然后再取消安装。然后再本地项目中运行到手机上。最后安装成功后启动应用就会有InstallReferrerClient信息。

Facebook App Ads Referral Key的获取：

1. 需要自己在Facebook App管理平台添加一个应用。

2. 在应用的 设置-> 基本 -> Google Play 中可以找到。如下图：