android-GooglePlay安装来源追踪PlayInstallReferrer


title: android-GooglePlay安装来源追踪PlayInstallReferrer
categories: Android
tags: [android, referrer, googleplay]
date: 2020-07-22 15:28:59
comments: false
mathjax: true
toc: true

android-PlayInstallReferrer来源追踪, 也就是 Google Play 安装来源追踪.


前篇

  • https://developer.android.com/google/play/installreferrer?hl=zh_CN
  • https://developer.android.com/google/play/installreferrer/library?hl=zh_CN#java

接入

  1. 模块级 build.gradle 引入库 installreferrer

    dependencies {
    	...
        implementation 'com.android.installreferrer:installreferrer:1.1'
    }
    
  2. GoogleReferrerHelper.java

    package com.purestlake.vivo;
    
    import android.content.Context;
    import android.os.RemoteException;
    import android.util.Log;
    
    import com.android.installreferrer.api.InstallReferrerClient;
    import com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse;
    import com.android.installreferrer.api.InstallReferrerStateListener;
    import com.android.installreferrer.api.ReferrerDetails;
    
    import org.json.JSONObject;
    
    import java.util.HashMap;
    import java.util.Map;
    
    public class GoogleReferrerHelper {
        private static GoogleReferrerHelper instance = null;
    
        public static GoogleReferrerHelper getIns() {
            if (instance == null) {
                instance = new GoogleReferrerHelper();
            }
            return instance;
        }
    
        private static final String TAG = "--- ReferrerHelper";
        private InstallReferrerClient mReferrerClient;
    
        public void start(Context context) {
            Log.d(TAG, "start");
            if (mReferrerClient != null) {
                end();
            }
            mReferrerClient = InstallReferrerClient.newBuilder(context).build();
            mReferrerClient.startConnection(new InstallReferrerStateListener() {
                @Override
                public void onInstallReferrerSetupFinished(int responseCode) {
                    Log.d(TAG, String.format("onInstallReferrerSetupFinished, responseCode: %d", responseCode));
                    switch (responseCode) {
                        case InstallReferrerResponse.OK:
                            // Connection established.
                            getArgs();
                            break;
                        case InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                            // API not available on the current Play Store app.
                            break;
                        case InstallReferrerResponse.SERVICE_UNAVAILABLE:
                            // Connection couldn't be established.
                            break;
                    }
                }
    
                @Override
                public void onInstallReferrerServiceDisconnected() {
                    // Try to restart the connection on the next request to
                    // Google Play by calling the startConnection() method.
                    Log.d(TAG, "onInstallReferrerServiceDisconnected");
                }
            });
        }
    
        public void getArgs() {
            try {
                ReferrerDetails response = mReferrerClient.getInstallReferrer();
                String referrerUrl = response.getInstallReferrer();
                long referrerClickTime = response.getReferrerClickTimestampSeconds();
                long appInstallTime = response.getInstallBeginTimestampSeconds();
                boolean instantExperienceLaunched = response.getGooglePlayInstantParam();
    
                Map<String, Object> args = new HashMap<>();
                args.put("referrerUrl", referrerUrl);
                args.put("referrerClickTime", referrerClickTime);
                args.put("installTime", appInstallTime);
                args.put("instantExperienceLaunched", instantExperienceLaunched);
                Log.d(TAG, String.format("--- args: %s", new JSONObject(args).toString()));
    //            end();
            } catch (RemoteException e) {
                e.printStackTrace();
            }
        }
    
        public void end() {
            if (mReferrerClient != null) {
                mReferrerClient.endConnection();
                mReferrerClient = null;
            }
        }
    }
    
  3. 在 MainActivity 的 onCreate 中调用

    GoogleReferrerHelper.getIns().start(this);
    

测试

可以在不上架的情况下, 测试 referrer 代码是否生效

  • 如何在Google Play商店发布之前测试google play referrer api? - https://www.thinbug.com/q/49127470

测试包名: com.aaa.bbb, 此包名必须在 Google Play 存在 (可以不是自己的 app, 用别人的可以测试)

测试连接: https://play.google.com/store/apps/details?id=com.aaa.bbb&referrer=arg1%3Daaa%26arg2%3Dbbb%26arg3%3Dccc (referrer 后面的参数要用 url encode 一下, 才能获取到全部参数, 参考官网文档都是 url encode 过的 https://developers.google.com/app-conversion-tracking/third-party-trackers/android?hl=zh-cn)

  1. 跳转到 Google Play 商店. 有两种方式

    1. 链接跳转. 给自己发个邮件, 内容里带上 测试连接, 然后用 gmail 应用打开看邮件, 点击连接 会直接跳转到 Google Play

    2. 利用另一个测试 app, 调用 api 跳转到 Google Play

      public static boolean gotoGooglePlay(Context context, String url) {
          try {
              Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
              intent.setPackage("com.android.vending"); //这里对应的是谷歌商店,跳转别的商店改成对应的即可
              intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
              if (intent.resolveActivity(context.getPackageManager()) != null) {
                  context.startActivity(intent);
                  return true;
              }
          } catch (Exception e) {
              e.printStackTrace();
          }
          return false;
      }
      
      Tools.gotoGooglePlay(this, "market://details?id=com.aaa.bbb&referrer=arg1%3Daaa%26arg2%3Dbbb%26arg3%3Dccc");
      
  2. 可以捕获到的信息

    --- args: {"instantExperienceLaunched":false,"installTime":0,"referrerClickTime":1595400534,"referrerUrl":"arg1%3Daaa%26arg2%3Dbbb%26arg3%3Dccc"}
    

    如果 referrer 后面的参数没有 url encode, 如: arg1=aaa&arg2=bbb&arg3=ccc, 将只能获取到第一个参数 arg1=aaa

    貌似只能捕获到一次, 之后多次测试捕获到的都是默认值

    {"instantExperienceLaunched":false,"installTime":0,"referrerClickTime":0,"referrerUrl":"utm_source=google-play&utm_medium=organic"}
    

其他测试结果

从 Google Play 上下载实测

  • 有 url encode:

    https://play.google.com/store/apps/details?id=com.aaa.bbb&referrer=myparam%3Dabc%26gclid%3D123%26googleparam1%3D456%26googleparam2%3D789
    --- txt: myparam=abc&gclid=123&googleparam1=456&googleparam2=789
    
    https://play.google.com/store/apps/details?id=com.aaa.bbb&referrer=pid%3D1054%26agent%3Dz1
    --- txt: pid=1054&agent=z1
    

    可以获取到所有参数

  • 无 url encode:

    https://play.google.com/store/apps/details?id=com.aaa.bbb&referrer=pid=1054&agent=z1
    --- txt: pid=1054
    

    只获取到第一个参数


  • 3
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 2
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

蝶泳奈何桥.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值