علامات Universal Analytics

لتفعيل التغييرات في وقت التشغيل على عملية تنفيذ "إحصاءات Google" والتي لا تتطلب منك إعادة إنشاء البرنامج الثنائي لتطبيقك وإعادة إرساله إلى الأسواق، نفِّذ Universal Analytics (UA) في تطبيقك باستخدام أداة "إدارة العلامات من Google".

يوضِّح لك هذا الدليل كيفية استخدام علامات Universal Analytics وحزمة تطوير البرامج (SDK) لأداة "إدارة العلامات من Google" لنظام التشغيل iOS من أجل:

إرسال عدد مرات مشاهدة الصفحة في التطبيق

لإرسال مشاهدة شاشة في كل مرة يتم فيها فتح شاشة جديدة في تطبيقك إلى "إحصاءات Google":

  1. أنشئ متغيّرًا لاسم الشاشة.
  2. إنشاء عامل تشغيل حدث شاشة مفتوحة
  3. أنشئ علامة مشاهدة الشاشة في Universal Analytics.
  4. دفع حدث الشاشة المفتوحة واسم الشاشة إلى طبقة البيانات.

1- إنشاء متغيّر لاسم الشاشة

لإنشاء متغيّر اسم الشاشة في أداة "إدارة العلامات من Google":

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
  4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
  5. انقر على متغيّر بلا عنوان لإدخال اسم المتغيّر اسم الشاشة.
  6. اختَر متغيّر طبقة البيانات كنوع المتغيّر.
  7. أدخِل screenName في حقل اسم متغيّر طبقة البيانات واضبط القيمة التلقائية له على unknown screen (شاشة غير معروفة).
  8. انقر على إنشاء متغيّر.

2. إنشاء عامل تشغيل حدث شاشة مفتوحة

لإنشاء عامل تشغيل في "إدارة العلامات من Google" لتنشيط علامة مشاهدة الصفحة في Universal Analytics:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العوامل المشغِّلة.
  4. انقر على جديد.
  5. انقر على عامل التفعيل بلا عنوان لإدخال اسم المشغِّل OpenScreenEvent.
  6. اختَر حدث مخصّص.
  7. ضمن تشغيل إطفاء الحرائق، أدخِل الشرط التالي:

    مشغِّل سيتم تشغيله عندما يساوي الحدث فتح الشاشة

  8. انقر على إنشاء مشغّل.

3. إنشاء علامة مشاهدة شاشة في Universal Analytics

لإنشاء علامة مشاهدة شاشة في Universal Analytics يتم تنشيطها من خلال حدث فتح الشاشة:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العلامات.
  4. انقر على جديد.
  5. انقر على علامة بلا عنوان لإدخال اسم العلامة فتح الشاشة.
  6. اختر المنتج إحصاءات Google.
  7. أدخِل رقم تعريف التتبّع.
  8. اختَر مشاهدة التطبيق على أنّه نوع التتبّع.
  9. انقر على مزيد من الإعدادات.
  10. انقر على الحقول المطلوب إعدادها.
  11. انقر بشكل متكرر على + إضافة حقل لإضافة الحقول التالية:

    أضِف الحقول التالية: اسم التطبيق وإصداره واسم الشاشة

  12. انقر على متابعة.
  13. ضِمن تشغيل النار، انقر على مخصّصة.
  14. اختَر المشغّل المخصّص OpenScreenEvent.
  15. انقر على حفظ.
  16. انقر على إنشاء علامة.

4. دفع حدث الشاشة المفتوحة واسم الشاشة إلى طبقة البيانات

أضِف رمزًا إلى تطبيقك لدفع حدث openScreen والقيمة screenName إلى طبقة البيانات، على سبيل المثال:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

إرسال الأحداث

لإرسال حدث إلى "إحصاءات Google" عندما يتفاعل المستخدِم مع عناصر التحكّم في واجهة المستخدم أو المحتوى في تطبيقك:

  1. (اختياري) أنشئ متغيّرات الحدث.
  2. إنشاء عامل تشغيل حدث
  3. أنشئ علامة حدث Universal Analytics.
  4. دفع قيمة متغيّر الحدث والحدث إلى طبقة البيانات:

توضّح الخطوات التالية كيفية إرسال حدث إلى "إحصاءات Google" عندما يبدأ المستخدم تشغيل فيديو

1- (اختياري) إنشاء متغيّرات الحدث

إذا كان الحدث يستخدم متغيّرات طبقة البيانات لتمثيل حقول الفئة أو الإجراء أو التصنيف أو القيم، يجب أولاً إنشاء هذه المتغيرات. في هذا المثال، تستخدم علامة حدث تشغيل الفيديو متغيّرًا في طبقة البيانات للحصول على اسم الفيديو.

إليك الخطوات التي يجب اتّباعها لإنشاء متغيّر اسم الفيديو في أداة "إدارة العلامات من Google":

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على المتغيّرات.
  4. ضمن متغيّرات من تحديد المستخدِم، انقر على جديد.
  5. انقر على متغيّر بلا عنوان لإدخال اسم المتغيّر اسم الفيديو.
  6. اختَر متغيّر طبقة البيانات كنوع المتغيّر.
  7. أدخِل videoName باعتباره اسم متغيّر طبقة البيانات واضبط قيمته التلقائية على فيديو غير معروف.
  8. انقر على إنشاء متغيّر.

2. إنشاء عامل تشغيل حدث

لإنشاء عامل تشغيل حدث في "إدارة العلامات من Google" لتنشيط علامة حدث Universal Analytics:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العوامل المشغِّلة.
  4. انقر على جديد.
  5. انقر على عامل التفعيل بلا عنوان لإدخال اسم المشغِّل VideoPlayEvent.
  6. اختَر حدث مخصّص.
  7. ضمن تشغيل إطفاء الحرائق، أدخِل الشرط التالي:

    عامل تشغيل يتم تنشيطه عندما يساوي الحدث videoPlay.

  8. انقر على إنشاء مشغّل.

3. إنشاء علامة حدث Universal Analytics

لإنشاء علامة حدث Universal Analytics يتم تنشيطها بواسطة حدث تشغيل الفيديو:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العلامات.
  4. انقر على جديد.
  5. انقر على علامة بلا عنوان لإدخال اسم العلامة حدث تشغيل الفيديو.
  6. اختر المنتج إحصاءات Google.
  7. أدخِل رقم تعريف التتبّع.
  8. اختَر الحدث باعتباره نوع التتبّع.
  9. أدخِل مَعلمات تتبُّع الأحداث التالية:

    أدخِل معايير التتبّع التالية: الفئة: فيديو، والإجراء: تشغيل، والتصنيف: فيديو

  10. انقر على مزيد من الإعدادات.
  11. انقر على الحقول المطلوب إعدادها.
  12. انقر بشكل متكرر على + إضافة حقل لإضافة الحقول التالية:

    أضِف الحقول التالية: اسم التطبيق وإصداره واسم الشاشة

  13. انقر على متابعة.
  14. ضِمن تشغيل النار، انقر على مخصّصة.
  15. اختَر المشغّل المخصّص VideoPlayEvent.
  16. انقر على حفظ.
  17. انقر على إنشاء علامة.

4. دفع قيمة متغيّر الحدث والحدث إلى طبقة البيانات

اكتب رمزًا لدفع حدث videoPlay وقيمة videoName إلى طبقة البيانات، على سبيل المثال:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end

إرسال معاملات التجارة الإلكترونية

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

  1. أنشئ عامل تشغيل معاملة.
  2. أنشئ علامة معاملة على Universal Analytics.
  3. دفع حدث المعاملة والمعاملات والعناصر إلى طبقة البيانات:

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

1- إنشاء عامل تشغيل معاملة

لإنشاء مشغِّل معاملة في "إدارة العلامات من Google" لتنشيط علامة معاملة Universal Analytics:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العوامل المشغِّلة.
  4. انقر على جديد.
  5. انقر على عامل التفعيل بلا عنوان لإدخال اسم المشغِّل اكتملت المعاملة.
  6. اختَر حدث مخصّص.
  7. ضمن تشغيل إطفاء الحرائق، أدخِل الشرط التالي:

    عامل تشغيل سيتم تنشيطه عندما يساوي الحدث معاملة.

  8. انقر على إنشاء مشغّل.

2. إنشاء علامة معاملة Universal Analytics

لإنشاء علامة معاملة Universal Analytics يتم تنشيطها من خلال حدث المعاملة:

  1. سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. في شريط التنقّل الأيمن، انقر على العلامات.
  4. انقر على جديد.
  5. انقر على علامة بلا عنوان لإدخال اسم العلامة اكتملت المعاملة.
  6. اختر المنتج إحصاءات Google.
  7. أدخِل رقم تعريف التتبّع.
  8. اختَر المعاملة باعتبارها نوع المسار.
  9. انقر على مزيد من الإعدادات.
  10. انقر على الحقول المطلوب إعدادها.
  11. انقر بشكل متكرر على + إضافة حقل لإضافة الحقول التالية:

    أضِف الحقول التالية: اسم التطبيق وإصداره واسم الشاشة

  12. انقر على متابعة.
  13. ضِمن تشغيل النار، انقر على مخصّصة.
  14. اختَر العامل المشغِّل المخصّص TransactionCompleted.
  15. انقر على حفظ.
  16. انقر على إنشاء علامة.

3. دفع حدث المعاملة والمعاملات والعناصر إلى طبقة البيانات

اكتب التعليمة البرمجية لدفع حدث المعاملة والمعاملة والعناصر المرتبطة إلى طبقة البيانات. عليك استخدام أسماء متغيرات المعاملات والعناصر المتوافقة لإرسال بيانات المعاملات والعناصر إلى طبقة البيانات. مثال:

// Called when a user completes a transaction.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}

لمزيد من المعلومات عن استخدام حزمة تطوير البرامج (SDK) لأداة "إدارة العلامات من Google" لنظام التشغيل Android من أجل تنفيذ ميزات التجارة الإلكترونية المحسَّنة في Universal Analytics، اطّلِع على التجارة الإلكترونية المحسَّنة.

متغيّرات طبقة التجارة الإلكترونية المتوافقة

تتيح علامات المعاملات العامة أسماء متغيرات العمليات والسلع التالية.

متغيرات المعاملات

اسم المتغيّر الوصف Type مطلوبة
transactionId معرّف المعاملة الفريد سلسلة نعم
transactionAffiliation الشريك أو المتجر سلسلة لا
transactionTotal إجمالي قيمة المعاملة سلسلة لا
transactionTax مبلغ الضريبة للمعاملة سلسلة لا
transactionShipping تكلفة الشحن للمعاملة سلسلة لا
transactionCurrency عملة المعاملة سلسلة لا
transactionProducts قائمة السلع التي تم شراؤها في المعاملة صفيفة من متغيرات العناصر. لا

متغيّرات السلع

اسم المتغيّر الوصف Type مطلوبة
name اسم المنتج سلسلة نعم
sku رمز التخزين التعريفي للمنتج سلسلة لا
category فئة المنتج سلسلة لا
price سعر المنتج سلسلة لا
currency نوع عملة price سلسلة لا
quantity كمية السلع سلسلة لا

إرسال بيانات التجارة الإلكترونية المحسَّنة

لمعرفة المزيد عن إرسال بيانات التجارة الإلكترونية المحسَّنة، اطّلع على دليل مطوّري برامج التجارة الإلكترونية المحسَّنة.