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

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

نظرة عامة

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

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

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

التنفيذ

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

  1. أنشِئ عنصر معاملة.
  2. أنشئ كائنات العناصر وأضفها إلى كائن المعاملة.
  3. أرسِل المعاملة باستخدام sendTransaction:.

في المثال التالي، نفترض أنّه يتم استدعاء onPurchaseCompleted بعد إكمال المستخدم لعملية شراء داخل التطبيق.

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

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

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

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

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

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