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

不念不忘少年蓝@ 2023-09-28 23:56 4阅读 0赞

### 介绍： ###

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

#### 官网： ####

1.  [Google Install Referrer API][]

1.  [Google Play 网址构建工具 ][Google Play _]

1.  [Facebook App Ads Referral][]

1.  [Facebook App管理平台][Facebook App]

#### 要求： ####

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

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

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

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

#### 集成前的准备 ####

模拟广告链接：可以通过[Google Play 网址构建工具][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。会报空指针。

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

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

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

#### Facebook App Ads Referral Key的获取： ####

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

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

![4f81311a028e57656a76b2da4c10e3d5.png][]

[Google Install Referrer API]: https://developer.android.com/google/play/installreferrer
[Google Play _]: https://developers.google.com/analytics/devguides/collection/android/v4/campaigns
[Facebook App Ads Referral]: https://developers.facebook.com/docs/app-ads/install-referrer/
[Facebook App]: https://developers.facebook.com/apps
[Google Play]: https://play.google.com/store/apps
[4f81311a028e57656a76b2da4c10e3d5.png]: https://img-blog.csdnimg.cn/img_convert/4f81311a028e57656a76b2da4c10e3d5.png