تتبُّع التجارة الإلكترونية - الإصدار 2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android (قديم)

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

نظرة عامة

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

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

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

التنفيذ

هناك ثلاث خطوات لقياس المعاملة باستخدام "إحصاءات Google":

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

أنواع العملات

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

على سبيل المثال، لإرسال قيمة عملة تبلغ 4.5991، عليك تحويل هذه القيمة إلى وحدات ميكرو (أي 4599100) عند إرسال المعاملة إلى "إحصاءات Google"، كما في الأمثلة أعلاه. وعندما ترسل حزمة تطوير البرامج (SDK) تلك المعاملة إلى "إحصاءات Google"، يتم تحويل هذه القيمة تلقائيًا إلى قيمة عشرية ثابتة وإرسالها على أنّها 4.5991.

يجب عدم تضمين رموز العملات في رمز التجارة الإلكترونية، ولا يجب استخدام الفواصل.

تدعم حقول عملات التجارة الإلكترونية أيضًا قيم العملات السالبة، ما قد يكون ضروريًا في حالة عمليات ردّ الأموال أو إرجاع المشتريات.

تحديد العملات

يُفترض تلقائيًا أن تكون قيم المعاملات بعملة الملف الشخصي التي يتم إعداد التقارير بها.

لإلغاء العملة المحلية للمعاملة، يمكنك استدعاء setCurrencyCode عند إنشاء Transaction كما في المثال التالي:

/**
 * 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);
}

للحصول على القائمة الكاملة للعملات ورموز العملات المتاحة، يمكنك الاطّلاع على مرجع العملات المتوافقة.