谷歌商店安裝來源追蹤Play Install Referrer API

項目上線到google市場,但是推廣人員有在百度和頭條上面投放廣告,需要統計下載渠道,這個時候就需要使用Google Play 廣告系列衡量功能

1.用戶通過手機瀏覽器點擊帶有referrer的Url(如https://play.google.com/store/apps/details?id=com.xxx.xxx&referrer=test) （正常此網頁下方在Play商店打開）

2.當您的應用在 Google Play 商店中被下載時，Play 商店應用會在您的應用安裝期間向其廣播一條 INSTALL_REFERRER Intent。如果將用戶引薦到您應用的 Google Play 商店頁面的鏈接中有 referrer 參數，此 Intent 就會包含這個參數的值。
爲了將某次應用下載歸因到某個廣告系列，您需要在指向 Google Play 商店的所有鏈接中添加 referrer 參數，並在您的應用中添加一個 BroadcastReceiver，以便使用您的 Google Analytics（分析）跟蹤器來接收並設置 Intent 中所包含的廣告系列信息。

我們建議大多數開發者使用 SDK 中提供的 BroadcastReceiver。要使用此內置接收器實現 Google Play 商店廣告系列衡量功能，請執行以下操作：

<application>
    <!-- Used for Google Play Store Campaign Measurement-->
    <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver"
        android:enabled="true"
        android:exported="true">
        <intent-filter>
            <action android:name="com.android.vending.INSTALL_REFERRER" />
        </intent-filter>
    </receiver>
    <service android:name="com.google.android.gms.analytics.CampaignTrackingService"
        android:enabled="true"
        android:exported="false" />
</application>

接下來，請將 referrer 參數添加到直接指向 Google Play 商店的所有網址，並將該參數的值設置爲用來描述來源的 Google Analytics（分析）廣告系列參數字符串，如下例所示：

https://play.google.com/store/apps/details?id=com.example.application
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3Dlogolink
%26utm_campaign%3Dspring_sale

要了解如何構建廣告系列參數字符串，請使用 Google Play 網址構建工具，或參閱廣告系列參數一節

測試,使用adb工具

adb shell am broadcast -a com.android.vending.INSTALL_REFERRER -n "com.XXX.XXXX/gw.com.android.ui.broadcast.InstallReferrerReceiver" --es "referrer" "utm_source%3Dbaidu%26utm_medium%3D111%26utm_term%3D222%26utm_content%3D333%26utm_campaign%3D444%26anid%3Dadmob"

說如果配置正確的話就會返回

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

上線Google play獲取參數

 public class TrackingReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        /**
utm_source=google&utm_medium=cpc&utm_term=test1&utm_content=test2&utm_campaign=test3&anid=admob
         * anid:廣告網絡
         * utm_source:廣告系列來源(原始引薦來源，例如 google、citysearch、newsletter4)
         * utm_medium:廣告系列媒介(營銷媒介，例如 cpc、banner、email)
         * utm_term:廣告系列字詞(付費關鍵字，例如 running+shoes)
         * utm_content:廣告系列內容(廣告特有的內容，用於區分不同的廣告)
         * utm_campaign:廣告系列名稱(產品、促銷代碼或標語)
         */
        String referrer = intent == null ? null : intent.getStringExtra("referrer");
        Log.d("ga_referrer", referrer == null ? "null" : referrer);

        com.google.android.gms.analytics.CampaignTrackingReceiver googleReceiver = new com.google.android.gms.analytics.CampaignTrackingReceiver();
        googleReceiver.onReceive(context, intent);
    

但是注意:

以上方案有問題,據說是Play Store 8.幾之前才支持,而且在Google2020年已經停止使用了,所以使用替代方案(Play Install Referrer API),這個方案在google分析文檔中爲測試方案,但是親測可用:
註明:Google Play要求在2020年3月1日前切換到Play Install Referrer API

public class InstallReferrerUtil {

    private final static String INSTALL_REFERRER = "com.android.vending.INSTALL_REFERRER";

    public static void setup(Context context) {
        InstallReferrerClient client = InstallReferrerClient.newBuilder(context)
                .build();
        client.startConnection(new InstallReferrerStateListener() {
            @Override
            public void onInstallReferrerSetupFinished(int responseCode) {
                if (responseCode == InstallReferrerClient.InstallReferrerResponse.OK) {
                    try {
                        ReferrerDetails details = client.getInstallReferrer();
                        String referrer = details.getInstallReferrer();
                        if (!TextUtils.isEmpty(referrer)) {
                            SharedPrefUtils.getInstance().putJReferrer(referrer);
                            Intent referrerReceived = new Intent(INSTALL_REFERRER);
                            referrerReceived.putExtra("referrer", referrer);
                            //向App本身其他Receiver廣播
                            Iterator var8 = context.getPackageManager().queryBroadcastReceivers(new Intent(INSTALL_REFERRER), 0).iterator();
                            while (var8.hasNext()) {
                                ResolveInfo var4 = (ResolveInfo) var8.next();
                                String var5 = referrerReceived.getAction();
                                if (var4.activityInfo.packageName.equals(context.getPackageName()) && INSTALL_REFERRER.equals(var5) && !this.getClass().getName().equals(var4.activityInfo.name)) {
                                    BuglyLog.e("onReceive:class:", (new StringBuilder("trigger onReceive: class: ")).append(var4.activityInfo.name).toString() + "");
                                    try {
                                        ((BroadcastReceiver) Class.forName(var4.activityInfo.name).newInstance()).onReceive(context, referrerReceived);
                                    } catch (Throwable var6) {
                                        BuglyLog.e("onReceive:class:", (new StringBuilder("error in BroadcastReceiver ")).append(var4.activityInfo.name).toString(), var6);
                                    }
                                }
                            }
                        }
                        AndroidSchedulers.mainThread().createWorker().schedule(() -> CrashReport.postCatchedException(new Throwable("referral:" + referrer)));
                    } catch (RemoteException e) {
                        // omit exception
                        AndroidSchedulers.mainThread().createWorker().schedule(() -> CrashReport.postCatchedException(new Throwable("RemoteException:" + e.getMessage())));
                    }
                }
            }
            @Override
            public void onInstallReferrerServiceDisconnected() {
                AndroidSchedulers.mainThread().createWorker().schedule(() -> CrashReport.postCatchedException(new Throwable("referral:onInstallReferrerServiceDisconnected")));
            }
        });
    }
}

細心的朋友可能注意到了,在有一些手機上面不管怎麼配置可能就是會出現
utm_source=(not%20set)&utm_medium=(not%20set)的情況

這裏有幾點要注意

1.需要使用vpn,能夠正常從Google play下載其他app,保證手機已經開啓了Google服務等.
2.測試的時候,最好使用之前沒有下載過集成統計APP的賬號.網上有人說可能獲取不到渠道等信息.
3.如果還是不行,可以考慮使用非大陸的地區直接測試,親測有效