يقدِّم هذا المستند نظرة عامة حول كيفية قياس الدفعات والأرباح داخل التطبيق باستخدام الإصدار 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 }