راه اندازی Adobe Flash

این سند همه چیزهایی را که برای راه‌اندازی Google Analytics Tracking برای Adobe Flash برای محیط توسعه Adobe Flash باید بدانید را پوشش می‌دهد.

فایل های کامپوننت را دریافت کنید

فایل‌های مؤلفه ردیابی Flash در یک فایل ZIP فشرده می‌شوند که می‌توانید آن را از http://code.google.com/p/gaforflash/downloads/list دانلود کنید.

دستورالعمل های موجود در فایل readme.txt را برای نصب کامپوننت های Flash دنبال کنید.

  1. اگر Adobe Flash CS3 در حال حاضر باز است، برنامه را ترک کنید.
  2. یک فهرست Google در یکی از مکان های زیر ایجاد کنید:
    • برای ویندوز: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • برای Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. به محلی که فایل ZIP کامپوننت را از حالت فشرده خارج کرده اید بروید و فایل های زیر را در دایرکتوری که در مرحله قبل ایجاد کرده اید کپی کنید:
    • lib/analytics_flash.swc - مؤلفه تجزیه و تحلیل
    • lib/analytics.swc - مؤلفه کتابخانه Analytics

هر دو مؤلفه عملکرد یکسانی دارند، اما به عنوان یک راحتی برای سبک های مختلف توسعه ارائه می شوند.

جزء تجزیه و تحلیل . اگر محتوای Flash را توسعه می دهید، اما با ActionScript 3 آشنا نیستید، از این مؤلفه استفاده کنید. جزء Analytics یک بسته ردیابی کامل است. فقط کافی است اجزا را مستقیماً روی استیج خود بکشید و رها کنید، چند پیکربندی ساده در بازرس مؤلفه ایجاد کنید و آماده هستید تا کنترل های خود را با ردیابی Analytics تگ کنید.

مؤلفه کتابخانه Analytics اگر با ActionScript 3 آشنایی دارید، می توانید از کامپوننت AnalyticLibrary استفاده کنید. مؤلفه را به کتابخانه Flash خود بکشید و کلاس های ردیابی را مستقیماً به کد ActionScript خود وارد کنید.

استفاده از مؤلفه آنالیز

از analytics_flash.swc برای پیاده سازی ردیابی از طریق مؤلفه Analytics استفاده کنید. کامپوننت را در دایرکتوری Component صحیح قرار دهید و در پانل Components ( پنجره - Components ) ظاهر می شود.

  1. کامپوننت را به مرحله بکشید و در گفتگوی Properties یک نام نمونه به آن بدهید.
  2. کامپوننت را در پانل بازرس مؤلفه ( ویندوز - بازرس مؤلفه ) پیکربندی کنید:
    • شناسه دارایی وب Analytics خود را اضافه کنید.
    • حالت Bridge یا حالت AS3 را انتخاب کنید.
    • روشن یا خاموش بودن اشکال زدایی بصری را مشخص کنید.
  3. در کد ActionScript خود، تماس‌های استاندارد ردیابی GA را به نمونه مؤلفه‌ای که ایجاد کرده‌اید اضافه کنید.

به دلیل نحوه عملکرد Flash با اجزای بصری، به طور کلی بهتر است ردیابی را در فریم دوم برنامه Flash خود شروع کنید. اگر می‌خواهید ردیابی را در فریم اول مقداردهی کنید، تماس‌های ردیابی را در کنترل‌کننده‌های رویداد قرار دهید تا مطمئن شوید که جزء به طور کامل در محتوای Flash مقداردهی اولیه شده است.

یک نمونه کامپوننت فلش آنالیز ساده

قطعه کد زیر نشان می دهد که چگونه یک دکمه در Flash را می توان با کلیک بر روی آن ردیابی کرد. در این مثال، نمونه دکمه در ActionScript شما playGame نام دارد. هنگامی که دکمه کلیک می شود، متد onButtonClick فراخوانی می شود که به نوبه خود متد trackPageview() فراخوانی می کند. این تعداد بازدید از صفحه برای صفحه مجازی /myGame1 را افزایش می دهد.

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
}

استفاده از مؤلفه کتابخانه Analytics

از فایل analytics.swc برای پیاده سازی ردیابی از طریق مؤلفه AnalyticsLibrary استفاده کنید. این مؤلفه به شما امکان می دهد یک شی ردیابی را مستقیماً در کد AS3 خود نمونه برداری کنید. هنگامی که مؤلفه AnalyticsLibrary در مکان مناسب قرار گرفت، در پانل Components ظاهر می شود. سپس می توانید مؤلفه را از پانل Components به کتابخانه خود بکشید و از آنجا کتابخانه ها را به کد ActionScript خود وارد کنید.

شی ردیابی را مقدار دهی اولیه کنید

با استفاده از محیط Adobe Flash، شی ردیابی را با پارامترهای زیر مقداردهی اولیه کنید:

  • به شی نمایشگر فعلی ارجاع دهید . در مثال زیر، this به شیء نمایش اشاره می کند.
  • شناسه دارایی وب شناسه ویژگی وب رشته منحصر به فردی است که برای ردیابی فعالیت در محتوای Flash شما و ارائه آن به نمای (نمایه) صحیح در حساب Analytics شما استفاده می شود.
  • حالت ردیابی پارامترهای معتبر Bridge یا AS3 هستند.
  • حالت اشکال زدایی . debug برای استفاده در تولید روی false و برای اعتبارسنجی و عیب یابی روی true تنظیم کنید.

یک مثال ساده از کتابخانه Analytics

در مثال زیر، یک کلیپ فیلم به نام playGame روی صحنه وجود دارد. یک شی ردیابی جدید به نام tracker به همراه یک کنترل کننده رویداد ایجاد می شود که به کلیک ماوس گوش می دهد. هنگامی که دکمه کلیک می شود، تابع onButtonClick فراخوانی می شود. برای هر کلیک، متد trackPageview() تعداد بازدید از صفحه را برای صفحه مجازی /myGame1 افزایش می‌دهد.

import com.google.analytics.AnalyticsTracker;
import com.google.analytics.GATracker;
var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true );
playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick ( event:Event ):void
{
   tracker.trackPageview("/myGame1");
}