يتناول هذا المستند كل ما تحتاج إلى معرفته لإعداد ميزة تتبُّع Google Analytics لبرنامج Adobe Flash لبيئة تطوير Adobe Flex.
الحصول على "مكتبة التتبُّع"
نزِّل الرمز (بتنسيق ZIP) من http://code.google.com/p/gaforflash/downloads/list. اتّبِع التعليمات الواردة في ملف readme.txt
لتثبيت المكوِّن Flex. على عكس مكوّنات Flash في "إحصاءات Google"، هناك ملف مكتبة واحد فقط في عملية التنزيل: /lib/analytics_flex.swc
.
إضافة التعليمة البرمجية إلى مشروعك
قبل أن تتمكن من البدء في استخدام رمز التتبّع في مشروعك، عليك ربط ملف SWC
الذي نزّلته كمورد للمشروع.
- اختَر المشروع->الخصائص. سيظهر مربع حوار "الخصائص" لمشروعك.
- انقر على مسار إصدار مرن واختَر علامة التبويب مسار المكتبة.
- انقر على إضافة SWC... ضمن جزء مسار المكتبة. سيظهر مربع الحوار إضافة SWC.
- انتقِل إلى المكان الذي فك فيهت ضغط واجهة برمجة التطبيقات Google Analytics API واختَر ملف
lib/analytics.swc
وانقر على حسنًا.
أو أفلِت ملفanalytics.swc
في دليل/libs
لمشروع Flex.
مثال على مكوّن MXML المرن
يوضّح المثال التالي كيفية إعداد التتبُّع لزر داخل ملف MXML. لإعداد مكوِّن MXML، نفِّذ ما يلي:
- ضبط مَعلمة مساحة اسم XML اضبط معلَمة مساحة الاسم XML لكائن التتبّع على النحو التالي:
xmlns:analytics="com.google.analytics.components.*"
- حدِّد اسم الكائن. في المثال أدناه، يتم ضبط المعلَمة
id
علىtracker
. - استخدِم المَعلمة
account
لرقم تعريف الموقع الإلكتروني. معرّف الموقع الإلكتروني هو السلسلة الفريدة المستخدمة لتتبع النشاط على محتوى Flash وتقديمه إلى الملف الشخصي الصحيح (الملف الشخصي) في حسابك على "إحصاءات Google". - ضبط وضع التتبّع باستخدام المَعلمة
mode
. استخدِمBridge
للمَعلمة إذا كنت تنشئ ملف MXML وتريد طريقة بسيطة لتنفيذ التتبّع. استخدمAS3
إذا كنت تعرف كيفية الترميز باستخدام ActionScript3. يسمح لك وضع AS3 باستيراد جميع فئات التتبّع في "إحصاءات Google"، والتي يمكنك من خلالها إنشاء عناصر التتبّع وضبطها. - اضبط وضع تصحيح الأخطاء باستخدام المَعلمة
visualDebug
. استخدِمtrue
لتفعيل تصحيح الأخطاء والتحقّق من صحة البرنامج في البرنامج، وإلا يمكنك ضبط هذا الإعداد علىfalse
للاستخدام في مرحلة الإنتاج.
في المثال، تمت إضافة زر mybutton
إلى الجزء الرئيسي. يتم إنشاء مثيل لمكوِّن التتبُّع المرن باسم tracker
ويتم ضبطه مع معلَماته. أخيرًا، تمت إضافة حدث النقر onButtonClick
إلى mybutton
. عند النقر على الزر، تتم زيادة المشاهدة الافتراضية للصفحة /hello world
بعدد واحد.
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" > <mx:Script> public function onButtonClick():void { tracker.trackPageview( "/hello world" ); } </mx:Script> <analytics:FlexTracker xmlns:analytics="com.google.analytics.components.*" id="tracker" account="UA-111-222" mode="AS3" visualDebug="false" /> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>
مثال على Flex ActionScript 3
في المواقف الأكثر تعقيدًا، يمكنك طلب فئات التتبع الأصلية في ActionScript 3 مباشرةً من ملفات موارد ActionScript. على الرغم من أنّ هذا المثال هو أيضًا ملف MXML، يتم إنشاء مثيل للتتبُّع في علامات <MX:script>
. يمكن استخدام هذه العملية نفسها لإضافة ميزة التتبع إلى مشاريع ActionScript 3 الأخرى.
في هذا المثال، تمت إضافة زر mybutton
إلى الجزء الرئيسي. في علامات النصوص البرمجية، يتم استيراد مكتبتَين:
com.google.analytics.GATracker; //this is the actual tracking class com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements
بعد استيراد المكتبات، يتم إنشاء متغير التتبُّع tracker
. بعد إضافة التطبيق إلى المرحلة، يتم استدعاء onComplete
، وينشئ مثيلاً لكائن التتبّع. المعلَمات الأربع التي تحتاجها لإنشاء مثيل للكائن GATracker هي:
- الإشارة إلى عنصر العرض الحالي في المثال أدناه، تشير السمة
this
إلى كائن العرض. - رقم تعريف الموقع الإلكتروني. معرّف الموقع الإلكتروني هو السلسلة الفريدة المستخدمة لتتبع النشاط على محتوى Flash وتقديمه إلى الملف الشخصي الصحيح (الملف الشخصي) في حسابك على "إحصاءات Google".
- وضع التتبّع: المَعلمات الصالحة هي
Bridge
أوAS3
. - وضع تصحيح الأخطاء: اضبط
debug
علىfalse
للاستخدام في مرحلة الإنتاج وعلىtrue
للتحقق من الصحة وتحديد المشاكل وحلّها.
أخيرًا، في طريقة النقر myButton
، تتبع الدالة onButtonClick
مشاهدة صفحة افتراضية على عنصر التتبع.
عند تشغيل هذا التطبيق، يتم إرسال مشاهدة افتراضية لصفحة "مرحبًا بالعالم" في كل مرة ينقر فيها أحد المستخدمين على الزر إلى خوادم تتبع "إحصاءات Google".
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" addedToStage="onComplete()" > <mx:Script> <![CDATA[ import com.google.analytics.GATracker; import com.google.analytics.AnalyticsTracker; public var tracker:AnalyticsTracker; private function onComplete():void { tracker = new GATracker( this, "UA-111-222", "AS3", false ); } public function onButtonClick():void { tracker.trackPageview( "/hello/world" ); } ]]> </mx:Script> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>