Pengukuran Kampanye - Android SDK

Dokumen ini memberikan ringkasan tentang cara mengukur kampanye dan sumber traffic dengan Google Analytics SDK untuk Android v3.

Ringkasan

Mengukur kampanye di Google Analytics memungkinkan atribusi kampanye dan sumber traffic ke aktivitas pengguna dalam aplikasi Anda. Opsi ini tersedia untuk atribusi kampanye dan sumber traffic di Google Analytics SDK untuk Android:

Bagian berikut akan menjelaskan waktu dan cara menerapkan setiap jenis pengukuran kampanye di aplikasi Anda.

Parameter kampanye

Parameter kampanye digunakan untuk meneruskan informasi tentang sumber traffic dan kampanye yang mengarahkan pengguna ke aplikasi Anda.

Tabel di bawah berisi parameter kampanye yang tersedia yang dapat digunakan di Google Play atau pengukuran kampanye umum:

Parameter Deskripsi Contoh
utm_campaign Nama kampanye; digunakan untuk analisis kata kunci guna mengidentifikasi promosi produk atau kampanye strategis tertentu utm_campaign=spring_sale
utm_source Sumber kampanye; digunakan untuk mengidentifikasi mesin telusur, newsletter, atau sumber lainnya utm_source=google
utm_medium Media kampanye; digunakan untuk mengidentifikasi media seperti email atau biaya per klik (cpc) utm_medium=cpc
utm_term Istilah kampanye; digunakan dengan penelusuran berbayar guna menyediakan kata kunci untuk iklan utm_term=running+shoes
utm_content Konten kampanye; digunakan untuk pengujian A/B dan iklan bertarget konten untuk membedakan iklan atau link yang mengarah ke URL yang sama utm_content=logolink
utm_content=textlink
gclid Parameter pemberian tag otomatis Google Ads; digunakan untuk mengukur iklan. Nilai ini dihasilkan secara dinamis dan tidak boleh diubah.

Atribusi Kampanye & Sumber Traffic Umum

Setelah diinstal, aplikasi dapat diluncurkan melalui rujukan dari kampanye iklan, situs, atau aplikasi lainnya. Dalam skenario ini, mereferensikan sumber traffic atau kampanye pemasaran dapat diatribusikan ke aktivitas pengguna di sesi berikutnya dengan menetapkan kolom kampanye di pelacak secara langsung.

Misalnya, penerapan berikut memeriksa intent yang meluncurkan aplikasi untuk parameter kampanye Google Analytics:

package com.example.app;

import com.google.analytics.tracking.android.Fields;
import com.google.analytics.tracking.android.GoogleAnalytics;
import com.google.analytics.tracking.android.MapBuilder;
import com.google.analytics.tracking.android.Tracker;

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;

import java.util.Map;

/*
 * An example of how to implement general campaign attribution in Android.
 *
 * If the intent that launched the Activity has a URI, parse it for campaign
 * parameters and send the referring data to Google Analytics.
 */
public class MainActivity extends Activity {

  private static final String GA_PROPERTY_ID = "UA-XXXX-Y";
  private static final String SCREEN_LABEL = "Home Screen";

  // This examples assumes the use of Google Analytics campaign
  // "utm" parameters, like "utm_source".
  private static final String CAMPAIGN_SOURCE_PARAM = "utm_source";

  Tracker mTracker;

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    mTracker = GoogleAnalytics.getInstance(this).getTracker(GA_PROPERTY_ID);
  }

  @Override
  public void onStart() {
    super.onStart();

    // Set screen name on tracker so that all subsequent hits will use this
    // value.
    mTracker.set(Fields.SCREEN_NAME, SCREEN_LABEL);

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

    // Send a screenview using any available campaign or referrer data.
    MapBuilder.createAppView().setAll(getReferrerMapFromUri(uri));
  }

  /*
   * Given a URI, returns a map of campaign data that can be sent with
   * any GA hit.
   *
   * @param uri A hierarchical URI that may or may not have campaign data
   *     stored in query parameters.
   *
   * @return A map that may contain campaign or referrer
   *     that may be sent with any Google Analytics hit.
   */
  Map<String,String> getReferrerMapFromUri(Uri uri) {

    MapBuilder paramMap = new MapBuilder();

    // If no URI, return an empty Map.
    if (uri == null) { return paramMap.build(); }

    // Source is the only required campaign field. No need to continue if not
    // present.
    if (uri.getQueryParameter(CAMPAIGN_SOURCE_PARAM) != null) {

      // MapBuilder.setCampaignParamsFromUrl parses Google Analytics campaign
      // ("UTM") parameters from a string URL into a Map that can be set on
      // the Tracker.
      paramMap.setCampaignParamsFromUrl(uri.toString());

     // If no source parameter, set authority to source and medium to
     // "referral".
     } else if (uri.getAuthority() != null) {

       paramMap.set(Fields.CAMPAIGN_MEDIUM, "referral");
       paramMap.set(Fields.CAMPAIGN_SOURCE, uri.getAuthority());

     }

     return paramMap.build();
  }
}

Atau, jika Anda memiliki informasi kampanye dalam bentuk selain parameter kampanye Google Analytics, Anda dapat menetapkannya di Map dan mengirimkannya secara manual:

// May return null if EasyTracker has not yet been initialized with a property ID.
EasyTracker easyTracker = EasyTracker.getInstance(this);
easyTracker.set(Fields.SCREEN_NAME, "Home Screen");

// In this example, campaign information is set using a Map, rather than
// a url string with Google Analytics campaign parameters.
// Note that Fields.CAMPAIGN_KEYWORD is not necessary for this campaign.
HashMap<String, String> campaignData = new HashMap<String, String>();
campaignData.put(Fields.CAMPAIGN_SOURCE, "email");
campaignData.put(Fields.CAMPAIGN_MEDIUM, "email marketing");
campaignData.put(Fields.CAMPAIGN_NAME, "summer_campaign");
campaignData.put(Fields.CAMPAIGN_CONTENT, "email_variation_1");

MapBuilder paramMap = MapBuilder.createAppView();

// Campaign data sent with this hit.
// Note that the campaign data is set on the Map, not the tracker.
easyTracker.send(paramMap
    .setAll(campaignData).build()
);

Atribusi Kampanye Google Play

Pengukuran Kampanye Google Play memungkinkan Anda melihat kampanye dan sumber traffic yang mengirim pengguna untuk mendownload aplikasi Anda dari Google Play Store. Sebaiknya semua developer menerapkan Pengukuran Kampanye Google Play Store.

Menerapkan atribusi kampanye Google Play

Saat aplikasi Anda didownload dari Google Play Store, aplikasi Play Store akan menyiarkan INTENT_REFERRER ke aplikasi Anda selama penginstalan. Intent ini berisi nilai parameter referrer link yang digunakan untuk menjangkau halaman Google Play Store aplikasi Anda, jika ada.

Untuk mengatribusikan download aplikasi ke kampanye, Anda harus menambahkan parameter referrer ke link apa pun yang mengarah ke Google Play Store, dan menambahkan BroadcastReceiver ke aplikasi Anda untuk menerima dan menetapkan informasi kampanye yang terdapat dalam intent di pelacak Google Analytics Anda.

Sebaiknya sebagian besar developer menggunakan BroadcastReceiver yang disediakan dengan SDK. Untuk menerapkan Pengukuran Kampanye Google Play Store menggunakan penerima yang disertakan:

1. Tambahkan penerima Google Analytics ke file AndroidManifest.xml Anda. Untuk menambahkan penerima Google Analytics ke manifes, salin dan tempel markup berikut:

<!-- Used for Google Play Store Campaign 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. Menambahkan Parameter Kampanye Google Analytics ke URL Google Play

Selanjutnya, tambahkan parameter referrer ke setiap URL yang akan ditautkan langsung ke Google Play Store dan tetapkan nilai parameter tersebut ke string parameter kampanye Google Analytics yang menjelaskan sumber, seperti dalam contoh berikut:

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

Untuk mempelajari cara membuat string parameter kampanye, gunakan Pembuat URL Google Play, atau lihat bagian referensi Parameter Kampanye.

Pembuat URL Google Play

Gunakan alat di bawah ini guna membuat URL untuk Pengukuran Kampanye Google Play.