E-ticaret İzleme - Android SDK'sı

Bu belgede, Android sürüm 3 için Google Analytics SDK'sı kullanılarak uygulama içi ödemelerin ve gelirin nasıl ölçüleceğine genel bir bakış sunulmaktadır.

Genel bakış

E-ticaret ölçümü, uygulama içi satın alma ve satışları Google Analytics'e göndermenize olanak tanır. Google Analytics'teki e-ticaret verileri, paylaşılan bir işlem kimliğiyle ilişkilendirilen işlem ve öğe isabetlerinden oluşur.

İşlemler aşağıdaki alanları içerir:

Alan adı İzleyici Alanı Tür Gerekli Açıklama
İşlem kimliği Fields.TRANSACTION_ID String Evet İşlemi temsil eden benzersiz bir kimlik. Bu kimlik, diğer işlem kimlikleriyle çakışmamalıdır.
İlişkilendirme Fields.TRANSACTION_AFFILIATION String Evet İşlemin ilişkilendirilmesi gereken tüzel kişi (ör. belirli bir mağaza)
Gelir Fields.TRANSACTION_REVENUE Double Evet Vergi ve nakliye dahil, bir işlemin toplam geliri
Vergi Fields.TRANSACTION_TAX Double Evet Bir işlemin toplam vergisi
Kargo Fields.TRANSACTION_SHIPPING Double Evet Bir işlemin toplam gönderim maliyeti
Para birimi kodu Fields.CURRENCY_CODE String Hayır Bir işlemin yerel para birimi. Varsayılan olarak işlemlerin görüntülendiği görünümün (profilin) para birimi kullanılır.

Öğeler aşağıdaki alanları içerir:

Alan adı İzleyici Alanı Tür Gerekli Açıklama
İşlem kimliği Fields.TRANSACTION_ID String Evet Öğenin ilişkilendirilmesi gereken işlem kimliği
Ad Fields.ITEM_NAME String Evet Ürünün adı
SKU Fields.ITEM_SKU String Evet Bir ürünün SKU'su
Kategori Fields.ITEM_CATEGORY String Hayır Ürünün ait olduğu bir kategori
Fiyat Fields.ITEM_PRICE Double Evet Bir ürünün fiyatı
Miktar Fields.ITEM_QUANTITY Long Evet Bir ürünün miktarı
Para birimi kodu Fields.CURRENCY_CODE String Hayır Bir işlemin yerel para birimi. Varsayılan olarak işlemlerin raporlandığı görünümün (profilin) para birimi kullanılır.

E-ticaret verileri öncelikli olarak aşağıdaki standart raporlarda kullanılır:

  • E-ticarete Genel Bakış
  • Ürün Performansı
  • Satış Performansı
  • İşlemler
  • Satışa Kadar Geçen Süre

Uygulama

İşlem ve öğe verilerini Google Analytics'e göndermek için izleyicide işlem ve öğe alanı değerlerinin ayarlanması ve bunları tek tek göndermek gerekir. Örneğin:

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
}

E-ticaret para birimi alanları, geri ödemeler veya iadeler için gerekli olabileceği gibi negatif para birimi değerlerini destekler.

Para Birimlerini Belirleme

Varsayılan olarak, işlem değerlerinin raporlandıkları görünümün (profilin) para biriminde olduğu varsayılır.

Bir işlemin ve ilişkili tüm ürünlerin yerel para birimini geçersiz kılmak için işlemin ve öğe isabetlerinin para birimi kodu alanını yeni para birimi koduyla ayarlayın. Desteklenen para birimleri ve para birimi kodlarının tam listesi için Desteklenen Para Birimleri Referansı'na bakın.

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