Adobe Flash-এর জন্য Google Analytics ট্র্যাকিং

অ্যাডোব ফ্ল্যাশ উপাদানের জন্য গুগল অ্যানালিটিক্স ট্র্যাকিং আপনার ফ্ল্যাশ-চালিত সামগ্রীতে Google অ্যানালিটিক্স প্রয়োগ করা সহজ করে তোলে। Adobe Systems, Inc. দ্বারা বিকশিত এই উপাদানটিতে Google Analytics Javascript কোডের সমস্ত কার্যকারিতা রয়েছে৷ ফ্ল্যাশ ট্র্যাকিং কম্পোনেন্ট হল অ্যাকশনস্ক্রিপ্ট 3-এর একটি সংকলিত ট্র্যাকিং অবজেক্ট, যা ফ্ল্যাশ এবং ফ্লেক্স ডেভেলপমেন্ট এনভায়রনমেন্টে অ্যানালিটিক্স বাস্তবায়নকে স্বজ্ঞাত করে তোলে।

ফ্ল্যাশ ট্র্যাকিং কেন ব্যবহার করবেন?

Adobe Flash উপাদানের জন্য Google Analytics ট্র্যাকিং ব্যতীত, Google Analytics-এর সাথে Adobe Flash সামগ্রী ট্র্যাক করার ক্ষেত্রে বেশ কিছু প্রযুক্তিগত বাধা রয়েছে৷ প্রথমে, আপনাকে অবশ্যই ga.js এ একটি কাস্টম ইন্টারফেস তৈরি করতে হবে যাতে আপনার ফ্ল্যাশ অ্যাপ্লিকেশন উপযুক্ত Analytics পদ্ধতি যেমন trackPageview() বা trackEvent() চালাতে পারে। এছাড়াও, আপনাকে অবশ্যই অনুমান করতে হবে যে আপনার ফ্ল্যাশ সামগ্রীর ব্রাউজার ডকুমেন্ট অবজেক্ট মডেল (DOM) এ অ্যাক্সেস থাকবে কিনা, যেহেতু ট্র্যাকিং সেই বস্তুগুলির জন্য ব্যর্থ হয় যেখানে DOM-এ অ্যাক্সেস অস্বীকৃত হয় (সাধারণত যখন আপনার সামগ্রী তৃতীয় পক্ষের সাইটগুলিতে থাকে)। ব্রাউজার DOM অ্যাক্সেস করতে এবং অ্যাক্সেস অস্বীকৃত হলে অবনমিত করতে অ্যাকশনস্ক্রিপ্ট 3-এ ExternalInterface কলটি কীভাবে ব্যবহার করতে হয় তা বোঝার জন্য এটি জড়িত।

Adobe Flash কম্পোনেন্টের জন্য Google Analytics আপনার ফ্ল্যাশ বিষয়বস্তু ট্র্যাক করা সহজ করে এবং DOM অ্যাক্সেস সুন্দরভাবে পরিচালনা করে। এটি ফ্ল্যাশে বেশ কয়েকটি সাধারণ ট্র্যাকিং উদ্দেশ্যে দরকারী, যেমন: :

  • একটি HTML পৃষ্ঠায় একটি এমবেডেড ফ্ল্যাশ উইজেট
  • একটি স্বতন্ত্র ফ্লেক্স অ্যাপ্লিকেশন বা এইচটিএমএল পৃষ্ঠায় হোস্ট করা শুধুমাত্র ফ্ল্যাশ সাইট
  • একটি বিতরণ করা ফ্লেক্স/ফ্ল্যাশ গেম বা প্রোগ্রাম যেখানে উইজেটটি কোথায় রাখা হবে তার উপর বিকাশকারীর কোন নিয়ন্ত্রণ নেই

মনে রাখবেন যে ফ্ল্যাশে ট্র্যাকিং অ্যাপ্লিকেশনগুলির ট্র্যাকিং ওয়েবসাইট পৃষ্ঠাগুলি থেকে কিছু কাঠামোগত বৈচিত্র রয়েছে৷ এই প্লাগ-ইন কীভাবে কাজ করে তা বোঝার জন্য অ্যানালিটিক্স ট্র্যাকিংয়ের সাথে পরিচিতি অপরিহার্য। এই উপাদানটির জন্য অ্যানালিটিক্স ট্র্যাকিং মডেলটি কীভাবে পোর্ট করা হয়েছে তার বিশদ তথ্যের জন্য আপনি এই প্রকল্পের ডিজাইন ডকুমেন্টেশনও দেখতে পারেন।

দ্রষ্টব্য: বর্তমানে, ফ্ল্যাশ ট্র্যাকিং একটি ওয়েব পৃষ্ঠাতে এমবেড করা যেকোনো ফ্ল্যাশ সামগ্রীর জন্য উপলব্ধ। Adobe Air, Shockwave, বা Flash IDE এর মাধ্যমে পাঠানো ডেটার ট্র্যাকিং (যেমন টেস্ট মুভি ব্যবহার করা) এই সময়ে সমর্থিত নয়৷

সমর্থিত উন্নয়ন পরিবেশ

আপনি Adobe Flash বা Adobe Flex পরিবেশে Flash-এর জন্য Analytics ট্র্যাকিং বিকাশ করতে পারেন৷ প্রতিটি পরিবেশের জন্য একটি আলাদা উপাদান প্রয়োজন, যা আপনি http://code.google.com/p/gaforflash/ থেকে ডাউনলোড করতে পারেন। এই উপাদানগুলি ActionScript 3 এর উপর ভিত্তি করে এবং প্রতিটি পরিবেশের জন্য দুটি উপায়ে সেট আপ করা যেতে পারে:

অ্যাডোব ফ্ল্যাশে

  • কম্পোনেন্ট ইন্সপেক্টরে একটি সাধারণ কম্পোনেন্ট যোগ করুন এবং কনফিগার করুন এবং স্টেজে টেনে আনুন।
  • ফ্ল্যাশ ট্র্যাকিং লাইব্রেরিগুলি সরাসরি আপনার লাইব্রেরিতে আমদানি করুন এবং কোডিং শুরু করুন।

Adobe Flex এ

  • একটি MXML উপাদান অন্তর্ভুক্ত করুন যা আপনি am MXML ফাইল থেকে কনফিগার করেন।
  • আপনার স্ক্রিপ্ট ট্যাগ/AS3 ফাইলগুলিতে ফ্ল্যাশ ট্র্যাকিং লাইব্রেরিগুলি আমদানি করুন৷

কম্পোনেন্ট কিভাবে কাজ করে?

আপনার পরিবেশে ফ্ল্যাশ ট্র্যাকিং উপাদান ব্যবহার করার জন্য, আপনি হয় ফ্ল্যাশের ভিজ্যুয়াল টুলগুলি ব্যবহার করেন, অথবা আপনি সরাসরি আপনার কোডে ট্র্যাকিং অবজেক্ট সেট আপ করেন। আপনি দৃশ্যত বা কোডের মাধ্যমে উপাদান সেট আপ করছেন কিনা তা নির্বিশেষে, আপনি নিম্নলিখিত উপাদানগুলি প্রদান করেন:

  • ওয়েব প্রপার্টি আইডি —এটি আপনার ট্র্যাকিং কোডের UA নম্বর হিসাবেও পরিচিত এবং এটি UA-xxxxx-yy এর মতো দেখায়, যেখানে x এবং y-এর সাথে প্রতিস্থাপিত হয় যে সংখ্যাগুলি আপনার অ্যাকাউন্টের সাথে মিলে যায় এবং বস্তুর জন্য (প্রোফাইল) তথ্য দেখুন আপনি ট্র্যাক করছেন. আরও তথ্যের জন্য ওয়েব সম্পত্তি দেখুন।
  • ট্র্যাকিং মোডব্রিজ মোড বা AS3 মোড বেছে নিন। এই মোডটি নির্ধারণ করে যে আপনার ট্র্যাকিং বিশ্লেষণ সার্ভারের সাথে কীভাবে যোগাযোগ করে এবং নীচে বিশদভাবে বর্ণনা করা হয়েছে।
  • ডিবাগিং মোড —আপনি যে পরিবেশ বা ট্র্যাকিং মোড ব্যবহার করেন না কেন, আপনি আপনার ট্র্যাকিং যাচাই ও পরীক্ষা করতে ডিবাগিং চালু করতে পারেন।

ট্র্যাকিং মোড

আপনি কীভাবে আপনার ফ্ল্যাশ সামগ্রী বিতরণ করেন তার উপর নির্ভর করে, ফ্ল্যাশ উপাদানগুলির জন্য অ্যানালিটিক্স একটি বিদ্যমান অ্যানালিটিক্স ট্র্যাকিং ইনস্টলেশনে ফ্ল্যাশ সামগ্রীর মধ্যে যোগাযোগের সেতু তৈরি করে বা সরাসরি অ্যানালিটিক্স সার্ভারগুলির সাথে যোগাযোগ করে অ্যানালিটিক্স সার্ভারগুলির সাথে যোগাযোগ করে৷ এই দুটি মোডকে যথাক্রমে ব্রিজ মোড এবং AS3 মোড বলা হয়। উভয় মোড একই অ্যানালিটিক্স ট্র্যাকিং কার্যকারিতা ব্যবহার করে এবং আপনার ফ্ল্যাশ অ্যাপ্লিকেশনটিকে এক মোড থেকে অন্য মোডে স্যুইচ করা সহজ৷ অ্যানালিটিক্স ট্র্যাকিংয়ের জন্য একটি যোগাযোগ মোড বেছে নেওয়ার পাশাপাশি, আপনি আপনার ট্র্যাকিংয়ের সমস্যা সমাধান বা যাচাই করতে একটি ডিবাগ মোড ব্যবহার করতে পারেন।

উভয় মোডে, প্রচারাভিযান ট্র্যাকিং কাজ করার জন্য allowscriptaccess always সমান হওয়া উচিত। এই প্যারামিটারটি পৃষ্ঠার ইউআরএল এবং ফ্ল্যাশ ট্র্যাকিং কোডের জন্য প্রয়োজনীয় রেফারারের তথ্য পড়ার অ্যাক্সেস চালু করে। স্ক্রিপ্ট allowscriptaccess ছাড়া, অ্যানালিটিক্স ট্র্যাকিং কোড সুন্দরভাবে হ্রাস পায়। এটি এখনও বেশিরভাগ ব্যবহারকারীর কার্যকলাপ ডেটা প্রদান করে, কিন্তু Google Analytics প্রচারাভিযান অ্যাট্রিবিউশন মডেল নিশ্চিত করবে না।

ব্রিজ মোড

আপনি যদি HTML পৃষ্ঠা এবং ফ্ল্যাশ বিষয়বস্তু উভয়ই নিয়ন্ত্রণ করেন তবে এই মোডটি ব্যবহার করুন৷ আপনি যদি ইতিমধ্যে আপনার ওয়েবসাইটে Google Analytics ( ga.js ) ট্র্যাকিং প্রয়োগ করে থাকেন এবং আপনি এমবেডেড ফ্ল্যাশ সামগ্রীতে ট্র্যাকিং যোগ করতে চান তাহলে এই মোডটি সর্বোত্তম৷ ব্রিজ মোড ga.js কোডে একটি ইউনিফাইড ActionScript 3 ইন্টারফেস প্রদান করে ফ্ল্যাশ-টু-জাভাস্ক্রিপ্ট যোগাযোগকে সহজ করে। ট্র্যাকিং কাজ করার জন্য এটি অ্যাকশনস্ক্রিপ্ট 3 কল থেকে অ্যানালিটিক্স জাভাস্ক্রিপ্টে সংযোগ প্রদান করে।

গুগল অ্যানালিটিক্স ট্র্যাকিং কোডের সাথে সংযোগ দুটি উপায়ে ওয়েব প্রপার্টি আইডি প্যারামিটারের মাধ্যমে কনফিগার করা যেতে পারে:

  • সবচেয়ে সাধারণ পদ্ধতি । Google Analytics ট্র্যাকিং কোড অবজেক্টটি ইতিমধ্যেই আপনার পৃষ্ঠায় তার নিজের নাম সহ বিদ্যমান, যেমন pageTracker । এই ক্ষেত্রে, আপনি ট্র্যাকিং অবজেক্টের সম্পূর্ণ DOM রেফারেন্স প্রদান করেন। উদাহরণস্বরূপ, যদি আপনার অবজেক্টকে pageTracker বলা হয়, তাহলে আপনি আপনার কোডে সেই বস্তুটিকে window.pageTracker হিসেবে উল্লেখ করবেন। উদাহরণস্বরূপ, নিম্নলিখিত কোড স্নিপেটটি ব্যাখ্যা করে যে এটি Adobe Flex পরিবেশ ব্যবহার করে ActionScript 3 ব্যবহার করে কীভাবে কনফিগার করা হবে:
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • বিকল্প পদ্ধতি । আপনি যদি আপনার পৃষ্ঠায় একটি পৃষ্ঠা ট্র্যাকিং অবজেক্ট তৈরি না করে থাকেন তবে আপনি কেবল আপনার ওয়েব সম্পত্তি আইডি পাস করতে পারেন এবং আপনার জন্য একটি JavaScript ট্র্যাকিং কোড অবজেক্ট তৈরি করা হবে৷ এই পদ্ধতিতে, আপনার HTML পৃষ্ঠায় বেস ga.js জাভাস্ক্রিপ্ট সোর্স ফাইলের রেফারেন্স এখনও প্রয়োজন। নিম্নলিখিত কোড স্নিপেটটি ব্যাখ্যা করে যে কীভাবে এটি Adobe Flex পরিবেশ ব্যবহার করে ActionScript 3 ব্যবহার করে কনফিগার করা হবে:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

ব্রিজ মোড সঠিকভাবে কাজ করার জন্য, ExternalInterface.available আপনার ActionScript 3 কোডে সত্য হিসাবে সেট করা আবশ্যক। এর মানে হল ফ্ল্যাশ বিষয়বস্তু এম্বেড করে এমন এইচটিএমএল পৃষ্ঠায় always allowScriptAccess সেট করা উচিত। নিম্নলিখিত উদাহরণটি ব্রিজ মোডের জন্য কনফিগার করা 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 অ্যাপ্লিকেশনের হোস্টিং পরিবেশ নিয়ন্ত্রণ না করলে এই মোডটি ব্যবহার করুন৷ উদাহরণস্বরূপ, আপনি যদি অনেক সাইট জুড়ে বিতরণের জন্য ফ্ল্যাশ সামগ্রী তৈরি করেন, তাহলে আপনি AS3 মোড ব্যবহার করবেন। AS3 মোড ga.js ট্র্যাকিং কোড থেকে সম্পূর্ণ স্বাধীন এবং সমস্ত Analytics ট্র্যাকিং কার্যকারিতা রয়েছে৷ এই মোডের সাথে আলাদা ga.js ট্র্যাকিং ইনস্টলেশনের প্রয়োজন নেই৷ উপরন্তু, AS3 মোড ব্যবহারকারীর জন্য সেশনের তথ্য ট্র্যাক করতে ফ্ল্যাশ স্টোরেজ প্রক্রিয়া ব্যবহার করে।

কিছু DOM প্যারামিটার যেমন ভাষার জন্য, AS3 উপাদান ব্রাউজার থেকে মান পুনরুদ্ধার করার চেষ্টা করে। মানগুলি উপস্থিত না থাকলে, উপাদানটি হয় ফ্ল্যাশ সমতুল্য মান ব্যবহার করে বা ডিফল্ট করে no

সমস্যা সমাধান এবং বৈধতা

অ্যাডোব ফ্ল্যাশ উপাদানের জন্য Google অ্যানালিটিক্স ট্র্যাকিং বৈধতা এবং সমস্যা সমাধানকে সহজ করার জন্য একটি ডিবাগ মোড প্রদান করে। সক্রিয় করা হলে, সমস্ত ট্র্যাকিং ডেটা আটকানো হয় এবং বিশ্লেষণ সার্ভারের পরিবর্তে একটি পাঠ্য বাক্সের একটি স্ক্রিনে নির্দেশিত হয়। এই মোডে, আপনি রিয়েল-টাইম ডেটা দেখতে পারেন যা অন্যথায় সার্ভার দ্বারা সংগ্রহ করা হবে। এই বৈশিষ্ট্যটি আপনার উত্পাদন ডেটার বাইরে পরীক্ষার ডেটা রাখতেও সহায়তা করে। আপনি কম্পোনেন্ট ইন্সপেক্টরে visualDebug বিকল্পটিকে true সেট করে সমস্যা সমাধানের বৈশিষ্ট্যটি সক্ষম করতে পারেন।

উদাহরণ

বিভিন্ন উন্নয়ন পরিবেশে ট্র্যাকিং বাস্তবায়নের বিস্তারিত উদাহরণের জন্য, নিম্নলিখিতগুলি দেখুন:

ফ্ল্যাশ

ফ্লেক্স

সংস্করণ করা

আপনি http://code.google.com/p/gaforflash/downloads/list- এ জিপ ফাইল হিসাবে ট্র্যাকিং উপাদানগুলির সর্বশেষ সংস্করণটি খুঁজে পেতে পারেন। প্রতিটি ডাউনলোডে সম্পর্কিত ডকুমেন্টেশন সহ সমস্ত ট্র্যাকিং উপাদান রয়েছে। ডাউনলোড ফাইলের জন্য ফাইলের নামটি এতে থাকা কোডটির সংস্করণ নম্বর প্রদর্শন করবে।

আউটপুট কনসোলে উপাদানটির বর্তমান সংস্করণ নম্বর মুদ্রণ করতে আপনি আপনার কোডে নিম্নলিখিত বিবৃতিগুলিও ব্যবহার করতে পারেন।

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