تتبّع التجارة الإلكترونية - 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.

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

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