ردیابی تجارت الکترونیک - Android SDK نسخه 2 (قدیمی)

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

بررسی اجمالی

اندازه گیری تجارت الکترونیک به شما امکان می دهد خریدها و فروش های درون برنامه ای را به Google Analytics ارسال کنید. داده‌های تجارت الکترونیک در Google Analytics عموماً از تراکنش‌ها و مواردی تشکیل شده است که با شناسه تراکنش مشترک مرتبط هستند. در Google Analytics SDK برای Android، این رابطه با ایجاد یک شی تراکنش و افزودن موارد به آن برقرار می‌شود.

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

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

پیاده سازی

سه مرحله برای اندازه گیری تراکنش با Google Analytics وجود دارد:

  1. یک شیء تراکنش بسازید.
  2. اشیاء مورد را بسازید و به شی تراکنش اضافه کنید.
  3. تراکنش را با استفاده از sendTransaction(Transaction transObject) ارسال کنید.

در مثال زیر، فرض می کنیم که onPurchaseCompleted() پس از تکمیل خرید درون برنامه ای توسط کاربر فراخوانی می شود.

/**
 * The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
 * but only if the purchase has been confirmed.
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",                                           // (String) Transaction Id, should be unique.
      (long) (2.16 * 1000000))                              // (long) Order total (in micros)
      .setAffiliation("In-App Store")                       // (String) Affiliation
      .setTotalTaxInMicros((long) (0.17 * 1000000))         // (long) Total tax (in micros)
      .setShippingCostInMicros(0)                           // (long) Total shipping cost (in micros)
      .build();

  myTrans.addItem(new Item.Builder(
      "L_789",                                              // (String) Product SKU
      "Level Pack: Space",                                  // (String) Product name
      (long) (1.99 * 1000000),                              // (long) Product price (in micros)
      (long) 1)                                             // (long) Product quantity
      .setProductCategory("Game expansions")                // (String) Product category
      .build());

    Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
    myTracker.sendTransaction(myTrans); // Send the transaction.
}

انواع ارز

در Google Analytics SDK برای Android، فیلدهای ارز تجارت الکترونیک باید به میکرو (میلیونم ارز) باشد.

به عنوان مثال، برای ارسال یک ارزش ارزی 4.5991 ، باید هنگام ارسال تراکنش به Google Analytics، آن مقدار را به میکرو تبدیل کنید (یعنی 4599100 ). هنگامی که SDK آن تراکنش را به Google Analytics ارسال می کند، آن مقدار به طور خودکار به یک مقدار اعشاری با نقطه ثابت تبدیل می شود و به عنوان 4.5991 ارسال می شود.

نمادهای ارز نباید در کد تجارت الکترونیک شما گنجانده شود و همچنین نباید از کاما استفاده شود.

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

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

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

برای نادیده گرفتن ارز محلی یک تراکنش، هنگام ساخت Transaction مانند مثال زیر، setCurrencyCode را فراخوانی کنید:

/**
 * 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() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",
      (long) (1.59 * 1000000))
      .setAffiliation("In-App Store")
      .setTotalTaxInMicros((long) (0.13 * 1000000))
      .setShippingCostInMicros(0)
      .setCurrencyCode("EUR")                               // (String) Set currency code to Euros.
      .build();

    Tracker myTracker = EasyTracker.getTracker();
    myTracker.sendTransaction(myTrans);
}

برای لیست کامل ارزهای پشتیبانی شده و کدهای ارز، به مرجع ارزهای پشتیبانی شده مراجعه کنید.