Pelacakan E-commerce - Android SDK v2 (Lama)

Dokumen ini memberikan ringkasan tentang cara mengukur pembayaran dan pendapatan dalam aplikasi menggunakan Google Analytics SDK untuk Android v2.

Ringkasan

Pengukuran e-commerce memungkinkan Anda mengirim pembelian dan penjualan dalam aplikasi ke Google Analytics. Data e-commerce di Google Analytics umumnya terdiri dari transaksi dan item, yang terkait dengan ID transaksi bersama. Di Google Analytics SDK untuk Android, hubungan tersebut dibentuk dengan membuat objek transaksi dan menambahkan item ke objek tersebut.

Data e-commerce digunakan sebagai data utama dalam laporan berikut:

  • Ringkasan E-commerce
  • Performa Produk
  • Performa Penjualan
  • Transaksi
  • Waktu untuk Membeli

Penerapan

Ada tiga langkah untuk mengukur transaksi dengan Google Analytics:

  1. Buat objek transaksi.
  2. Membuat objek item dan menambahkannya ke objek transaksi.
  3. Kirim transaksi menggunakan sendTransaction(Transaction transObject) .

Pada contoh berikut, kami asumsikan bahwa onPurchaseCompleted() dipanggil setelah pengguna menyelesaikan pembelian dalam aplikasi.

/**
 * The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
 * but only if the purchase has been confirmed.
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",                                           // (String) Transaction Id, should be unique.
      (long) (2.16 * 1000000))                              // (long) Order total (in micros)
      .setAffiliation("In-App Store")                       // (String) Affiliation
      .setTotalTaxInMicros((long) (0.17 * 1000000))         // (long) Total tax (in micros)
      .setShippingCostInMicros(0)                           // (long) Total shipping cost (in micros)
      .build();

  myTrans.addItem(new Item.Builder(
      "L_789",                                              // (String) Product SKU
      "Level Pack: Space",                                  // (String) Product name
      (long) (1.99 * 1000000),                              // (long) Product price (in micros)
      (long) 1)                                             // (long) Product quantity
      .setProductCategory("Game expansions")                // (String) Product category
      .build());

    Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
    myTracker.sendTransaction(myTrans); // Send the transaction.
}

Jenis Mata Uang

Di Google Analytics SDK untuk Android, kolom mata uang e-commerce harus dalam mikro (persejutaan mata uang).

Misalnya, untuk mengirim nilai mata uang 4.5991, Anda harus mengonversi nilai tersebut ke mikro (yaitu 4599100) saat mengirim transaksi ke Google Analytics, seperti pada contoh di atas. Saat SDK mengirim transaksi tersebut ke Google Analytics, nilai tersebut secara otomatis dikonversi menjadi nilai desimal titik tetap dan dikirim sebagai 4.5991.

Simbol mata uang tidak boleh disertakan dalam kode E-commerce, dan koma tidak boleh digunakan.

Kolom mata uang e-commerce juga mendukung nilai mata uang negatif, seperti yang mungkin diperlukan untuk pengembalian dana atau pengembalian barang.

Menentukan Mata Uang

Secara default, nilai transaksi diasumsikan dalam mata uang tampilan (profil) yang dilaporkan.

Untuk mengganti mata uang lokal transaksi, panggil setCurrencyCode saat membuat Transaction seperti pada contoh berikut:

/**
 * In this example, the currency of the transaction is set to Euros. The
 * currency values will appear in reports using the global currency
 * type of the view (profile).
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",
      (long) (1.59 * 1000000))
      .setAffiliation("In-App Store")
      .setTotalTaxInMicros((long) (0.13 * 1000000))
      .setShippingCostInMicros(0)
      .setCurrencyCode("EUR")                               // (String) Set currency code to Euros.
      .build();

    Tracker myTracker = EasyTracker.getTracker();
    myTracker.sendTransaction(myTrans);
}

Untuk mengetahui daftar lengkap mata uang dan kode mata uang yang didukung, lihat Referensi Mata Uang yang Didukung.