يصف هذا المستند كيفية إرسال البيانات ويسرد جميع طرق مكوّن Google Analytics الإضافي لـ Unity.
مقدمة
عند إرسال البيانات إلى "إحصاءات Google" باستخدام مكوّن "إحصاءات Google" الإضافي لـ Unity، يمكنك استخدام الطريقة الأساسية أو طريقة أداة الإنشاء. تكون طرق أداة الإنشاء مطلوبة إذا كنت تريد إلحاق مَعلمات الحملة أو السمات أو المقاييس المخصّصة بالنتائج. يمكن إرسال النتائج باستخدام أي طريقة بالتبادل.
اتبع دليل المطورين لإعداد وتهيئة مكون Google Analytics الإضافي لـ Unity لمشروعك.
بنود عامة
أنجح الأغاني
إرسال النتائج (الملف الشخصي والأحداث وما إلى ذلك) إلى "إحصاءات Google" إذا كان الاتصال بالشبكة متاحًا.
public void DispatchHits();
مراجع ذات صلة:
- التعديل - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- النشر - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
التحكّم في الجلسة
تمثل الجلسة فترة واحدة من تفاعل المستخدم مع لعبتك. تعمل الجلسات كحاويات مفيدة للنشاط الذي تم قياسه، بما في ذلك مرات مشاهدة الصفحة في التطبيق والأحداث ومعاملات التجارة الإلكترونية.
يمكن استخدام الطرق التالية لفرض بدء جلسة أو انتهائها.
// Start a new session. public void StartSession();
// There should be no need to end a session explicitly. However, if you do // need to indicate the end of session you can use the following method. public void StopSession();
مراجع ذات صلة:
- الجلسات - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- الجلسات - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
الشاشات
تمثل الشاشات في "إحصاءات Google" المحتوى الذي يشاهده المستخدمون في لعبتك. تتكوّن مشاهدة الشاشة من حقل سلسلة واحد سيتم استخدامه كاسم الشاشة في تقارير "إحصاءات Google".
التذكرة الأساسية
public void LogScreen(string title);
عامل بناء
public void LogScreen(AppViewHitBuilder builder);
مثال
googleAnalytics.LogScreen("Main Menu"); //Builder Hit with all App View parameters (all parameters required): googleAnalytics.LogScreen(new AppViewHitBuilder() .SetScreenName("Main Menu"));
مراجع ذات صلة:
- الشاشات - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- الشاشات - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
فعاليات
تُعدّ الأحداث طريقة مفيدة لجمع البيانات حول تفاعل المستخدم مع المكوّنات التفاعلية في لعبتك، مثل استخدام عنصر معيّن. يتألف الحدث من أربعة حقول يمكنك استخدامها لوصف تفاعل المستخدم مع لعبتك.
التذكرة الأساسية
public void LogEvent(string eventCategory, string eventAction, string eventLabel, long value);
عامل بناء
public void LogEvent(EventHitBuilder builder);
مثال
googleAnalytics.LogEvent("Achievement", "Unlocked", "Slay 10 dragons", 5); // Builder Hit with all Event parameters. googleAnalytics.LogEvent(new EventHitBuilder() .SetEventCategory("Achievement") .SetEventAction("Unlocked") .SetEventLabel("Slay 10 dragons") .SetEventValue(5)); // Builder Hit with minimum required Event parameters. googleAnalytics.LogEvent(new EventHitBuilder() .SetEventCategory("Achievement") .SetEventAction("Unlocked"));
مراجع ذات صلة:
- الأحداث - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- الأحداث - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
الأعطال والاستثناءات
يتيح لك قياس الأعطال والاستثناءات قياس عدد الأعطال والاستثناءات التي تم رصدها وغير المرصودة في لعبتك ونوعها.
التذكرة الأساسية
public void LogException(string exceptionDescription, bool isFatal);
عامل بناء
public void LogException(ExceptionHitBuilder builder);
مثال
googleAnalytics.LogException("Incorrect input exception", true); // Builder Hit with all Exception parameters. googleAnalytics.LogException(new ExceptionHitBuilder() .SetExceptionDescription("Incorrect input exception") .SetFatal(true)); // Builder Hit with minimum required Exception parameters. googleAnalytics.LogException(new ExceptionHitBuilder());
مراجع ذات صلة:
- الأعطال والاستثناءات - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- الأعطال والاستثناءات: حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
توقيتات المستخدم
إنّ قياس توقيتات المستخدم يوفّر طريقة أصلية لقياس الفترة الزمنية في "إحصاءات Google". على سبيل المثال، يمكن أن يكون هذا مفيدًا لقياس أوقات تحميل الموارد.
التذكرة الأساسية
public void LogTiming(string timingCategory, long timingInterval, string timingName, string timingLabel);
عامل بناء
public void LogTiming(TimingHitBuilder builder);
مثال
googleAnalytics.LogTiming("Loading", 50L, "Main Menu", "First Load"); // Builder Hit with all Timing parameters. googleAnalytics.LogTiming(new TimingHitBuilder() .SetTimingCategory("Loading") .SetTimingInterval(50L) .SetTimingName("Main Menu") .SetTimingLabel("First load")); // Builder Hit with minimum required Timing parameters. googleAnalytics.LogTiming(new TimingHitBuilder() .SetTimingCategory("Loading") .SetTimingInterval(50L));
مراجع ذات صلة:
- أوقات المستخدم - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- أوقات المستخدم - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
التفاعلات الاجتماعية
يتيح لك قياس التفاعلات الاجتماعية قياس تفاعلات المستخدم من خلال العديد من أدوات مشاركة الشبكات الاجتماعية والتطبيقات المصغّرة للاقتراحات المضمَّنة في المحتوى الخاص بك.
التذكرة الأساسية
public void LogSocial(string socialNetwork, string socialAction, string socialTarget);
عامل بناء
public void LogSocial(SocialHitBuilder builder);
مثال
googleAnalytics.LogSocial("twitter", "retweet", "twitter.com/googleanalytics/status/482210840234295296"); // Builder Hit with all Social parameters. googleAnalytics.LogSocial(new SocialHitBuilder() .SetSocialNetwork("Twitter") .SetSocialAction("Retweet") .SetSocialTarget("twitter.com/googleanalytics/status/482210840234295296")); // Builder Hit with minimum required Social parameters. googleAnalytics.LogSocial(new SocialHitBuilder() .SetSocialNetwork("Twitter") .SetSocialAction("Retweet"));
مراجع ذات صلة:
- التفاعلات الاجتماعية - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- التفاعلات الاجتماعية - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
التجارة الإلكترونية
يتيح لك قياس التجارة الإلكترونية إرسال عمليات الشراء والمبيعات داخل اللعبة إلى "إحصاءات Google". تتكون بيانات التجارة الإلكترونية في Google Analytics من نتائج المعاملات والعناصر، المرتبطة برقم تعريف المعاملة المشترك.
المعاملات
التذكرة الأساسية
public void LogTransaction(string transID, string affiliation, double revenue, double tax, double shipping); public void LogTransaction(string transID, string affiliation, double revenue, double tax, double shipping, string currencyCode);
عامل بناء
public void LogTransaction(TransactionHitBuilder builder);
مثال
googleAnalytics.LogTransaction("TRANS001", "Coin Store", 3.0, 0.0, 0.0); googleAnalytics.LogTransaction("TRANS001", "Coin Store", 3.0, 0.0, 0.0, "USD"); // Builder Hit with all Transaction parameters. googleAnalytics.LogTransaction(new TransactionHitBuilder() .SetTransactionID("TRANS001") .SetAffiliation("Coin Store") .SetRevenue(3.0) .SetTax(0) .SetShipping(0.0) .SetCurrencyCode("USD")); // Builder Hit with minimum required Transaction parameters. googleAnalytics.LogTransaction(new TransactionHitBuilder() .SetTransactionID("TRANS001") .SetAffiliation("Coin Store") .SetRevenue(3.0) .SetTax(0) .SetShipping(0.0));
السلع
التذكرة الأساسية
public void LogItem(string transID, string name, string SKU, string category, double price, long quantity); public void LogItem(string transID, string name, string SKU, string category, double price, long quantity, string currencyCode);
عامل بناء
public void LogItem(ItemHitBuilder builder);
مثال
googleAnalytics.LogItem("TRANS001", "Sword", "SWORD1223", "Weapon", 3.0, 2); googleAnalytics.LogItem("TRANS001", "Sword", "SWORD1223", "Weapon", 3.0, 2, "USD"); // Builder Hit with all Item parameters. googleAnalytics.LogItem(new ItemHitBuilder() .SetTransactionID("TRANS001") .SetName("Sword") .SetSKU("SWORD1223") .SetCategory("Weapon") .SetPrice(3.0) .SetQuantity(2) .SetCurrencyCode("USD")); // Builder Hit with minimum required Item parameters. googleAnalytics.LogItem(new ItemHitBuilder() .SetTransactionID("TRANS001") .SetName("Sword") .SetSKU("SWORD1223") .SetPrice(3.0) .SetQuantity(2));
مراجع ذات صلة:
- تتبُّع التجارة الإلكترونية - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- تتبُّع التجارة الإلكترونية - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
المقاييس والأبعاد المخصصة
تتيح الأبعاد المخصّصة ربط البيانات الوصفية بالنتائج والمستخدمين والجلسات في "إحصاءات Google"، في حين تتيح المقاييس المخصّصة إمكانية إنشاء مقاييس خاصة بك وزيادتها في "إحصاءات Google".
عليك إنشاء سمات ومقاييس مخصَّصة وضبطها قبل استخدامها. بعد الضبط، يمكن إرسال البيانات كجزء من أي نتيجة باستخدام طريقة أداة الإنشاء.
عامل بناء
// Custom Dimension. public T SetCustomDimension(int dimensionNumber, string value);
// Custom Metric. public T SetCustomMetric(int metricNumber, string value);
مثال
// Custom Dimension. // An AppView hit example, but custom dimensions can be sent with all hit types. googleAnalytics.LogScreen(new AppViewHitBuilder() .SetScreenName("Another screen") .SetCustomDimension(1, "200")); // Custom Metric. // An Event hit example, but custom metrics can be sent with all hit types. googleAnalytics.LogEvent(new EventHitBuilder() .SetEventCategory("Achievement") .SetEventAction("Unlocked") .SetEventLabel("Slay 10 dragons") .SetEventValue(5) .SetCustomMetric(3, "200"));
مراجع ذات صلة:
- السمات والمقاييس المخصَّصة - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- السمات والمقاييس المخصَّصة - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
الحملات
يسمح قياس الحملات في "إحصاءات Google" بإسناد الحملات ومصادر الزيارات إلى نشاط المستخدم داخل لعبتك.
يمكن إرسال مَعلمات الحملة كجزء من أي نتيجة باستخدام طريقة أداة الإنشاء.
عامل بناء
public T SetCampaignName(string campaignName); public T SetCampaignSource(string campaignSource); public T SetCampaignMedium(string campaignMedium); public T SetCampaignKeyword(string campaignKeyword); public T SetCampaignContent(string campaignContent); public T SetCampaignID(string campaignID);
مثال
googleAnalytics.LogTiming(new TimingHitBuilder() .SetTimingCategory("Loading") .SetTimingInterval(50L) .SetTimingName("Main Menu") .SetTimingLabel("First load") .SetCampaignName("Summer Campaign") .SetCampaignSource("google") .SetCampaignMedium("cpc") .SetCampaignKeyword("games") .SetCampaignContent("Free power ups") .SetCampaignId("Summer1")); // Send campaign parameters with timing hit. // Builder Hit with minimum required Campaign parameters. googleAnalytics.LogTiming(new TimingHitBuilder() .SetTimingCategory("Loading") .SetTimingInterval(50L) .SetTimingName("Main Menu") .SetTimingLabel("First load") .SetCampaignSource("google");
مراجع ذات صلة:
- قياس الحملات - حزمة تطوير البرامج (SDK) لنظام التشغيل Android
- قياس الحملات - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
مزايا متقدّمة
لا يُنصَح بهذه الطرق إلا لمستخدمي "إحصاءات Google" المتمرّسين على دراية بمفاهيم أدوات التتبُّع.
SetOnTracker
عيِّن القيم في أداة التتبُّع لإرسالها مع النتائج الأخرى.
استخدِم متغيّرات من Assets/Plugins/Fields.cs للمَعلمة fieldName
(مثل Fields.SCREEN_NAME
).
public void SetOnTracker(Field fieldName, object value);
مثال
googleAnalytics.SetOnTracker(Fields.SCREEN_NAME, "Main Menu");
التخلص من الجهاز
عليك إخلاء بعض الموارد المُدارة وإعادة ضبط جهاز التتبُّع.
إذا تم استدعاء نتيجة التتبع التالية، فسيتعين عليك إنشاء أداة تتبع جديدة،
لذا يُنصح بعدم استدعاء هذه الطريقة إلا عند الانتهاء من التتبُّع بالكامل. على سبيل المثال، في طريقة onDispose()
التي يتم تنفيذها
عندما يغلق المستخدم لعبتك.
public void Dispose();
مثال
googleAnalytics.Dispose();