介绍:
由于需要精准的获取投放广告的数据(投放的平台,防止数据的丢失等)。我们使用了Google Play Install Referrer API 和Facebook App Ads Referral结合采集数据,然后通过后台服务记录数据。最后服务器记录的数据与Facebook提供的数据对比,检查数据的真实性、丢包概况等。最后得出结论可以用于后续运营策略。
官网:
要求:
解决网络问题。(您懂得)
需要有Google Play 管理中心帐号。
需要有Facebook 管理中心帐号。
手机需要安装了 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 获取安装引荐来源
提示:
使用try catch。installVersion有可能会为null。会报空指针。
Log打印的地方,就是将response.installReferrer(已加密)结果传给后端。然后后端通过Facebook解密。得到投放广告的数据。
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应用商店)
如果Google Play 应用商店 已经有自己应用的情况下:可以在模拟广告链接的时候把自己的应用包名填上去。点击广告投放链接进入到应用商店,点击安装。然后再取消安装。然后再本地项目中运行到手机上。最后安装成功后启动应用就会有InstallReferrerClient信息。
如果Google Play 应用商店 没有自己应用的情况下:我们需要把我们的应用包名改成应用商店已有的应用包名。我当前项目模拟的时候就是使用UC的包名(com.UCMobile.intl)。然后点击广告投放链接进入到应用商店,点击安装。然后再取消安装。然后再本地项目中运行到手机上。最后安装成功后启动应用就会有InstallReferrerClient信息。
Facebook App Ads Referral Key的获取:
需要自己在Facebook App管理平台添加一个应用。
在应用的 设置-> 基本 -> Google Play 中可以找到。如下图:
![](https://img-blog.csdnimg.cn/img_convert/4f81311a028e57656a76b2da4c10e3d5.png)