Pelacakan E-niaga - SDK Android

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

Ringkasan

Pengukuran e-commerce memungkinkan Anda mengirim pembelian dan penjualan dalam aplikasi ke Google Analytics. Data e-commerce di Google Analytics terdiri dari hit transaksi dan item, yang terkait dengan ID transaksi bersama.

Transaksi memiliki kolom berikut:

Nama Kolom Kolom Pelacak Jenis Wajib Deskripsi
ID transaksi Fields.TRANSACTION_ID String Ya ID unik yang mewakili transaksi. ID ini tidak boleh bertabrakan dengan ID transaksi lainnya.
Afiliasi Fields.TRANSACTION_AFFILIATION String Ya Entitas yang harus berafiliasi dengan transaksi (misalnya toko tertentu)
Pendapatan Fields.TRANSACTION_REVENUE Double Ya Total pendapatan transaksi, termasuk pajak dan pengiriman
Pajak Fields.TRANSACTION_TAX Double Ya Total pajak untuk transaksi
Pengiriman Fields.TRANSACTION_SHIPPING Double Ya Total biaya pengiriman untuk transaksi
Kode mata uang Fields.CURRENCY_CODE String Tidak Mata uang lokal untuk transaksi. Setelan default-nya adalah mata uang tampilan (profil) tempat transaksi dilihat.

Item memiliki kolom berikut:

Nama Kolom Kolom Pelacak Jenis Wajib Deskripsi
ID transaksi Fields.TRANSACTION_ID String Ya ID transaksi yang akan dikaitkan dengan item
Name Fields.ITEM_NAME String Ya Nama produk
SKU Fields.ITEM_SKU String Ya SKU produk
Kategori Fields.ITEM_CATEGORY String Tidak Kategori untuk produk tersebut
Harga Fields.ITEM_PRICE Double Ya Harga produk
Jumlah Fields.ITEM_QUANTITY Long Ya Kuantitas produk
Kode mata uang Fields.CURRENCY_CODE String Tidak Mata uang lokal untuk transaksi. Setelan default-nya adalah mata uang tampilan (profil) tempat transaksi dilaporkan.

Data e-commerce digunakan terutama dalam laporan standar berikut:

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

Penerapan

Mengirim data transaksi dan item ke Google Analytics memerlukan penetapan nilai kolom transaksi dan item pada pelacak dan mengirimkannya, satu per satu. Contoh:

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {

  /*
   * Called when a purchase is processed and verified.
   */
  public void onPurchaseCompleted() {

    // May return null if EasyTracker has not yet been initialized with a
    // property ID.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID
                           "In-app Store",   // (String) Affiliation
                           2.16d,            // (Double) Order revenue
                           0.17d,            // (Double) Tax
                           0.0d,             // (Double) Shipping
                           "USD")            // (String) Currency code
        .build()
    );

    easyTracker.send(MapBuilder
        .createItem("0_123456",               // (String) Transaction ID
                    "Level Pack: Space",      // (String) Product name
                    "L_789",                  // (String) Product SKU
                    "Game expansions",        // (String) Product category
                    1.99d,                    // (Double) Product price
                    1L,                       // (Long) Product quantity
                    "USD")                    // (String) Currency code
        .build()
    );
  }

  // ... Rest of the Activity definition
}

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

Menentukan Mata Uang

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

Untuk mengganti mata uang lokal transaksi dan produk terkait, tetapkan kolom kode mata uang dari transaksi dan hit item dengan kode mata uang baru. Untuk mengetahui daftar lengkap mata uang dan kode mata uang yang didukung, baca Referensi Mata Uang yang Didukung.

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;
import com.google.analytics.tracking.android.MapBuilder;

public class CheckoutActivity extends Activity {
  /**
   * 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() {

    // Assumes a tracker has already been initialized with a property ID, otherwise
    // this call returns null.
    EasyTracker easyTracker = EasyTracker.getInstance(this);

    easyTracker.send(MapBuilder
        .createTransaction("0_123456",       // (String) Transaction ID, should be unique among transactions.
                           "In-app Store",   // (String) Affiliation
                           (long) 2.16,      // (long) Order revenue (includes tax and shipping)
                           (long) 0.17,      // (long) Tax
                           0.0,              // (long) Shipping cost
                           "EUR")            // (String) Currency code
        .build();

  }
  // ... Rest of the Activity definition.
}