إعداد Adobe Flex

يتناول هذا المستند كل ما تحتاج إلى معرفته لإعداد ميزة تتبُّع 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 الذي نزّلته كمورد للمشروع.

1. اختَر المشروع->الخصائص. سيظهر مربع حوار "الخصائص" لمشروعك.
2. انقر على مسار إصدار مرن واختَر علامة التبويب مسار المكتبة.
3. انقر على إضافة SWC... ضمن جزء مسار المكتبة. سيظهر مربع الحوار إضافة SWC.
4. انتقِل إلى المكان الذي فك فيهت ضغط واجهة برمجة التطبيقات 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>

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