实现 Google Play 广告系列归因

当您的应用在 Google Play 商店中被下载时，Play 商店应用会在您的应用安装期间向其广播一条 INSTALL_REFERRER Intent。如果将用户引荐到您应用的 Google Play 商店页面的链接中有 referrer 参数，此 Intent 就会包含这个参数的值。

为了将某次应用下载归因到某个广告系列，需要在指向 Google Play 商店的所有链接中添加 referrer 参数，并在应用中添加一个 BroadcastReceiver，以便跟踪器来接收并设置 Intent 中所包含的广告系列信息。
开发者可以自己实现自定义 BroadcastReceiver来统计广告信息，也可以使用谷歌官方提供的SDK统计，具体的实现方式如下：

1. 创建广播接收器CampaignTrackingReceiver，获取广告参数并处理：

public class CampaignTrackingReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        //处理referrer参数
        String referrer;
        if (intent != null) {
            referrer = intent.getStringExtra("referrer");
            // 得到相应的广告信息 是url 参数格式，需要解析
            // 格式： utm_source=testSource&utm_medium=testMedium&utm_term=testTerm&utm_content=11
            Store.setReferrer(referrer);
            Store.setReferrerTimestamp(System.currentTimeMillis() + "");
        }

    }
}

2. 将接收器添加到AndroidMainfest.xml文件：

<!-- 广告归因 -->
        <receiver android:name=".CampaignTrackingReceiver"
            android:enabled="true"
            android:exported="true">
            <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
            </intent-filter>
        </receiver>

测试 Google Play 广告系列归因

1. 已在谷歌应用市场发布，可在应用市场下载测试，或者使用广告URL：

https://play.google.com/store/apps/details?id=com.example.application&referrer=utm_source%3DtestSource%26utm_medium%3DtestMedium%26utm_term%3DtestTerm%26utm_content%3DtestContent%26utm_campaign%3DtestCampaign

2. 使用adb工具，模拟发送广播：

adb shell am broadcast -a com.android.vending.INSTALL_REFERRER -n "包名/CampaignTrackingReceiver路径" --es "referrer" "utm_source%3DtestSource%26utm_medium%3DtestMedium%26utm_term%3DtestTerm%26utm_content%3DtestContent%26utm_campaign%3DtestCampaign"

发送成功会返回：

Broadcasting: Intent { act=com.android.vending.INSTALL_REFERRER cmp=[包名]/[CampaignTrackingReceiver路径] (has extras) } Broadcast completed: result=0

广告系列参数

广告系列参数用于传递将用户带到您的应用中的流量来源和广告系列的相关信息。

下表列出了可用的广告系列参数，这些参数可用于 Google Play 广告系列衡量或常规广告系列衡量：