目录

Scenarios

To better support app promotion targeted at Huawei user devices, HUAWEI Ads Kit provides the install referrer capability for advertisers to track promotion channels and attribute conversions.

Precautions

Ensure that your app has integrated the ads-installreferrer SDK in advance. For details, please refer to Preparations.

Call Process

Development Procedure

1. Create an install referrer status listener.

Implement the onInstallReferrerSetupFinished and onInstallReferrerServiceDisconnected methods of the InstallReferrerStateListener API. The sample code is as follows:

  1. /**
  2.  * Create a listener.
  3.  */
  4. private InstallReferrerStateListener installReferrerStateListener = new InstallReferrerStateListener() {
  5.     @Override
  6.     public void onInstallReferrerSetupFinished(int responseCode) {
  7.         switch (responseCode) {
  8.             case InstallReferrerClient.InstallReferrerResponse.OK:
  9.                 Log.i(TAG, "connect ads kit ok");
  10.                 // Get results
  11.                 try {
  12.                     ReferrerDetails referrerDetails = mReferrerClient.getInstallReferrer();
  13.                 } catch (RemoteException e) {
  14.                     Log.i(TAG, "getInstallReferrer RemoteException: " + e.getMessage());
  15.                 } catch (IOException e) {
  16.                     Log.i(TAG, "getInstallReferrer IOException: " + e.getMessage());
  17.                 }
  18.                 break;
  19.             case InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
  20.                 Log.i(TAG, "FEATURE_NOT_SUPPORTED");
  21.                 break;
  22.             case InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE:
  23.                 Log.i(TAG, "SERVICE_UNAVAILABLE");
  24.                 break;
  25.             default:
  26.                 Log.i(TAG, "responseCode: " + responseCode);
  27.                 break;
  28.         }
  29.     }
  30.     @Override
  31.     public void onInstallReferrerServiceDisconnected() {
  32.         Log.i(TAG, "onInstallReferrerServiceDisconnected");
  33.     }
  34. };

2. Create an InstallReferrerClient instance.

Step 1: Call InstallReferrerClient.newBuilder to create a Builder instance.

Step 2: Call build to create an InstallReferrerClient instance

  1. mReferrerClient = InstallReferrerClient.newBuilder(InstallReferrerActivity.this).build();

3. Connect to the install referrer service.

Step 1: Create a subthread.

Step 2: Set the listener of startConnection to InstallReferrerStateListener that has been created.

  1. private Thread connectThread = new Thread() {
  2.      @Override
  3.      public void run() {
  4.         connect();
  5.      }
  6. };
  7. /**
  8. * Connect to the HMS.
  9. */
  10. private void connect() {
  11.     mReferrerClient = InstallReferrerClient.newBuilder(InstallReferrerActivity.this).build();
  12.     mReferrerClient.startConnection(installReferrerStateListener);
  13. }
Note:
Do not call this API in a main thread.