#### **為什麼要做轉化跟蹤**

廣告界有一句老話，我知道我的廣告費有一半是浪費掉的，但是不知道是怎麼浪費掉的。所以對廣告主來說廣告跟蹤非常重要，當你花了一大筆預算去做廣告投放，帶來的效果如何？如何根據每次廣告投放的資料，去調整最佳化投放策略，這些都要靠廣告跟蹤來獲得。

但現實情況是，廣告平臺與廣告主側的資料存在天然的割裂。廣告平臺能採集到安裝事件，但應用內如付費、啟用等轉化事件平臺採集不到，無法分析真實的轉化率。廣告主能輕易收集到實際轉化的情況，但無法和廣告任務相關聯，影響對後續投放的最佳化。而透過轉化跟蹤，可以將廣告主側的轉化事件與廣告平臺側的投放任務相關聯，從而為投放效果分析做資料支撐。

![](https://oscimg.oschina.net/oscnet/up-1220b020fe8d3a213d0e8bc50af55fc7eba.png)

#### 什麼是轉化跟蹤

轉化跟蹤是將廣告主最關注的轉化行為（OAID、時間戳、轉化行為、行為引數）透過API、SDK等方式上報給廣告平臺的產品。基於轉化跟蹤，廣告主可以詳細跟蹤廣告效果，監測不同平臺、不同形式的廣告帶來的流量與對應轉化效果，為不斷最佳化廣告投放提供準確的資料依據。

為了更好地幫助廣告主在華為裝置上進行應用推廣，華為廣告服務（HUAWEI Ads Kit）也提供轉化跟蹤能力，方便廣告主進行廣告轉化渠道跟蹤和轉化效果分析。

#### 華為廣告服務轉化跟蹤引數能力工作原理

![](https://oscimg.oschina.net/oscnet/up-f79a50f3da95dbb906836818c946cf1c581.png)

1\. 廣告主App整合廣告服務獲取轉化跟蹤引數能力並上架華為應用市場（AppGallery）。  
2\. 廣告主在華為廣告平臺（Ad Network）投放App下載類廣告，並設定轉化跟蹤引數。3. 媒體App（Media App）請求並展示廣告主投放的廣告。  
4\. 使用者在媒體App上點選廣告主投放的廣告，使用者可以選擇並下載安裝廣告主App。  
5\. 華為應用市場（AppGallery）將轉化跟蹤引數寫入廣告服務。  
6\. 使用者在端側啟用廣告主App時，App從廣告服務獲取轉化跟蹤引數。  
7\. 廣告主App上報啟用事件給三方監測平臺（Third-party tracking platform），平臺可使用轉化跟蹤引數分析App轉化效果。

#### 開發步驟

**一、整合轉化跟蹤引數開放能力（SDK方式）**  
SDK方式指廣告主透過華為廣告服務提供的SDK接入開放能力，獲得App轉化跟蹤引數

**整合SDK**

1\. 配置HUAWEI Ads SDK的Maven倉地址  
開啟Android Studio專案級"build.gradle"檔案，在"allprojects > repositories"裡面配置SDK的Maven倉地址。

```java
allprojects { 
        repositories { 
                google() 
                jcenter() 
                maven { url 'https://developer.huawei.com/repo/' } 
        } 
}
```

2\. 配置依賴  
開啟子工程"app"下的"build.gradle"檔案，在dependencies新增SDK的依賴，並將{version}替換為實際的HUAWEI Ads SDK版本號，請參見[版本更新說明](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/identifier-service-version-change-history-0000001050066927?ha_source=hms1)。

```java
dependencies { 
        implementation 'com.huawei.hms:ads-installreferrer:{version}' 
}
```

3\. 同步修改的檔案

![](https://oscimg.oschina.net/oscnet/up-6550a08ddb2b668dea08563aab0d7d0e067.png)

4\. PK前需要配置不要混淆HUAWEI Ads SDK，避免功能異常。  
開啟Android工程應用級根目錄下的"app/proguard-rules.pro"混淆配置檔案，新增如下兩行程式碼，加入排除HUAWEI Ads SDK的混淆配置。

```java
allprojects { 
        repositories { 
                google() 
                jcenter() 
                maven { url 'https://developer.huawei.com/repo/' } 
        } 
}
```

**建立轉化跟蹤引數狀態監聽器**  
1\. 實現InstallReferrerStateListener監聽器介面的兩個方法onInstallReferrerSetupFinished和onInstallReferrerServiceDisconnected，程式碼示例如下：

```java
/** 
* 建立監聽 
*/ 
private InstallReferrerStateListener installReferrerStateListener = new InstallReferrerStateListener() { 
 @Override 
 public void onInstallReferrerSetupFinished(int responseCode) { 
     switch (responseCode) { 
         case InstallReferrerClient.InstallReferrerResponse.OK: 
             Log.i(TAG, "connect ads kit ok"); 
             get(); 
             break; 
         case InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED: 
             // 服務不支援，請下載並安裝最新版本的HMS Core（APK） 
             Log.i(TAG, "FEATURE_NOT_SUPPORTED"); 
             break; 
         case InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE: 
             // 服務不可用，請將HMS Core（APK）版本升級到2.6.5及以上 
             Log.i(TAG, "SERVICE_UNAVAILABLE"); 
             break; 
         default: 
             Log.i(TAG, "responseCode: " + responseCode); 
             break; 
     } 
 } 
 
 @Override 
 public void onInstallReferrerServiceDisconnected() { 
     Log.i(TAG, "onInstallReferrerServiceDisconnected"); 
 } 
};
```

2\. 在連線成功的回撥中呼叫getInstallReferrer方法獲取轉化跟蹤引數。

```java
/** 
* 獲取轉化跟蹤引數 
*/ 
private void get() { 
 if (null != mReferrerClient) { 
     try { 
         // 獲取referrerDetails例項，不要在主執行緒中呼叫此方法 
         ReferrerDetails referrerDetails = mReferrerClient.getInstallReferrer(); 
         if (null != referrerDetails && null != mCallback) { 
             // 更新資料 
             mCallback.onSuccess(referrerDetails.getInstallReferrer(), 
                     referrerDetails.getReferrerClickTimestampMillisecond(), 
                     referrerDetails.getInstallBeginTimestampMillisecond()); 
         } 
     } catch (RemoteException e) { 
         Log.i(TAG, "getInstallReferrer RemoteException: " + e.getMessage()); 
     } catch (IOException e) { 
         Log.i(TAG, "getInstallReferrer IOException: " + e.getMessage()); 
     } finally { 
         disconnect(); 
     } 
 } 
}
```

**建立InstallReferrerClient例項**  
透過builder配置和建立一個InstallReferrerClient例項。  
1\. 呼叫InstallReferrerClient.newBuilder建立一個Builder例項。  
2\. 呼叫build建立InstallReferrerClient例項。

```java
mReferrerClient = InstallReferrerClient.newBuilder(mContext).build();
```

**連線轉化跟蹤引數服務**  
建立與轉化跟蹤引數服務的連線。  
1\. 設定startConnection的監聽器為已建立的InstallReferrerStateListener監聽器。  
2\. 在子執行緒中呼叫startConnection方法連線服務。

```java
mReferrerClient.startConnection(installReferrerStateListener);
```

**二、整合轉化跟蹤引數開放能力（AIDL方式）**

除了接入SDK以外，廣告主也可以直接呼叫華為廣告服務的AIDL介面獲取華為裝置上的轉化跟蹤引數，兩種方法獲取同一裝置的轉化跟蹤引數是相同的。

**新增AIDL介面檔案**  
在工程"app/src/main/aidl/com/huawei/android/hms/ppskit/"路徑中新增一個"IPPSChannelInfoService.aidl"介面檔案，包名為"com.huawei.android.hms.ppskit"，然後將下面內容複製到該介面檔案中。

```java
// IPPSRemoteService.aidl 
 package com.huawei.android.hms.ppskit; 
 /* 
  * 注意：不要修改AIDL檔案的方法順序 
  */ 
 interface IPPSChannelInfoService { 
 
     String getChannelInfo(); 
 }
```

**建立一個類，實現ServiceConnection介面**

1\. 實現ServiceConnection的onServiceConnected方法。  
2\. 呼叫IPPSChannelInfoService.Stub.asInterface方法獲取IPPSChannelInfoService。  
3\. 呼叫getChannelInfo方法獲取轉化跟蹤引數。

```java
private final class InstallReferrerServiceConnection implements ServiceConnection { 
 
     private InstallReferrerServiceConnection() { 
     } 
 
     @Override 
     public void onServiceConnected(ComponentName componentName, IBinder iBinder) { 
         Log.i(TAG, "onServiceConnected"); 
         mService = IPPSChannelInfoService.Stub.asInterface(iBinder); 
         if (null != mService) { 
             try { 
                 // 獲取渠道資訊（Json格式） 
                 String channelJson = mService.getChannelInfo(); 
                 Log.i(TAG, "channelJson: " + channelJson); 
                 // 解析 
                 JSONObject jsonObject = new JSONObject(channelJson); 
                 // 獲取轉化跟蹤引數 
                 String installReferrer = jsonObject.optString("channelInfo"); 
                 long clickTimestamp = jsonObject.optLong("clickTimestamp", 0); 
                 long installTimestamp = jsonObject.optLong("installTimestamp", 0); 
                 if (null != mCallback) { 
                     // 更新資料 
                     mCallback.onSuccess(installReferrer, clickTimestamp, installTimestamp); 
                 } else { 
                     mCallback.onFail("install referrer is empty"); 
                 } 
             } catch (RemoteException e) { 
                 Log.e(TAG, "getChannelInfo RemoteException"); 
                 mCallback.onFail(e.getMessage()); 
             } catch (Exception e) { 
                 Log.e(TAG, "getChannelInfo Exception"); 
                 mCallback.onFail(e.getMessage()); 
             } finally { 
                 unbindService(); 
             } 
         } 
     } 
 
     @Override 
     public void onServiceDisconnected(ComponentName componentName) { 
         Log.i(TAG, "onServiceDisconnected"); 
         mService = null; 
     } 
 }
```

**連線轉化跟蹤引數的AIDL服務**  
1\. 建立一個InstallReferrerServiceConnection例項。  
2\. 建立一個Intent，Action是"com.huawei.android.hms.CHANNEL_SERVICE"。  
3\. 設定Intent的包名為"com.huawei.hwid"。  
4\. 呼叫bindService連線轉化跟蹤引數的AIDL服務

```java
private boolean bindService() { 
     Log.i(TAG, "bindService"); 
     if (null == mContext) { 
         Log.e(TAG, "context is null"); 
         return false; 
     } 
     mServiceConnection = new InstallReferrerServiceConnection(); 
     Intent intent = new Intent(Constants.SERVICE_ACTION); 
     intent.setPackage(Constants.SERVICE_PACKAGE_NAME); 
     // 繫結服務 
     boolean result = mContext.bindService(intent, mServiceConnection, Context.BIND_AUTO_CREATE); 
     Log.i(TAG, "bindService result: " + result); 
     return result; 
 }
```

**斷開轉化跟蹤引數的AIDL服務**  
使用完AIDL介面後，應該主動斷開服務連線。

```java
private void unbindService() { 
     Log.i(TAG, "unbindService"); 
     if (null == mContext) {     
         Log.e(TAG, "context is null");     
         return; 
     } 
     if (null != mServiceConnection) { 
         // 解綁服務 
         mContext.unbindService(mServiceConnection); 
         mService = null; 
         mContext = null; 
         mCallback = null; 
     } 
 }
```

**三、接入單機測試**  
完成上述獲取轉化跟蹤引數業務程式碼的補全後，就可以進行編譯，完成編譯後，生成APK安裝並執行。提供了相關[Demo](https://github.com/HMS-Core/hms-ads-demo-advertising-identifier/tree/master/InstallReferrer), 可以在端側生成轉化跟蹤引數，供測試使用。

修改App用於測試轉化跟蹤引數。  
SDK方式：在建立InstallReferrerClient時設定為測試模式，呼叫setTest(true)，示例程式碼如下所示：

```java
mReferrerClient = InstallReferrerClient.newBuilder(mContext).setTest(true).build(); 
mReferrerClient.startConnection(installReferrerStateListener);
```

AIDL方式：在測試時設定繫結的AIDL服務的包名為"com.huawei.pps.hms.test"，示例程式碼如下所示：

```java
mServiceConnection = new InstallReferrerServiceConnection(); 
Intent intent = new Intent(Constants.SERVICE_ACTION); 
intent.setPackage(Constants.TEST_SERVICE_PACKAGE_NAME); 
boolean result = mContext.bindService(intent, mServiceConnection, Context.BIND_AUTO_CREATE); 
Log.i(TAG, "bindService result: " + result);
```

將工程編譯生成APK檔案，並將APK檔案安裝到裝置。執行App，顯示如下頁面。

![](https://oscimg.oschina.net/oscnet/up-8e0212450b6c5797a4c8938200e1174600f.png)

點選"寫入測試轉化跟蹤引數"，介面將跳轉到如下圖所示頁面，輸入的App包名（參見"AndroidManifest.xml"）和轉化跟蹤引數，並儲存。

![](https://oscimg.oschina.net/oscnet/up-bacd1ece373e8dfe9da4f2969bf1b30deaf.png)

#### 四、產品聯調

得到轉化跟蹤引數後，需要登入華為廣告平臺將廣告跟蹤引數和推廣任務聯絡起來  
1\. 廣告主App整合轉化跟蹤引數後，上架華為應用市場。  
2\. 在華為廣告投放平臺建立推廣任務時，設定轉化跟蹤引數，如下圖所示：  
![](https://oscimg.oschina.net/oscnet/up-dc750fd7ce88c20c917d19ba0f4008b4f16.png)

3\. 讀取轉化跟蹤引數。廣告主App被啟用時，將會讀取轉化跟蹤引數，並上報資訊到開發者制定分析平臺。

**欲瞭解更多詳情**

[訪問華為廣告服務官網](https://developer.huawei.com/consumer/cn/hms/huawei-adskit?ha_source=hms1)  
[獲取華為廣告服務開發指導文件](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/publisher-service-introduction-0000001070671805?ha_source=hms1)  
**華為廣告服務開源倉庫地址：**[GitHub](https://github.com/HMS-Core/hms-ads-demo-java)、[Gitee](https://gitee.com/hms-core/hms-ads-demo-java)  
[華為HMS Core官方論壇 ](https://developer.huawei.com/consumer/cn/forum/block/hms-core?ha_source=hms1)  
解決整合問題請到[Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

**關注我們，第一時間瞭解HMS Core最新技術~**

如何正確跟蹤廣告轉化資料，最佳化廣告投放效果？

相關文章