ইকমার্স ট্র্যাকিং - Android SDK

এই দস্তাবেজটি Android v3-এর জন্য Google Analytics SDK ব্যবহার করে অ্যাপ-মধ্যস্থ অর্থপ্রদান এবং আয় কীভাবে পরিমাপ করতে হয় তার একটি ওভারভিউ প্রদান করে।

ওভারভিউ

ইকমার্স পরিমাপ আপনাকে 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 হ্যাঁ পণ্যের নাম
এসকেইউ 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.
}