Pelacakan E-commerce - SDK iOS

Dokumen ini memberikan ringkasan tentang cara mengukur pembayaran dan pendapatan dalam aplikasi menggunakan Google Analytics SDK untuk iOS 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 kGAITransactionId NSString Ya ID unik yang mewakili transaksi. ID ini tidak boleh bertabrakan dengan ID transaksi lain.
Afiliasi kGAITransactionAffiliation NSString Ya Entitas yang berafiliasi dengan transaksi tersebut (misalnya toko tertentu)
Pendapatan kGAITransactionRevenue NSNumber Ya Total pendapatan transaksi, termasuk pajak dan pengiriman
Pajak kGAITransactionTax NSNumber Ya Total pajak untuk transaksi
Pengiriman kGAITransactionShipping NSNumber Ya Total biaya pengiriman untuk transaksi
Kode mata uang kGAICurrencyCode NSString 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 kGAITransactionId NSString Ya ID transaksi yang harus dikaitkan dengan item
Nama kGAIItemName NSString Ya Nama produk
SKU kGAIItemSku NSString Ya SKU produk
Kategori kGAIItemCategory NSString Tidak Kategori untuk produk tersebut
Harga kGAIItemPrice NSNumber Ya Harga produk
Jumlah kGAIItemQuantity NSNumber Ya Jumlah produk
Kode mata uang kGAICurrencyCode NSString 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:

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

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

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.

/*
 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).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}