إعداد Adobe Flash

يتناول هذا المستند كل ما تحتاج إلى معرفته لإعداد ميزة تتبُّع Google Analytics لبرنامج Adobe Flash لبيئة تطوير Adobe Flash.

الحصول على ملفات المكونات

يتم ضغط ملفات مكوّنات تتبع Flash في ملف ZIP واحد يمكنك تنزيله من http://code.google.com/p/gaforflash/downloads/list.

اتّبِع التعليمات الواردة في ملف readme.txt لتثبيت مكوّنات Flash.

1. إذا كان لديك Adobe Flash CS3 مفتوحًا حاليًا، فقم بإنهاء التطبيق.
2. أنشئ دليل Google في أحد المواقع التالية:
   • لنظام التشغيل Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • لنظام التشغيل Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. انتقِل إلى المكان الذي فكّت فيه ضغط ملف ZIP، وانسخ الملفات التالية إلى الدليل الذي أنشأته في الخطوة السابقة:
   • lib/analytics_flash.swc - مكوِّن "إحصاءات Google"
   • lib/analytics.swc - مكوِّن مكتبة "إحصاءات Google"

كلا المكونين لهما نفس الوظائف، ولكن يتم توفيرهما كعناصر مريحة لأنماط التطوير المختلفة.

مكوّن "إحصاءات Google": إذا كنت تطور محتوى Flash، ولكنك غير معتاد على ActionScript 3، فاستخدم هذا المكون. مكوّن "إحصاءات Google" هو حزمة تتبُّع كاملة. ما عليك سوى سحب المكوّنات وإفلاتها مباشرةً على الجزء الرئيسي من المرحلة، وإجراء بعض الإعدادات البسيطة في أداة فحص المكوّنات، وستكون جاهزًا لوضع علامات على عناصر التحكّم باستخدام تتبُّع "إحصاءات Google".

مكوِّن مكتبة "إحصاءات Google". إذا كنت على دراية بتطبيق ActionScript 3، يمكنك استخدام مكوّن AnalyticLibrary. اسحب المكوِّن إلى مكتبة Flash واستورِد فئات التتبّع مباشرةً إلى رمز ActionScript.

استخدام مكوِّن "إحصاءات"

استخدِم analytics_flash.swc لتنفيذ التتبُّع من خلال مكوِّن "إحصاءات Google". ضع المكون في دليل المكونات الصحيح، وسيظهر في لوحة المكونات (النافذة - المكونات).

1. اسحب المكوِّن إلى الجزء الرئيسي وامنحه اسم مثيل في مربع الحوار الخصائص.
2. اضبط المكوِّن في لوحة "عارض المكونات" (Windows - Component Inspector (أداة فحص المكونات)):
   • أضِف رقم تعريف موقعك الإلكتروني في "إحصاءات Google".
   • اختَر وضع الجسر أو AS3.
   • حدِّد ما إذا كانت ميزة تصحيح الأخطاء المرئية مفعّلة أو غير مفعّلة.
3. في رمز ActionScript، أضف استدعاءات تتبع Google العادية إلى مثيل المكوِّن الذي أنشأته للتو.

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

مثال لمكون فلاش بسيط في "إحصاءات Google"

يعرض مقتطف الرمز التالي كيف يمكن تتبع زر في Flash عندما ينقر شخص عليه. في هذا المثال، تتم تسمية مثيل الزر playGame في ActionScript. وعند النقر على الزر، يتم استدعاء طريقة onButtonClick، ما يؤدي بدوره إلى استدعاء طريقة trackPageview(). يؤدي هذا الإجراء إلى زيادة عدد مشاهدات الصفحة على الويب للصفحة الافتراضية /myGame1.

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
} 

الرجوع إلى أعلى الصفحة

استخدام مكوِّن AnalyticsLibrary

استخدِم ملف analytics.swc لتنفيذ بيانات التتبُّع من خلال مكوِّن "مكتبة Analytics". يتيح لك هذا المكوِّن إنشاء مثيل لكائن التتبع مباشرةً في رمز AS3. بعد توفّر مكوِّن مكتبة "إحصاءات Google" في الموقع الصحيح، يظهر في لوحة "المكوّنات". يمكنك بعد ذلك سحب المكون من لوحة المكونات إلى مكتبتك، ومن هناك استيراد المكتبات إلى شفرة ActionScript.

إعداد كائن التتبع

باستخدام بيئة Adobe Flash، قم بتهيئة كائن التتبع باستخدام المعلمات التالية:

• الإشارة إلى عنصر العرض الحالي في المثال أدناه، تشير السمة this إلى كائن العرض.
• رقم تعريف الموقع الإلكتروني. معرّف الموقع الإلكتروني هو السلسلة الفريدة المستخدمة لتتبع النشاط على محتوى Flash وتقديمه إلى الملف الشخصي الصحيح (الملف الشخصي) في حسابك على "إحصاءات Google".
• وضع التتبّع: المَعلمات الصالحة هي Bridge أو AS3.
• وضع تصحيح الأخطاء: اضبط debug على false للاستخدام في مرحلة الإنتاج وعلى true للتحقق من الصحة وتحديد المشاكل وحلّها.

مثال بسيط على AnalyticsLibrary

في المثال التالي، يوجد مقطع فيلم يسمى playGame على المسرح. يتم إنشاء كائن تتبُّع جديد يسمّى tracker مع معالج أحداث يستمع إلى نقرات الماوس. عند النقر على الزر، يتم استدعاء الدالة onButtonClick. بالنسبة إلى كل نقرة، تزيد طريقة trackPageview() عدد مشاهدات الصفحة على الويب للصفحة الافتراضية /myGame1.

import com.google.analytics.AnalyticsTracker;
import com.google.analytics.GATracker;
var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true );
playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick ( event:Event ):void
{
   tracker.trackPageview("/myGame1");
} 

الرجوع إلى أعلى الصفحة