ردیابی تجارت الکترونیک - Android SDK

این سند یک نمای کلی از نحوه اندازه گیری پرداخت های درون برنامه ای و درآمد با استفاده از Google Analytics SDK برای Android نسخه 3 ارائه می دهد.

بررسی اجمالی

اندازه گیری تجارت الکترونیک به شما امکان می دهد خریدها و فروش های درون برنامه ای را به Google Analytics ارسال کنید. داده‌های تجارت الکترونیک در Google Analytics از تراکنش‌ها و بازدیدهای موردی تشکیل شده است که با شناسه تراکنش مشترک مرتبط هستند.

معاملات دارای فیلدهای زیر است:

نام زمینه میدان ردیاب تایپ کنید ضروری شرح
شناسه تراکنش Fields.TRANSACTION_ID String آره یک شناسه منحصر به فرد که نشان دهنده تراکنش است. این شناسه نباید با شناسه های تراکنش دیگر برخورد کند.
وابستگی Fields.TRANSACTION_AFFILIATION String آره نهادی که معامله باید با آن وابسته باشد (مثلاً یک فروشگاه خاص)
درآمد Fields.TRANSACTION_REVENUE Double آره کل درآمد یک معامله، از جمله مالیات و حمل و نقل
مالیات Fields.TRANSACTION_TAX Double آره کل مالیات برای یک معامله
حمل دریایی Fields.TRANSACTION_SHIPPING Double آره کل هزینه حمل و نقل برای یک معامله
کد ارز Fields.CURRENCY_CODE String خیر واحد پول محلی یک معامله. پیش‌فرض واحد پول نمای (نمایه) که تراکنش‌ها در آن مشاهده می‌شوند.

موارد دارای فیلدهای زیر هستند:

نام زمینه میدان ردیاب تایپ کنید ضروری شرح
شناسه تراکنش Fields.TRANSACTION_ID String آره شناسه تراکنش که مورد باید با آن مرتبط شود
نام Fields.ITEM_NAME String آره نام محصول
SKU Fields.ITEM_SKU String آره SKU یک محصول
دسته بندی Fields.ITEM_CATEGORY String خیر دسته ای که محصول به آن تعلق دارد
قیمت Fields.ITEM_PRICE Double آره قیمت یک محصول
تعداد Fields.ITEM_QUANTITY Long آره مقدار یک محصول
کد ارز Fields.CURRENCY_CODE String خیر واحد پول محلی یک معامله. پیش‌فرض واحد پول نمای (نمایه) که تراکنش‌ها در آن گزارش می‌شوند.

داده‌های تجارت الکترونیک عمدتاً در گزارش‌های استاندارد زیر استفاده می‌شوند:

  • بررسی اجمالی تجارت الکترونیک
  • عملکرد محصول
  • عملکرد فروش
  • معاملات
  • زمان خرید

پیاده سازی

ارسال داده‌های تراکنش و اقلام به Google Analytics مستلزم تنظیم مقادیر فیلد تراکنش و آیتم در ردیاب و ارسال آن‌ها در یک زمان است. مثلا:

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
}

فیلدهای ارز تجارت الکترونیک از مقادیر منفی ارز پشتیبانی می کنند، همانطور که ممکن است در مورد بازپرداخت یا بازگشت ضروری باشد.

مشخص کردن ارزها

به‌طور پیش‌فرض، ارزش‌های تراکنش به واحد پول نمای (پروفایل) که در آن گزارش شده است، در نظر گرفته می‌شود.

برای نادیده گرفتن واحد پول محلی تراکنش و هر محصول مرتبط، قسمت کد ارز تراکنش را تنظیم کنید و مورد را با کد ارز جدید انتخاب کنید. برای لیست کامل ارزهای پشتیبانی شده و کدهای ارز، به مرجع ارزهای پشتیبانی شده مراجعه کنید.

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