ردیابی Google Analytics برای Adobe Flash

مولفه Google Analytics Tracking for Adobe Flash پیاده سازی Google Analytics را در محتوای مبتنی بر Flash برای شما آسان می کند. این مؤلفه که توسط Adobe Systems، Inc. توسعه یافته است، شامل تمام عملکردهای کد جاوا اسکریپت Google Analytics است. مولفه Flash Tracking یک شی ردیابی کامپایل شده بومی ActionScript 3 است که پیاده سازی Analytics را در محیط های توسعه Flash و Flex بصری می کند.

چرا از ردیابی فلش استفاده کنیم؟

بدون مولفه Google Analytics Tracking for Adobe Flash، ردیابی محتوای Adobe Flash با Google Analytics شامل تعدادی موانع فنی است. ابتدا، باید یک رابط سفارشی برای ga.js ایجاد کنید تا برنامه Flash شما بتواند روش تجزیه و تحلیل مناسب، مانند trackPageview() یا trackEvent() را اجرا کند. علاوه بر این، باید پیش‌بینی کنید که آیا محتوای Flash شما به مدل شی سند مرورگر (DOM) دسترسی خواهد داشت یا خیر، زیرا ردیابی برای آن دسته از اشیایی که دسترسی به DOM ممنوع است (معمولاً زمانی که محتوای شما در سایت‌های شخص ثالث قرار دارد) انجام نمی‌شود. این شامل درک نحوه استفاده از فراخوانی ExternalInterface در اکشن اسکریپت 3 برای دسترسی به DOM مرورگر و کاهش دسترسی در صورت عدم دسترسی است.

مؤلفه Google Analytics برای Adobe Flash ردیابی محتوای Flash شما را ساده می کند و دسترسی DOM را به خوبی مدیریت می کند. برای تعدادی از اهداف ردیابی رایج در Flash مفید است، مانند:

یک ویجت فلش جاسازی شده در صفحه HTML
یک برنامه فلکس مستقل یا سایت فقط فلش که در یک صفحه HTML میزبانی می شود
یک بازی یا برنامه فلکس/فلش توزیع شده که در آن توسعه‌دهنده هیچ کنترلی روی مکان قرار دادن ویجت ندارد

به خاطر داشته باشید که ردیابی برنامه های کاربردی در فلش دارای تغییرات ساختاری با ردیابی صفحات وب سایت است. آشنایی با Analytics Tracking برای درک نحوه عملکرد این افزونه ضروری است. همچنین می‌توانید مستندات طراحی این پروژه را برای اطلاعات دقیق در مورد نحوه انتقال مدل ردیابی تحلیل برای این مؤلفه مشاهده کنید.

توجه: در حال حاضر، ردیابی فلش برای هر محتوای Flash تعبیه شده در یک صفحه وب در دسترس است. ردیابی داده های ارسال شده از Adobe Air، Shockwave یا از طریق Flash IDE (مثلاً با استفاده از فیلم تست) در حال حاضر پشتیبانی نمی شود.

محیط های توسعه حمایت شده

می‌توانید ردیابی Analytics برای Flash را در محیط‌های Adobe Flash یا Adobe Flex توسعه دهید. هر محیط به یک مؤلفه متفاوت نیاز دارد که می توانید آن را از http://code.google.com/p/gaforflash/ دانلود کنید. این اجزا بر اساس ActionScript 3 هستند و می توانند به یکی از دو روش برای هر محیط راه اندازی شوند:

در Adobe Flash

یک کامپوننت ساده را در بازرس کامپوننت اضافه و پیکربندی کنید و آن را به مرحله بکشید.
کتابخانه های Flash Tracking را مستقیماً به کتابخانه خود وارد کنید و کدنویسی را شروع کنید.

در Adobe Flex

یک جزء MXML را که از فایل am MXML پیکربندی می‌کنید، اضافه کنید.
کتابخانه های Flash Tracking را به تگ های اسکریپت/فایل های AS3 خود وارد کنید.

بازگشت به بالا

کامپوننت چگونه کار می کند؟

برای استفاده از کامپوننت ردیابی فلش در محیط خود، یا از ابزارهای بصری داخل فلش استفاده می کنید یا شی ردیابی را مستقیماً در کد خود تنظیم می کنید. صرف نظر از اینکه جزء را به صورت بصری یا از طریق کد تنظیم می کنید، عناصر زیر را ارائه می دهید:

شناسه دارایی وب — این به عنوان شماره UA کد رهگیری شما نیز شناخته می شود و شبیه UA-xxxxx-yy است که در آن x و y با اعداد مربوط به حساب شما و اطلاعات مشاهده (نمایه) شی جایگزین می شود. شما در حال پیگیری هستید برای اطلاعات بیشتر به Web Property مراجعه کنید.
حالت ردیابی — حالت پل یا حالت AS3 را انتخاب کنید. این حالت نحوه ارتباط ردیابی شما با سرورهای Analytics را تعیین می کند و در زیر به تفصیل توضیح داده شده است.
حالت اشکال زدایی - مهم نیست از کدام محیط یا حالت ردیابی استفاده می کنید، می توانید اشکال زدایی را برای تأیید و آزمایش ردیابی خود روشن کنید.

حالت های ردیابی

بسته به نحوه توزیع محتوای Flash خود، مؤلفه Analytics for Flash یا با ایجاد پل ارتباطی بین محتوای Flash در نصب ردیابی آنالیتیکس موجود، یا با برقراری ارتباط مستقیم با سرورهای Analytics، با سرورهای Analytics ارتباط برقرار می کند. این دو حالت به ترتیب حالت پل و حالت AS3 نامیده می شوند. هر دو حالت از عملکرد ردیابی آنالیتیکس یکسان استفاده می کنند و به راحتی می توان برنامه Flash خود را از یک حالت به حالت دیگر تغییر داد. علاوه بر انتخاب حالت ارتباطی برای ردیابی آنالیتیکس، می‌توانید از حالت اشکال زدایی نیز برای عیب‌یابی یا تأیید اعتبار ردیابی خود استفاده کنید.

در هر دو حالت، برای اینکه ردیابی کمپین کار کند، allowscriptaccess باید always برابر باشد. این پارامتر دسترسی خواندن به URL صفحه و اطلاعات ارجاع دهنده مورد نیاز کد رهگیری Flash را روشن می کند. بدون allowscriptaccess ، کد رهگیری آنالیتیکس به خوبی کاهش می یابد. همچنان بیشتر داده‌های فعالیت کاربر را ارائه می‌کند، اما مدل انتساب کمپین Google Analytics را تأیید نمی‌کند.

حالت پل

اگر هم صفحه HTML و هم محتوای Flash را کنترل می کنید از این حالت استفاده کنید. اگر قبلاً ردیابی Google Analytics ( ga.js ) را در وب‌سایت خود پیاده‌سازی کرده‌اید و می‌خواهید ردیابی را به محتوای Flash تعبیه‌شده اضافه کنید، این حالت بهترین است. حالت پل ارتباط فلش به جاوا اسکریپت را با ارائه یک رابط ActionScript 3 یکپارچه برای کد ga.js ساده می کند. این اتصال را از تماس های ActionScript 3 به جاوا اسکریپت Analytics فراهم می کند تا ردیابی کار کند.

اتصال به کد ردیابی Google Analytics را می‌توان از طریق پارامتر ID ویژگی وب به یکی از دو روش پیکربندی کرد:

رایج ترین روش . شی کد ردیابی گوگل آنالیتیکس از قبل با نام خود مانند pageTracker در صفحه شما وجود دارد. در این مورد، شما مرجع کامل DOM را به شی ردیابی ارائه می دهید. برای مثال، اگر شیء شما pageTracker نامیده می شود، آن شی را در کد خود به عنوان window.pageTracker ارجاع می دهید. به عنوان مثال، قطعه کد زیر نشان می دهد که چگونه با استفاده از محیط Adobe Flex با ActionScript 3 پیکربندی می شود:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
روش جایگزین . اگر یک شی ردیابی صفحه در صفحه خود ایجاد نکرده اید، می توانید به سادگی شناسه ویژگی وب خود را ارسال کنید و یک شی کد ردیابی جاوا اسکریپت برای شما ایجاد می شود. با این روش، ارجاع به فایل منبع جاوا اسکریپت پایه ga.js همچنان در صفحه HTML شما مورد نیاز است. قطعه کد زیر نحوه پیکربندی این مورد را با استفاده از محیط Adobe Flex با ActionScript 3 نشان می دهد:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

برای اینکه حالت پل به درستی کار کند، ExternalInterface.available باید در کد ActionScript 3 روی true تنظیم شود. این همچنین به این معنی است که 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 است و شامل تمام عملکردهای ردیابی Analytics است. با این حالت نیازی به نصب ردیابی ga.js جداگانه نیست. علاوه بر این، حالت AS3 از مکانیسم ذخیره سازی Flash برای ردیابی اطلاعات جلسه برای کاربر استفاده می کند.

برای برخی پارامترهای DOM مانند زبان، مؤلفه AS3 سعی می کند مقادیر را از مرورگر بازیابی کند. اگر مقادیر وجود نداشته باشند، کامپوننت یا از مقدار معادل Flash استفاده می کند یا به صورت پیش فرض روی no است.

عیب یابی و اعتبار سنجی

مؤلفه Google Analytics Tracking for Adobe Flash حالت اشکال زدایی را برای ساده سازی اعتبارسنجی و عیب یابی ارائه می دهد. وقتی فعال باشد، تمام داده‌های ردیابی رهگیری می‌شوند و به‌جای سرورهای Analytics به صفحه‌ای در کادر متنی هدایت می‌شوند. در این حالت، می‌توانید داده‌هایی را که در غیر این صورت توسط سرور جمع‌آوری می‌شوند، در زمان واقعی مشاهده کنید. این ویژگی همچنین به حفظ داده‌های آزمایشی خارج از داده‌های تولید شما کمک می‌کند. می‌توانید با تنظیم گزینه visualDebug روی true در بازرس مؤلفه، ویژگی عیب‌یابی را فعال کنید.

مثال ها

برای مثال های دقیق در مورد پیاده سازی ردیابی در محیط های مختلف توسعه، به موارد زیر مراجعه کنید:

فلاش

فلکس

نسخه سازی

می توانید آخرین نسخه اجزای ردیابی را به صورت فایل ZIP در http://code.google.com/p/gaforflash/downloads/list پیدا کنید. هر بارگیری شامل تمام اجزای ردیابی به همراه اسناد مرتبط است. نام فایل برای فایل دانلودی شماره نسخه کدی را که در آن موجود است نمایش می دهد.

همچنین می توانید از عبارات زیر در کد خود برای چاپ شماره نسخه فعلی مؤلفه در کنسول خروجی استفاده کنید.

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

بازگشت به بالا