Google Analytics-এর সাজেস্ট করা এবং কাস্টম ইভেন্ট পাঠানোর জন্য Data Manager API ব্যবহার করুন।
সাজেস্ট করা ও কাস্টম ইভেন্ট পাঠান
আপনি Google Analytics Measurement Protocol থেকে আপগ্রেড করলে নির্দেশের জন্য Measurement Protocol থেকে Data Manager API-তে আপগ্রেড করুন বিকল্পটি চেক করুন।
ওয়ার্কফ্লো এক নজরে
ডেটা ম্যানেজার API-এর মাধ্যমে ইভেন্ট ডেটা পাঠাতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
গন্তব্য প্রস্তুত করুন: টার্গেট অ্যাকাউন্ট ও কনভার্সন বা ইভেন্ট গন্তব্য নির্দিষ্ট করতে, ইনজেশন অনুরোধের
destinationsফিল্ডের জন্যDestinationঅবজেক্ট নির্দিষ্ট করুন। গন্তব্য প্রস্তুত করুন বিকল্পে গিয়ে বিস্তারিত বিবরণ দেখুন।ইভেন্ট ডেটা ও শনাক্তকারী প্রস্তুত করা: ইভেন্টের বিবরণ ও প্রয়োজনীয় শনাক্তকারী (যেমন, বিজ্ঞাপন ক্লিক, ক্লায়েন্ট বা অ্যাপ ইনস্ট্যান্স শনাক্তকারী) দিয়ে
Eventফিল্ড পূরণ করুন। আপনি যদিuserData-এ ব্যবহারকারীর যোগাযোগের তথ্য অন্তর্ভুক্ত করেন, তাহলে ফর্ম্যাটিং নির্দেশিকা অনুযায়ী আইডেন্টিফায়ারগুলিকে নরমালাইজ এবং SHA-256 হ্যাশ করুন এবং বিকল্প হিসেবে সেগুলিকে এনক্রিপ্ট করুন। বিবরণের জন্য ইভেন্ট ডেটা প্রস্তুত করা দেখুন।ইনজেশন অনুরোধ তৈরি ও পাঠানো: আপনার
destinations,Eventরেকর্ড ওencryptionInfoসহ একটি অনুরোধ জমা দিন এবং আপনি যদিuserDataএনক্রিপ্ট করে থাকেন।events.ingestপ্রোডাকশন ডেটা পাঠানোর আগেvalidateOnly: trueব্যবহার করে দ্রুত-ফেল হওয়া সংক্রান্ত সমস্যার জন্য আপনার পেলোড পরীক্ষা করুন। ফিল্ডের প্রয়োজনীয়তা ও কোড স্যাম্পেলের জন্য ইভেন্ট পাঠান বিকল্প দেখুন।ডায়াগনস্টিক চেক করুন: অ্যাসিঙ্ক্রোনাস প্রসেসিং ডায়াগনস্টিকস পান এবং
requestStatus.retrieve-এর মাধ্যমে ইনজেশন স্ট্যাটাস যাচাই করুন।
যেসব ক্ষেত্রে ব্যবহার করা যাবে
Data Manager API-এর মাধ্যমে সাজেস্ট করা ও কাস্টম ইভেন্ট পাঠানোর কিছু ব্যবহারিক উদাহরণ এখানে দেওয়া হল:
অনলাইন ও অফলাইন আচরণকে সংযুক্ত করা।
ক্লায়েন্ট-সাইড ও সার্ভার-সাইড ইন্টার্যাকশন পরিমাপ করুন।
অফলাইন কনভার্সনের মতো স্ট্যান্ডার্ড ব্যবহারকারীর ইন্টার্যাকশনের বাইরে ঘটে যাওয়া ইভেন্ট পাঠান।
কিয়স্ক ও ওয়াচের মতো যেসব ডিভাইস ও অ্যাপে অটোমেটিক সংগ্রহ করার সুবিধা উপলভ্য নেই, সেগুলি থেকে ইভেন্ট পাঠানো।
ব্যবহারকারীর দেওয়া ডেটা
আপনি Event-এর userData ফিল্ডে হ্যাশ করা ইমেল আইডি, ফোন নম্বর ও আসল ঠিকানার মতো ফার্স্ট-পার্টি গ্রাহক ডেটা পাঠাতে পারবেন। এটি
Google Analytics-এ কনভার্সন পরিমাপ, অ্যাট্রিবিউশন ও অডিয়েন্স তৈরি করার
প্রক্রিয়া উন্নত করতে সাহায্য করে।
ব্যবহারকারীর দেওয়া ডেটা পাঠানোর সময় নিম্নলিখিত বিষয়গুলি মনে রাখবেন:
ইভেন্টের সাথে পাঠানো: ডেটা ম্যানেজার API-তে, ব্যবহারকারীর প্রদান করা ডেটা অবশ্যই
Event-এর অংশ হিসেবে পাঠাতে হবে। ইভেন্ট ছাড়া স্ট্যান্ডঅ্যালোন আপলোড কাজ করে না।ফর্ম্যাটিং ও হ্যাশিং: ব্যক্তিগত শনাক্তকারী (যেমন ইমেল আইডি, ফোন নম্বর, নাম ও রাস্তার ঠিকানা) আপলোড করার আগে SHA-256 ব্যবহার করে অবশ্যই নরমালাইজ ও হ্যাশ করতে হবে। অন্যান্য ফিল্ড (যেমন, শহর, রাজ্য বা প্রদেশ, পিন কোড ও দেশের কোড) স্বাভাবিক করা হয় কিন্তু হ্যাশ করা হয় না। নির্দিষ্ট প্রয়োজনীয়তার জন্য ব্যবহারকারীর ডেটা ফর্ম্যাট করুন গাইড অনুসরণ করুন।
এনক্রিপশন: আপনি ঐচ্ছিকভাবে হ্যাশ করা ব্যবহারকারীর ডেটা এনক্রিপ্ট করতে পারেন।
User-ID: যখনই কোনও সামঞ্জস্যপূর্ণ ইউজার আইডেন্টিফায়ার উপলভ্য থাকে, তখন আমরা
userData-এর পাশাপাশিuserIdপ্রদান করার সাজেশন দিই।প্রয়োগ: অনুরোধ তৈরি করার নির্দেশাবলীর জন্য ব্যবহারকারীর প্রদান করা ডেটা যোগ করুন দেখুন।
ইন্টিগ্রেশন সংক্রান্ত বিষয়
ডেটা ম্যানেজার API ব্যবহার করার সময় নিম্নলিখিত বিষয়গুলি মনে রাখবেন।
রিমার্কেটিং
আপনি Google সিগন্যাল চালু করলে, Google Analytics একই ডিভাইসে রিমার্কেটিং করার সুবিধা দেয়। ক্রস-ডিভাইস রিমার্কেটিংয়ের জন্য, userId প্রয়োজন।
এছাড়াও, ফার্স্ট-পার্টি অডিয়েন্স ম্যাচিং চালু করতে আপনি ব্যবহারকারীর দেওয়া ডেটা পাঠাতে পারবেন।
বিজ্ঞাপন শনাক্তকারী
Google Analytics অটোমেটিক অনলাইন ইন্টার্যাকশনের সময় সংগৃহীত বিজ্ঞাপন শনাক্তকারী (যেমন GBRAID বা WBRAID)
clientId বা appInstanceId ব্যবহার করে
Data Manager API ইভেন্টের সাথে যোগ করে।
গোপনীয়তা সেটিংস
Google Analytics, clientId বা appInstanceId ব্যবহার করে অনলাইন ইন্টার্যাকশনের সাথে Data Manager API ইভেন্ট যোগ করে, যাতে "পছন্দমতো সেট না করা বিজ্ঞাপন" এবং "বিজ্ঞাপন ট্র্যাকিং সীমিত করা"-এর মতো ব্যবহারকারীর গোপনীয়তা সেটিংস গ্রহণ করা যায়।
এছাড়াও, আপনি consent অবজেক্ট ব্যবহার করে প্রতিটি ইভেন্টে সরাসরি ব্যবহারকারীর সম্মতি সংক্রান্ত সেটিংস নির্দিষ্ট করতে পারবেন।
ভৌগোলিক ও ডিভাইস সংক্রান্ত তথ্য
Google Analytics অটোমেটিক clientId বা appInstanceId ব্যবহার করে ডেটা ম্যানেজার API ইভেন্টের সাথে ট্যাগিং থেকে
সবচেয়ে সাম্প্রতিক ভৌগোলিক এবং ডিভাইস সংক্রান্ত তথ্য যোগ করে।
এটি নিশ্চিত করে যে আপনার Data Manager API ইভেন্টগুলি সেইসব রিপোর্টে প্রতিফলিত হয় যেগুলিতে
ভৌগোলিক ও ডিভাইস সংক্রান্ত ডাইমেনশন অন্তর্ভুক্ত থাকে।
আপনি যদি চান যে কোনও Data Manager API ইভেন্ট clientId বা appInstanceId-এর লেটেস্ট তথ্যের পরিবর্তে কোনও নির্দিষ্ট সেশন থেকে ভৌগোলিক এবং ডিভাইস সংক্রান্ত তথ্য দেখাক, তাহলে additionalEventParameters-এ একটি এন্ট্রি অন্তর্ভুক্ত করুন যেখানে parameterName-কে session_id-এ সেট করা হয়েছে এবং value-কে নির্দিষ্ট সেশনের আইডিতে সেট করা হয়েছে এবং সেশন শুরু হওয়ার ২৪ ঘণ্টার মধ্যে ইভেন্টটি পাঠান।
আপনি Data Manager API ব্যবহার করে ইভেন্টের জন্য ভৌগোলিক তথ্য এবং ডিভাইস সংক্রান্ত তথ্য প্রদান করতে পারেন।
সম্পূর্ণ সার্ভার-টু-সার্ভার
শুধুমাত্র ডেটা ম্যানেজার API-এর মাধ্যমে Google Analytics-এ ইভেন্ট পাঠানো সম্ভব হলেও, শুধুমাত্র আংশিক রিপোর্টিং উপলভ্য হতে পারে। Data Manager API-এর উদ্দেশ্য হল gtag, Tag Manager বা Firebase ব্যবহার করে সংগ্রহ করা বর্তমান ইভেন্টগুলিকে আরও উন্নত করা। কিছু ইভেন্ট ও প্যারামিটারের নাম অটোমেটিক সংগ্রহের মাধ্যমে ব্যবহারের জন্য রিজার্ভ করা আছে এবং সেগুলি ডেটা ম্যানেজার API-এর মাধ্যমে পাঠানো যাবে না।
ইভেন্ট তৈরি বা নাম পরিবর্তন করা
ডেটা ম্যানেজার API-এর মাধ্যমে পাঠানো ইভেন্ট ইভেন্ট তৈরি বা নাম পরিবর্তন করার জন্য নিয়ম ট্রিগার করে না। আপনার অ্যাপ্লিকেশনকে ডেটা ম্যানেজার API-এর মাধ্যমে কাস্টম ইভেন্ট পাঠানোর লজিক প্রয়োগ করতে হবে, এটি Google Analytics UI-তে কনফিগার করা নিয়মের মতোই।