android-GooglePlay安装来源追踪PlayInstallReferrer

Posted 蝶泳奈何桥.

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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
    

    只获取到第一个参数


以上是关于android-GooglePlay安装来源追踪PlayInstallReferrer的主要内容,如果未能解决你的问题,请参考以下文章

Sublime text追踪函数插件:ctags

Apache SkyWalking 为.NET Core带来开箱即用的分布式追踪和应用性能监控

App页面上的数据如何追踪和统计的?现成的工具都有哪些?

提升拉新率!我教你啊

分布式技术追踪 2017年第三期

分布式技术追踪 2017年第五期