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

介绍:

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

官网:

  1. Google Install Referrer API

  1. Google Play 网址构建工具

  1. Facebook App Ads Referral

  1. Facebook App管理平台

要求:

  1. 解决网络问题。(您懂得)

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

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

  1. 手机需要安装了 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。会报空指针。

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

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

Facebook App Ads Referral Key的获取:

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

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

猜你喜欢

转载自blog.csdn.net/hzqit520/article/details/128624927