目录

Scenarios

You can also call an AIDL API provided by HUAWEI Ads Kit to obtain install referrer information from Huawei devices, without integrating any Huawei SDK. The install referrer information obtained from a device in either mode (SDK or AIDL) is the same.

Call Process

Development Procedure

1. Create an AIDL file for the IPPSChannelInfoService API and save the file under com.huawei.android.hms.ppskit, as shown in the following figure.

2. Copy the following content to the AIDL file:

  1. package com.huawei.android.hms.ppskit;
  2. /** Important: Do not change the method sequence in the AIDL file. */
  3. interface IPPSChannelInfoService {
  4.     String getChannelInfo();
  5. }

3. Create a class to implement Android-native ServiceConnection.

Step 1: Implement the onServiceConnected method of ServiceConnection.

Step 2: Call the Android-native IPPSChannelInfoService.Stub.asInterface method to obtain IPPSChannelInfoService.

Step 3: Call the getChannelInfo method to obtain install referrer information.

  1. private final class InstallReferrerServiceConnection implements ServiceConnection {
  2.         private InstallReferrerServiceConnection() {
  3.         }
  4.         @Override
  5.         public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
  6.             Log.i(TAG, "onServiceConnected");
  7.             IPPSChannelInfoService service = IPPSChannelInfoService.Stub.asInterface(iBinder);
  8.             if (null != service) {
  9.                 try {
  10.                     String json = service.getChannelInfo();
  11.                     parseChannelJson(json);
  12.                 } catch (RemoteException e) {
  13.                     Log.e(TAG, "getChannelInfo Excepition");
  14.                 } finally {
  15.                     mContext.unbindService(this);
  16.                 }
  17.             }
  18.         }
  19.         @Override
  20.         public void onServiceDisconnected(ComponentName componentName) {
  21.             Log.i(TAG, "onServiceDisconnected");
  22.         }
  23.     }
  24. }

4. Connect to the AIDL service for obtaining install referrer information.

Step 1: Create an InstallReferrerServiceConnection instance.

Step 2: Create the Intent object with the com.huawei.android.hms.CHANNEL_SERVICE action.

Step 3: Set the package name of Intent to com.huawei.hwid.

Step 4: Call bindService to connect to the AIDL service for obtaining install referrer information.

  1. private boolean bindService() {
  2.     InstallReferrerServiceConnection serviceConnection = new InstallReferrerServiceConnection();
  3.     Intent intent = new Intent("com.huawei.android.hms.CHANNEL_SERVICE");
  4.     intent.setPackage("com.huawei.hwid");
  5.     boolean result = bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);
  6.     Log.i(TAG, "bindService result: " + result);
  7.     return result;
  8. }

5. Parse the returned install referrer information in JSON format.

  1. private ReferrerDetails parseChannelJson(String channelJson) {
  2.     Log.i(TAG, "parseChannelJson: " + channelJson);
  3.     try {
  4.         JSONObject jsonObject = new JSONObject(channelJson);
  5.         String channelInfo = jsonObject.optString("channelInfo");
  6.         long installTimestamp = jsonObject.optLong("installTimestamp", 0);
  7.         long clickTimestamp = jsonObject.optLong("clickTimestamp", 0);
  8.         ReferrerDetails referrerDetails = new ReferrerDetails(channelInfo, clickTimestamp, installTimestamp);
  9.         updateReferrerDetails(referrerDetails);
  10.         return referrerDetails;
  11.     } catch (JSONException e) {
  12.         Log.e(TAG, "");
  13.     }
  14.     return null;
  15. }