廣告活動評估 - Android SDK v2 (舊版)

本文件將概述如何使用適用於 Android v2 的 Google Analytics (分析) SDK，評估廣告活動和流量來源。

總覽

Google Analytics (分析) 評估廣告活動有助於將廣告活動和流量來源歸因於應用程式內的使用者活動，進而改善行銷通路的價值。

Android 專用的 Google Analytics (分析) SDK 提供幾種廣告活動評估：

• Google Play 廣告活動評估 - 查看哪些廣告活動、網站和應用程式已將使用者帶往應用程式的 Google Play 商店頁面。
• 評估一般廣告活動：查看哪些廣告活動或流量來源啟動了您的應用程式。
• 評估參照連結網址 - 查看哪些參照連結網址流量來源 (例如網站或其他應用程式) 是在安裝您應用程式後啟動。

以下各節將說明在應用程式中導入各類型廣告活動評估的時機和方式。

Google Play 廣告活動評估

Google Play 廣告活動評估可讓您瞭解哪些廣告活動和流量來源將使用者從 Google Play 商店下載應用程式。我們建議所有開發人員導入 Google Play 商店廣告活動評估。

Google Play 廣告活動評估的運作方式

Google Play 商店廣告活動評估需要使用廣告活動參數，在從 Google Play 商店下載廣告活動時，將廣告活動和流量來源資訊傳送至應用程式。

以下端對端說明 Google Play 廣告活動評估的運作方式：

1. 使用者點按廣告、網站或應用程式的連結，即可前往應用程式的 Google Play 商店頁面。這類連結會標上廣告活動參數。
2. 使用者下載並安裝您的應用程式後，Google Play 商店會在含有相同廣告活動參數的裝置上廣播 INSTALL_REFERRER 意圖。
3. 接著，您的應用程式會使用下方提供的 BroadcastReceiver 物件來回應該意圖，並讀取廣告活動參數，並使用這些參數更新 Google Analytics (分析) 廣告活動資訊。

導入 Google Play 廣告活動評估功能

如要導入 Google Play 商店廣告活動評估功能，請按照下列步驟操作：

1. 將新的 BroadcastReceiver 新增至 AndroidManifest.xml 檔案

下列 BroadcastReceiver 可讓應用程式在安裝應用程式時回應 Google Play 商店的 INSTALL_REFERRER 意圖廣播。將其新增至 AndroidManifest.xml 檔案，如下所示：

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

2.在 Google Play 商店連結中加入廣告活動參數

廣告活動參數會將將使用者轉介至應用程式 Google Play 商店頁面的廣告活動或流量來源相關資訊，傳遞至應用程式的 Google Analytics (分析) 導入方式。

如要瞭解如何建立廣告活動參數字串，請使用 Google Play 網址產生器，或參閱廣告活動參數參考資料一節。

建立廣告活動參數字串後，請將其新增至 Google Play 商店網址做為 referrer 參數的值，如以下範例所示：

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Google Play 商店只會將 referrer 參數的值傳遞至應用程式的 Google Analytics (分析) 實作項目，因此請務必確認您的 Google Play 商店連結中有這個參數。

評估一般廣告活動

一般廣告活動評估可用來連結廣告活動或流量來源，然後在使用者安裝應用程式後加以連結。

舉例來說，假設您放送付費廣告活動來觸及已安裝應用程式的現有使用者，就可以使用一般廣告活動評估功能，評估該廣告活動促成了哪些應用程式。

導入一般廣告活動評估

如要設定一般廣告活動的值，請呼叫 setCampaign()，並傳送 廣告活動參數字串做為引數。

一般實作方式可能會在應用程式啟動時呼叫 setCampaign()，並檢查啟動應用程式的意圖，看看是否存在有效的廣告活動參數：

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

評估參照連結網址

參照連結網址評估與其他類型的廣告活動評估類似，可讓您評估參照來源在使用者裝置上啟動應用程式的參照來源。不過，參照連結網址評估使用簡單的字串 (如「google.com」或「myOtherApp」)，而非一串廣告活動參數。

設定參照來源 (例如「google.com」) 時，來源維度會設為「google.com」，而媒介維度則是設為「參照網址」

與評估廣告活動時一樣，設定參照來源時，根據預設，會導致下一次傳送呼叫啟動新的工作階段。

在下列程式碼片段中，我們假設您已經標記可為開啟應用程式的任何連結，分別以 Google Analytics (分析) 廣告活動參數或描述參照來源的簡單 referrer 參數。如果 referrer 參數在缺少其他廣告活動參數的情況下，使用者的廣告活動資訊會更新為新的參照來源：

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

已知問題

• CampaignTrackingReceiver 的 javadoc 在其使用範例中使用不正確的類別路徑。如需正確使用方法，請參閱「導入 Google Play 廣告活動評估」一文。
• 每個應用程式只能指定一個 BroadcastReceiver 類別。如果您需要從不同 SDK 整合兩個以上的 BroadcastReceivers，您必須建立自己的 BroadcastReceiver 類別來接收所有廣播訊息，並為每個廣播類型呼叫適當的 BroadcastReceivers。
• Google Play 廣告活動評估目前不支援從線上 Play 商店啟動的網頁到裝置之間安裝。

廣告活動參數

廣告活動參數的作用是針對將使用者帶往應用程式的流量來源和廣告活動，傳遞相關資訊。

• 在一般的廣告活動評估中，未經編碼的廣告活動參數字串會以引數的形式傳遞至 setCampaign()。
• 在 Google Play 廣告活動評估中，包含編碼廣告活動參數字串的 referrer 參數，會附加至任何指向您應用程式的 Play 商店頁面的網址。

以下是可用於一般廣告活動評估的有效未經編碼廣告活動字串範例：

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

下表完整列出可用於 Google Play 或一般廣告活動評估的可用廣告活動參數。

Google Play 網址產生器

使用 Google Play 網址產生器產生 Google Play 廣告活動評估網址。