Google Analytics-এর সাজেস্ট করা এবং কাস্টম ইভেন্ট পাঠাতে ডেটা ম্যানেজার API ব্যবহার করুন।
সাজেস্ট করা ও কাস্টম ইভেন্ট পাঠান
আপনি Google Analytics Measurement Protocol থেকে আপগ্রেড করলে নির্দেশের জন্য Measurement Protocol থেকে Data Manager API-তে আপগ্রেড করুন বিকল্পটি চেক করুন।
ওয়ার্কফ্লো ওভারভিউ
ডেটা ম্যানেজার API-এর মাধ্যমে ইভেন্ট ডেটা পাঠাতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
গন্তব্য প্রস্তুত করুন: টার্গেট অ্যাকাউন্ট এবং কনভার্সন বা ইভেন্টের গন্তব্য নির্দিষ্ট করতে, ইনজেশন অনুরোধের
destinationsফিল্ডের জন্যDestinationঅবজেক্টগুলি নির্দিষ্ট করুন। গন্তব্য প্রস্তুত করুন বিকল্পে গিয়ে বিস্তারিত বিবরণ দেখুন।ইভেন্ট ডেটা ও শনাক্তকারী প্রস্তুত করা: ইভেন্টের বিবরণ ও প্রয়োজনীয় শনাক্তকারী (যেমন, বিজ্ঞাপন ক্লিক, ক্লায়েন্ট বা অ্যাপ ইনস্ট্যান্স শনাক্তকারী) দিয়ে
Eventফিল্ড পূরণ করুন। আপনি যদিuserData-এ ব্যবহারকারীর যোগাযোগের তথ্য অন্তর্ভুক্ত করেন, তাহলে ফর্ম্যাটিং নির্দেশিকা অনুযায়ী শনাক্তকারীকে নরমালাইজ এবং SHA-256 হ্যাশ করুন এবং বিকল্প হিসেবে সেগুলি এনক্রিপ্ট করুন। আরও বিবরণের জন্য ইভেন্ট ডেটা প্রস্তুত করুন দেখুন।ইনজেশন অনুরোধ তৈরি করে পাঠান: একটি
events.ingestঅনুরোধ জমা দিন যাতে আপনারdestinations,Eventরেকর্ড এবংencryptionInfoথাকে, যদি আপনিuserDataএনক্রিপ্ট করে থাকেন। প্রোডাকশন ডেটা পাঠানোর আগে ফাস্ট-ফেল সমস্যার জন্য আপনার পেলোড পরীক্ষা করতেvalidateOnly: trueব্যবহার করুন। ফিল্ডের প্রয়োজনীয়তা ও কোড স্যাম্পেলের জন্য ইভেন্ট পাঠান বিকল্প দেখুন।ডায়াগনস্টিক চেক করা: অ্যাসিঙ্ক্রোনাস প্রসেসিং ডায়াগনস্টিক পুনরুদ্ধার করুন এবং
requestStatus.retrieve-এর মাধ্যমে ইনজেশন স্ট্যাটাস যাচাই করুন।
যেসব ক্ষেত্রে ব্যবহার করা যাবে
ডেটা ম্যানেজার 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 ইভেন্টের সাথে ট্যাগিং থেকে
সবচেয়ে সাম্প্রতিক ভৌগোলিক এবং ডিভাইস সংক্রান্ত তথ্য যোগ করে।
এটি নিশ্চিত করে যে আপনার ডেটা ম্যানেজার 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-এর মাধ্যমে পাঠানো ইভেন্ট ইভেন্ট তৈরি বা নাম পরিবর্তন করার জন্য নিয়ম ট্রিগার করে না। Google Analytics UI-তে কনফিগার করা নিয়মের মতো, আপনার অ্যাপ্লিকেশনকে ডেটা ম্যানেজার API-এর মাধ্যমে কাস্টম ইভেন্ট পাঠানোর লজিক প্রয়োগ করতে হবে।