تتبُّع "إحصاءات Google" لبرنامج Adobe Flash

تسهِّل ميزة تتبُّع "إحصاءات Google" لمكوِّن Adobe Flash تنفيذ "إحصاءات Google" في المحتوى المستند إلى فلاش. يحتوي هذا المكوِّن، الذي طوّرته شركة Adobe Systems, Inc. ، على جميع وظائف رمز JavaScript لخدمة "إحصاءات Google". مكوِّن تتبع Flash هو كائن تتبع مجمّع أصلي في ActionScript 3، ما يجعل تنفيذ "إحصاءات Google" أمرًا سهلاً في بيئات تطوير Flash و Flex.

لماذا ينبغي استخدام تتبع الفلاش؟

بدون تتبع Google Analytics لمكون Adobe Flash، يتضمن تتبع محتوى Adobe Flash باستخدام Google Analytics عددًا من العقبات الفنية. أولاً، عليك تطوير واجهة مخصّصة لأداة ga.js كي يتمكّن تطبيق Flash من تنفيذ طريقة "إحصاءات Google" المناسبة، مثل trackPageview() أو trackEvent(). بالإضافة إلى ذلك، يجب أن تتوقع أيضًا ما إذا كان محتوى Flash سيتمكن من الدخول إلى نموذج كائن المستند (DOM) في المتصفح، نظرًا لإخفاق التتبع في تلك الكائنات التي يتم فيها منع الدخول إلى DOM (عادةً عندما يكون المحتوى الخاص بك موجودًا على مواقع ويب تابعة لجهات خارجية). ويشمل ذلك فهم كيفية استخدام الاستدعاء ExternalInterface في ActionScript 3 للوصول إلى نموذج العناصر في المستند (DOM) للمتصفح والحد من خفض مستوى الصوت عند رفض الوصول.

يعمل مكوِّن Google Analytics لبرنامج Adobe Flash على تبسيط تتبع محتوى Flash ويتعامل مع إمكانية الدخول إلى DOM على نحو ملائم. وهو مفيد لعدد من أغراض التتبع الشائعة في Flash، مثل:

أداة فلاش مضمَّنة في صفحة HTML
تطبيق Flex مستقل أو موقع فلاش فقط تتم استضافته على صفحة HTML
هي فئة تطبيقات أو ألعاب مرنة أو فلاش موزّعة ولا يمكن للمطوّر فيها التحكّم في مكان وضع التطبيق المصغّر.

وتجدر الإشارة إلى أن تطبيقات التتبع في Flash لها بعض الاختلافات الهيكلية عن تتبع صفحات موقع الويب. وتُعد الدراية بميزة تتبع Analytics أمرًا ضروريًا لفهم كيفية عمل هذا المكون الإضافي. يمكنك أيضًا عرض وثائق التصميم لهذا المشروع للحصول على معلومات تفصيلية حول كيفية نقل نموذج تتبع Analytics لهذا المكون.

ملاحظة: في الوقت الحالي، يتوفر تتبع Flash لأي محتوى Flash مضمّن في صفحة ويب. لا يُسمح في الوقت الحالي بتتبع البيانات المرسلة من Adobe Air أو Shockwave أو عبر IDE Flash (مثل استخدام Test Movie).

بيئات التطوير المتوافقة

يمكنك تطوير ميزة تتبُّع Analytics لبرنامج Flash في بيئات Adobe Flash أو Adobe Flex. تتطلب كل بيئة مكوِّنًا مختلفًا، يمكنك تنزيله من الرابط http://code.google.com/p/gaforflash/. تستند هذه المكوّنات إلى ActionScript 3 ويمكن إعدادها بإحدى الطريقتين التاليتين لكل بيئة:

في Adobe Flash

إضافة وتكوين مكون بسيط في عارض المكون واسحبه إلى الجزء الرئيسي.
قم باستيراد مكتبات تتبع الفلاش إلى مكتبتك مباشرةً، وابدأ في الترميز.

في Adobe Flex

أضِف مكوّن MXML يمكنك إعداده من ملف MXML.
استورِد مكتبات تتبع الفلاش إلى علامات النصوص البرمجية/ملفات AS3.

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

كيف يعمل المكون؟

لاستخدام مكوِّن تتبع Flash في بيئتك، يمكنك إما استخدام الأدوات المرئية المتوفّرة في Flash أو إعداد كائن التتبّع في الرمز مباشرةً. وبغض النظر عما إذا كنت تُعد المكوِّن مرئيًا أو عبر التعليمات البرمجية، يمكنك تقديم العناصر التالية:

رقم تعريف الموقع الإلكتروني - يُعرف هذا أيضًا باسم رقم Universal Analytics لرمز التتبّع ويشبه UA-xxxxx-yy، حيث يتم استبدال الرمزين "س" و"ص" بالأرقام التي تتطابق مع معلومات حسابك وملفك الشخصي للكائن الذي تتّبعه. راجِع الموقع الإلكتروني للاطّلاع على مزيد من المعلومات.
وضع التتبُّع: اختَر إما وضع الجسر أو وضع AS3. ويحدِّد هذا الوضع كيفية تواصل التتبُّع مع خوادم "إحصاءات Google"، وهو موضّح بالتفصيل في ما يلي.
وضع تصحيح الأخطاء: بغض النظر عن البيئة أو وضع التتبُّع الذي تستخدِمه، يمكنك تفعيل تصحيح الأخطاء للتحقّق من التتبُّع واختباره.

أوضاع التتبّع

استنادًا إلى كيفية توزيعك لمحتوى Flash، يتصل مكوّن Analytics for Flash بخوادم Analytics إما عن طريق ربط محتوى Flash عبر عملية تثبيت حالية لبرنامج Analytics، أو عن طريق الاتصال مباشرةً بخوادم Analytics. ويسمى هذان الوضعان وضع الجسر ووضع AS3 على التوالي. ويستخدم كلا الوضعين وظيفة التتبّع نفسها في "إحصاءات Google"، ومن السهل تبديل تطبيق Flash من وضع إلى آخر. بالإضافة إلى اختيار وضع التواصل لتتبُّع "إحصاءات Google"، يمكنك أيضًا استخدام وضع تصحيح الأخطاء لتحديد المشاكل وحلّها أو التحقّق من صحة التتبُّع.

في أي من الوضعين، يجب أن تكون قيمة allowscriptaccess مساوية لـ always حتى تعمل ميزة تتبع الحملة. تعمل هذه المعلمة على تشغيل إمكانية الوصول للقراءة إلى عنوان URL للصفحة ومعلومات المُحيل التي يتطلبها رمز تتبّع فلاش. وبدون allowscriptaccess، يتراجع مستوى رمز تتبّع "إحصاءات Google" بسلاسة. سيظلّ يوفّر معظم بيانات نشاط المستخدِمين، ولكنّه لن يؤكِّد نموذج تحديد المصدر الخاص بالحملة في "إحصاءات Google".

وضع الجسر

استخدِم هذا الوضع إذا كنت تتحكّم في كلّ من صفحة HTML ومحتوى Flash. يكون هذا الوضع هو أفضل وضع إذا سبق لك تنفيذ تتبُّع "إحصاءات Google" (ga.js) على موقعك الإلكتروني وكنت تريد إضافة ميزة التتبُّع إلى محتوى Flash المضمّن. يعمل وضع الجسر على تبسيط الاتصال من الفلاش إلى JavaScript من خلال توفير واجهة ActionScript 3 موحَّدة للرمز ga.js. ويوفر اتصالاً من استدعاءات ActionScript 3 إلى JavaScript في "إحصاءات Google" لإجراء عملية التتبّع.

يمكن ضبط الربط برمز تتبّع "إحصاءات Google" من خلال مَعلمة رقم تعريف الموقع الإلكتروني بإحدى الطريقتَين التاليتَين:

الطريقة الأكثر شيوعًا. عنصر رمز تتبّع "إحصاءات Google" موجود سلفًا على صفحتك يحمل اسمها الخاص، مثل pageTracker. في هذه الحالة، عليك تقديم مرجع DOM الكامل إلى عنصر التتبّع. على سبيل المثال، إذا كان الكائن يحمل اسم pageTracker، يجب الإشارة إلى ذلك الكائن في الرمز على أنّه window.pageTracker. على سبيل المثال، يوضِّح مقتطف الرمز التالي كيفية ضبط ذلك باستخدام بيئة Adobe Flex مع ActionScript 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
الطريقة البديلة. إذا لم تكن قد أنشأت عنصر تتبّع صفحة على صفحتك، ما عليك سوى تمرير رقم تعريف موقعك الإلكتروني، وسيتم إنشاء كائن رمز تتبّع JavaScript لك. باستخدام هذه الطريقة، يظل عليك الرجوع إلى ملف مصدر JavaScript الأساسي ga.js على صفحة HTML. يوضِّح مقتطف الرمز التالي كيفية ضبط ذلك باستخدام بيئة Adobe Flex مع ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

لكي يعمل وضع الجسر بشكل صحيح، يجب ضبط ExternalInterface.available على "صحيح" في رمز ActionScript 3. وهذا يعني أيضًا أنّه يجب ضبط allowScriptAccess على always في صفحة HTML التي تتضمّن محتوى Flash. يوضِّح المثال التالي رمز HTML الذي تم ضبطه لوضع الجسر:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

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

وضع AS3

استخدم هذا الوضع إذا كنت تتحكم في رمز Adobe Flash ActionScript 3، ولكنك لا تتحكم في بيئة استضافة تطبيق Adobe Flash. على سبيل المثال، إذا كنت تطور محتوى Flash للتوزيع عبر العديد من المواقع، فستستخدم وضع AS3. وضع AS3 مستقل تمامًا عن رمز التتبّع ga.js ويحتوي على جميع وظائف التتبّع في "إحصاءات Google". ما مِن حاجة إلى تثبيت جهاز تتبُّع ga.js منفصل في هذا الوضع. بالإضافة إلى ذلك، يستخدم وضع AS3 آلية تخزين الفلاش لتتبع معلومات جلسة المستخدم.

بالنسبة إلى بعض معلَمات DOM، مثل اللغة، يحاول مكوّن AS3 استرداد القيم من المتصفّح. في حال عدم توفّر القيم، يستخدم المكوِّن القيمة المكافئة لبرنامج Flash أو يتم ضبطه تلقائيًا على no.

تحديد المشاكل وحلّها والتحقق من الصحة

يوفر تتبّع "إحصاءات Google" لمكوِّن Adobe Flash وضع تصحيح الأخطاء لتبسيط عملية التحقّق من الصحة وتحديد المشاكل وحلّها. عند تفعيل هذه الميزة، يتم اعتراض جميع بيانات التتبّع وتوجيهها إلى شاشة في مربّع نص بدلاً من خوادم "إحصاءات Google". في هذا الوضع، يمكنك الاطلاع في الوقت الفعلي على البيانات التي سيجمعها الخادم بطريقة أخرى. وتساعد هذه الميزة أيضًا في إبقاء بيانات الاختبار خارج نطاق بيانات الإنتاج. يمكنك تفعيل ميزة تحديد المشاكل وحلّها من خلال ضبط خيار visualDebug على true في أداة فحص المكوِّن.

أمثلة

للحصول على أمثلة تفصيلية عن تنفيذ التتبُّع في بيئات التطوير المختلفة، يُرجى الاطّلاع على ما يلي:

فلاش

Flex

تحديد الإصدارات

يمكنك العثور على أحدث إصدار من مكوّنات التتبُّع كملف ZIP على http://code.google.com/p/gaforflash/downloads/list. تحتوي كل عملية تنزيل على جميع مكونات التتبع بالإضافة إلى الوثائق ذات الصلة. سيعرض اسم الملف الخاص بملف التنزيل رقم إصدار الرمز الذي يحتوي عليه.

يمكنك أيضًا استخدام العبارات التالية في التعليمات البرمجية لطباعة رقم الإصدار الحالي للمكون في وحدة تحكم الإخراج.

import com.google.analytics.API;
trace(API.version);

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