Pelacakan E-niaga - SDK Android

Dokumen ini memberikan ringkasan tentang cara mengukur pembayaran dan pendapatan dalam aplikasi 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 lain.
Afiliasi Fields.TRANSACTION_AFFILIATION String Ya Entitas yang berafiliasi dengan transaksi tersebut (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 defaultnya adalah mata uang tampilan (profil) yang digunakan untuk melihat transaksi.

Item memiliki kolom berikut:

Nama Kolom Kolom Pelacak Jenis Wajib Deskripsi
ID transaksi Fields.TRANSACTION_ID String Ya ID transaksi yang harus dikaitkan dengan item
Nama 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 Jumlah produk
Kode mata uang Fields.CURRENCY_CODE String Tidak Mata uang lokal untuk transaksi. Setelan defaultnya adalah mata uang tampilan (profil) yang digunakan untuk melaporkan transaksi.

Data e-commerce digunakan terutama dalam laporan standar berikut:

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

Penerapan

Pengiriman data transaksi dan item ke Google Analytics mengharuskan untuk menetapkan nilai kolom transaksi dan item di 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, dan 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 dan produk terkait, tetapkan kolom kode mata uang dari hit transaksi dan item dengan kode mata uang baru. Untuk mengetahui daftar lengkap mata uang dan kode mata uang yang didukung, lihat 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.
}