تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

يسهِّل مكوِّن "إحصاءات Google لبرنامج Adobe Flash" تتبع محتوى Flash ويتعامل مع وصول DOM بشكلٍ مريح. ويكون ذلك مفيدًا لعدد من أغراض التتبع الشائعة في Flash، مثل:

أداة Flash مضمّنة في صفحة HTML
تطبيق Flex المستقل أو الموقع الإلكتروني المستند إلى Flash فقط الذي تتم استضافته على صفحة HTML
هي فئة من الألعاب أو البرامج الموزَّعة/المرنة حيث لا يتحكّم مطوّر البرامج في أماكن عرض الأداة.

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

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

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

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

في Adobe Flash

أضِف مكوّنًا بسيطًا في أداة فحص المكوّنات واضبطه واسحبه إلى المرحلة.
استيراد مكتبات تتبع Flash مباشرةً إلى مكتبتك وبدء الترميز.

في Adobe Flex

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

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

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

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

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

أوضاع التتبع

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

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

وضع مجموعة إعدادات نقل المحتوى

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

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

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

لكي يعمل وضع مجموعة إعدادات نقل المحتوى بشكل صحيح، يجب ضبط ExternalInterface.available على"صحيح"في رمز GAMS 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 GAMS 3، ولكنك لا تتحكّم في بيئة الاستضافة لتطبيق Adobe Flash. على سبيل المثال، إذا كنت بصدد تطوير محتوى Flash لتوزيعه في عدة مواقع إلكترونية، يمكِنك استخدام وضع AS3. وضع AS3 مستقل تمامًا عن رمز التتبّع ga.js ويحتوي على جميع وظائف التتبّع في "إحصاءات Google". لا حاجة إلى تثبيت تتبُّع ga.js منفصل في هذا الوضع. بالإضافة إلى ذلك، يستخدم وضع AS3 آلية تخزين Flash لتتبع معلومات الجلسة للمستخدم.

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

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

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

أمثلة

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

الفلاش

مرنة

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

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

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

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

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