Pengukuran Kampanye - Android SDK v2 (Lama)

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

Ringkasan

Mengukur kampanye di Google Analytics dapat membantu Anda meningkatkan nilai saluran pemasaran dengan mengaktifkan atribusi kampanye dan sumber traffic ke aktivitas pengguna dalam aplikasi Anda.

Ada beberapa jenis pengukuran kampanye yang tersedia di Google Analytics SDK untuk Android:

  • Pengukuran Kampanye Google Play - Lihat kampanye, situs, dan aplikasi mana yang mengarahkan pengguna ke halaman Google Play Store aplikasi Anda untuk mendownload aplikasi Anda.
  • Mengukur Kampanye Umum - Lihat kampanye atau sumber traffic yang meluncurkan aplikasi Anda yang diinstal.
  • Mengukur Rujukan - Lihat sumber traffic perujuk mana, seperti situs atau aplikasi lain, yang meluncurkan aplikasi Anda setelah diinstal.

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

Pengukuran 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.

Cara kerja Pengukuran Kampanye Google Play

Pengukuran Kampanye Google Play Store mengandalkan penggunaan Parameter Kampanye untuk meneruskan informasi kampanye dan sumber traffic ke aplikasi Anda pada saat aplikasi didownload dari Google Play Store.

Berikut adalah deskripsi menyeluruh tentang cara kerja Pengukuran Kampanye Google Play:

  1. Pengguna mengklik link dari iklan, situs, atau aplikasi yang mengarahkan mereka ke halaman Google Play Store aplikasi Anda. Link tersebut diberi tag dengan Parameter Kampanye.
  2. Setelah pengguna mendownload dan menginstal aplikasi Anda, Google Play Store akan menyiarkan intent INSTALL_REFERRER di perangkat yang menyertakan parameter kampanye yang sama.
  3. Aplikasi Anda kemudian akan merespons intent tersebut, menggunakan objek BroadcastReceiver yang disediakan di bawah, membaca parameter kampanye dan menggunakannya untuk memperbarui informasi kampanye Google Analytics.

Menerapkan Pengukuran Kampanye Google Play

Untuk menerapkan Pengukuran Kampanye Google Play Store:

1. Menambahkan BroadcastReceiver baru ke file AndroidManifest.xml

BroadcastReceiver berikut memungkinkan aplikasi Anda merespons siaran intent INSTALL_REFERRER oleh Google Play Store saat aplikasi Anda diinstal. Tambahkan ke file AndroidManifest.xml Anda sebagai berikut:

<!-- 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. Menambahkan parameter kampanye ke penautan Google Play Store

Parameter Kampanye digunakan untuk meneruskan informasi tentang kampanye atau sumber traffic yang mengarahkan pengguna ke halaman Google Play Store aplikasi Anda ke dalam penerapan Google Analytics aplikasi Anda.

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

Setelah Anda membuat string parameter kampanye, tambahkan string tersebut ke URL Google Play Store sebagai nilai parameter referrer, seperti dalam contoh ini: 

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 Store hanya akan meneruskan nilai parameter referrer ke implementasi Google Analytics aplikasi Anda, jadi penting untuk memastikan parameter tersebut ada di link Google Play Store.

Mengukur Kampanye Umum

Pengukuran kampanye umum dapat digunakan untuk mengaitkan kampanye atau sumber traffic dengan pengguna setelah pengguna menginstal aplikasi Anda.

Misalnya, jika Anda menjalankan kampanye berbayar untuk menjangkau pengguna lama yang telah menginstal aplikasi, Anda dapat menggunakan pengukuran kampanye umum untuk mengukur peluncuran aplikasi yang merupakan hasil dari kampanye tersebut.

Menerapkan Pengukuran Kampanye Umum

Untuk menetapkan nilai kampanye untuk kampanye umum, panggil setCampaign() dan teruskan string parameter kampanye sebagai argumen.

Implementasi standar dapat memanggil setCampaign() saat aplikasi diluncurkan dan memeriksa intent yang meluncurkannya untuk melihat apakah ada parameter kampanye yang valid:

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.
  }
}

Mengukur Rujukan

Pengukuran rujukan mirip dengan jenis pengukuran kampanye lainnya karena memungkinkan Anda mengukur sumber rujukan yang meluncurkan aplikasi Anda di perangkat pengguna. Namun, pengukuran rujukan menggunakan string sederhana seperti "google.com" atau "myOtherApp", bukan string parameter kampanye.

Jika Anda menetapkan sumber perujuk, seperti "google.com", dimensi sumber akan ditetapkan ke "google.com", sedangkan dimensi media secara implisit ditetapkan ke "perujuk"

Seperti pengukuran kampanye, menetapkan sumber rujukan secara default akan menyebabkan panggilan kirim berikutnya memulai sesi baru.

Dalam cuplikan kode berikut, kami mengasumsikan bahwa Anda telah memberi tag pada setiap link yang akan membuka aplikasi Anda dengan parameter kampanye Google Analytics, atau dengan parameter referrer sederhana yang mendeskripsikan sumber perujuk. Jika parameter referrer ada karena tidak ada parameter kampanye lainnya, informasi kampanye pengguna akan diperbarui dengan sumber perujuk baru:

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.
  }
}

Masalah Umum

  • Javadoc untuk CampaignTrackingReceiver menggunakan jalur class yang salah dalam contoh penggunaannya. Lihat Menerapkan Pengukuran Kampanye Google Play untuk penggunaan yang benar.
  • Hanya satu class BroadcastReceiver yang dapat ditentukan per aplikasi. Jika Anda perlu menggabungkan dua BroadcastReceivers atau lebih dari SDK yang berbeda, Anda harus membuat class BroadcastReceiver sendiri yang akan menerima semua siaran dan memanggil BroadcastReceivers yang sesuai untuk setiap jenis siaran.
  • Pengukuran Kampanye Google Play saat ini tidak mendukung penginstalan web ke perangkat yang dimulai dari Play Store web.

Parameter Kampanye

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

  • Dalam pengukuran kampanye umum, string parameter kampanye yang tidak dienkode diteruskan sebagai argumen ke setCampaign().
  • Dalam Pengukuran Kampanye Google Play, parameter referrer dengan string parameter kampanye yang dienkode sebagai nilainya ditambahkan ke semua URL yang mengarah ke halaman Play Store aplikasi Anda.

Berikut adalah contoh string kampanye yang valid dan tidak dienkode, yang dapat digunakan untuk pengukuran kampanye umum:

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

Tabel di bawah menampilkan daftar lengkap 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 Google Ads. Nilai ini dihasilkan secara dinamis dan tidak boleh diubah.

Pembuat URL Google Play

Gunakan Pembuat URL Google Play untuk membuat URL untuk Pengukuran Kampanye Google Play.