تتبّع التجارة الإلكترونية - Android SDK

يقدِّم هذا المستند نظرة عامة حول كيفية قياس الدفعات والأرباح داخل التطبيق باستخدام الإصدار الثالث من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android.

ملاحظة: يتطلب منك تتبُّع التجارة الإلكترونية إرسال نتائج transaction وitem. يجب عدم استخدام الطرق ذات الصلة بالتجارة الإلكترونية المحسنة لتتبُّع التجارة الإلكترونية العادية.

نظرة عامة

يسمح لك قياس التجارة الإلكترونية بإرسال عمليات الشراء والمبيعات داخل التطبيق إلى "إحصاءات Google". تتكوّن بيانات التجارة الإلكترونية في 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`	نعم	رمز التخزين التعريفي للمنتج
الفئة	`Fields.ITEM_CATEGORY`	`String`	لا	الفئة التي ينتمي إليها المنتج
السعر	`Fields.ITEM_PRICE`	`Double`	نعم	سعر المنتج
العدد	`Fields.ITEM_QUANTITY`	`Long`	نعم	كمية المنتج
رمز العملة	`Fields.CURRENCY_CODE`	`String`	لا	العملة المحلية للمعاملة. يتم ضبط الإعدادات التلقائية على عملة الملف الشخصي (الملف الشخصي) التي يتم إعداد تقارير المعاملات بها.

يتم استخدام بيانات التجارة الإلكترونية بشكل أساسي في التقارير العادية التالية:

نظرة عامة على التجارة الإلكترونية
أداء المنتج
أداء المبيعات
المعاملات
الوقت حتى الشراء

التنفيذ

يتطلب إرسال بيانات المعاملات والسلع إلى "إحصاءات Google" ضبط قيم حقول المعاملات والسلع في أداة التتبُّع وإرسالها، واحدًا تلو الآخر. مثال:

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