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

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

نظرة عامة

يسمح لك قياس التجارة الإلكترونية بإرسال عمليات الشراء والمبيعات داخل التطبيق إلى "إحصاءات Google". تتكوّن بيانات التجارة الإلكترونية في Google Analytics من نتائج المعاملات والعناصر، المرتبطة بمعرّف معاملة مشترك.

تتضمّن المعاملات الحقول التالية:

اسم الحقل حقل أداة التتبُّع النوع مطلوبة الوصف
معرِّف المعاملة kGAITransactionId NSString نعم معرّف فريد يمثّل المعاملة. ويجب ألا يتعارض هذا المعرّف مع معرّفات المعاملات الأخرى.
الارتباط kGAITransactionAffiliation NSString نعم الكيان الذي يجب أن تكون المعاملة تابعة له (على سبيل المثال، متجر معيّن)
الأرباح kGAITransactionRevenue NSNumber نعم إجمالي الأرباح الناتجة من المعاملة، بما في ذلك الضرائب والشحن
ضريبة kGAITransactionTax NSNumber نعم إجمالي الضريبة للمعاملة
الشحن kGAITransactionShipping NSNumber نعم إجمالي تكلفة الشحن لمعاملة معيّنة
رمز العملة kGAICurrencyCode NSString لا العملة المحلية للمعاملة. يتم ضبط الإعدادات التلقائية على عملة الملف الشخصي التي يتم عرض المعاملات بها.

تحتوي العناصر على الحقول التالية:

اسم الحقل حقل أداة التتبُّع النوع مطلوبة الوصف
معرِّف المعاملة kGAITransactionId NSString نعم معرِّف المعاملة الذي يجب أن يكون العنصر مرتبطًا به
الاسم kGAIItemName NSString نعم اسم المنتج
رمز التخزين التعريفي kGAIItemSku NSString نعم رمز التخزين التعريفي للمنتج
الفئة kGAIItemCategory NSString لا الفئة التي ينتمي إليها المنتج
السعر kGAIItemPrice NSNumber نعم سعر المنتج
العدد kGAIItemQuantity NSNumber نعم كمية المنتج
رمز العملة kGAICurrencyCode NSString لا العملة المحلية للمعاملة. يتم ضبط الإعدادات التلقائية على عملة الملف الشخصي (الملف الشخصي) التي يتم إعداد تقارير المعاملات بها.

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

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

التنفيذ

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

/*
 * Called when a purchase is processed and verified.
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

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

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

بشكل تلقائي، يُفترض أن تكون قيم المعاملات بعملة الملف الشخصي (الملف الشخصي) التي يتم تسجيلها بها.

لإلغاء العملة المحلية للمعاملة وأي منتجات مرتبطة بها، اضبط حقل رمز العملة للمعاملة ونتائج العنصر على رمز العملة الجديد. للحصول على القائمة الكاملة للعملات ورموز العملات المتاحة، يمكنك الاطّلاع على مرجع العملات المتوافقة.

/*
 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).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}