যখন কোনো ইম্প্রেশন ঘটে, তখন Google Mobile Ads Unity Plugin সেই ইম্প্রেশনের সাথে সম্পর্কিত বিজ্ঞাপনের রাজস্বের ডেটা সরবরাহ করে। আপনি এই ডেটা ব্যবহার করে একজন ব্যবহারকারীর লাইফটাইম ভ্যালু গণনা করতে পারেন, অথবা ডেটাটি পরবর্তী পর্যায়ে অন্যান্য প্রাসঙ্গিক সিস্টেমে ফরোয়ার্ড করতে পারেন।
এই নির্দেশিকাটি আপনাকে আপনার ইউনিটি প্রজেক্টে ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ডেটা ক্যাপচার বাস্তবায়নে সাহায্য করার উদ্দেশ্যে তৈরি।
পূর্বশর্ত
- নিশ্চিত করুন যে আপনি অ্যাড ম্যানেজার UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন রাজস্ব বৈশিষ্ট্যটি চালু করেছেন ।
- ইউনিটি প্লাগইন ৫.০.০ বা উচ্চতর সংস্করণ।
- শুরু করুন সম্পূর্ণ করুন। আপনার ইউনিটি অ্যাপে আগে থেকেই Google Mobile Ads Unity Plugin ইম্পোর্ট করা থাকা উচিত।
যেকোনো ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ডেটা পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফরম্যাট প্রয়োগ করতে হবে:
একটি পেইড ইভেন্ট হ্যান্ডলার প্রয়োগ করুন
প্রতিটি বিজ্ঞাপন ফরম্যাটের একটি OnPaidEvent ইভেন্ট থাকে। একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google Mobile Ads Unity Plugin ইম্প্রেশন ইভেন্টগুলো পর্যবেক্ষণ করে এবং একটি অর্জিত মান (earned value) সহ হ্যান্ডলারটিকে আহ্বান করে।
নিচের কোডটিতে দেখানো হয়েছে কিভাবে একটি রিওয়ার্ডেড অ্যাডের পেইড ইভেন্টগুলো পরিচালনা করতে হয়:
RewardedAd rewardedAd; private void RequestRewardedAd() { rewardedAd = new RewardedAd("AD_UNIT_ID"); rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; AdRequest adRequest = new AdRequest(); rewardedAd.LoadAd(adRequest); } public void HandleAdPaidEvent(object sender, AdValueEventArgs args) { // TODO: Send the impression-level ad revenue information to your // preferred analytics server directly within this callback. AdValue adValue = args.AdValue; long valueMicros = adValue.Value; string currencyCode = adValue.CurrencyCode; PrecisionType precision = adValue.Precision; ResponseInfo responseInfo = rewardedAd.GetResponseInfo(); string responseId = responseInfo.GetResponseId(); AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo(); string adSourceId = loadedAdapterResponseInfo.AdSourceId; string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId; string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName; string adSourceName = loadedAdapterResponseInfo.AdSourceName; string adapterClassName = loadedAdapterResponseInfo.AdapterClassName; long latencyMillis = loadedAdapterResponseInfo.LatencyMillis; Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping; Dictionary<string, string> extras = responseInfo.GetResponseExtras(); string mediationGroupName = extras["mediation_group_name"]; string mediationABTestName = extras["mediation_ab_test_name"]; string mediationABTestVariant = extras["mediation_ab_test_variant"]; }
বিজয়ী বিজ্ঞাপন উৎস সম্পর্কে আরও তথ্যের জন্য, বিজ্ঞাপনের প্রতিক্রিয়া সম্পর্কিত তথ্য পুনরুদ্ধার দেখুন।
অ্যাপ অ্যাট্রিবিউশন পার্টনার (AAP)-এর সাথে একীভূতকরণ
অ্যানালিটিক্স প্ল্যাটফর্মে বিজ্ঞাপনের রাজস্ব ডেটা পাঠানোর বিষয়ে সম্পূর্ণ বিবরণের জন্য, পার্টনার গাইডটি দেখুন:
| পার্টনার এসডিকে |
|---|
| সমন্বয় করুন |
| অ্যাপসফ্লায়ার |
| একবচন |
| তেনজিন |
বাস্তবায়নের সর্বোত্তম অনুশীলন
- অ্যাড অবজেক্ট তৈরি করার বা সেটির অ্যাক্সেস পাওয়ার সাথে সাথেই
OnPaidEventইভেন্টটি সেট করুন, এবং অবশ্যই বিজ্ঞাপনটি দেখানোর আগে। এটি নিশ্চিত করে যে আপনি কোনো কলব্যাক মিস করবেন না। - আপনার
OnPaidEventহ্যান্ডলারে ইম্প্রেশন-স্তরের বিজ্ঞাপনের আয়ের তথ্য অবিলম্বে আপনার পছন্দের অ্যানালিটিক্স সার্ভারে পাঠিয়ে দিন। এটি নিশ্চিত করে যে আপনি ভুলবশত কোনো কলব্যাক বাদ দিচ্ছেন না এবং ডেটার অমিল এড়ানো যায়।
অ্যাডভ্যালু
AdValue হলো একটি ক্লাস যা একটি বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যকে উপস্থাপন করে, যার মধ্যে মূল্যটির কারেন্সি কোড এবং এর প্রিসিশন টাইপ নিচে বর্ণিত পদ্ধতিতে এনকোড করা থাকে।
AdValue.PrecisionType | বর্ণনা |
|---|---|
Unknown | একটি অজানা বিজ্ঞাপনের মান। যখন LTV পিংব্যাক সক্রিয় থাকে কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না, তখন এটি ফেরত আসে। |
Estimated | সংগৃহীত ডেটা থেকে আনুমানিক বিজ্ঞাপনের মূল্য। |
PublisherProvided | একজন প্রকাশক একটি মিডিয়েশন গ্রুপে ম্যানুয়াল সিपीएम-এর মতো বিজ্ঞাপনের মান প্রদান করেছেন। |
Precise | এই বিজ্ঞাপনটির সঠিক মূল্য। |
মিডিয়েশনের ক্ষেত্রে, অ্যাড ম্যানেজার সেইসব অ্যাড সোর্সের জন্য একটি ESTIMATED মান দেওয়ার চেষ্টা করে যেগুলিতে স্বয়ংক্রিয় ডেটা সংগ্রহ চালু আছে। আরও তথ্যের জন্য, স্বয়ংক্রিয় ডেটা সংগ্রহ দেখুন। যেসব অ্যাড সোর্সে স্বয়ংক্রিয় ডেটা সংগ্রহ চালু নেই, অথবা যেখানে একটি অর্থপূর্ণ অনুমান জানানোর জন্য পর্যাপ্ত একত্রিত ডেটা নেই, সেখানে PUBLISHER_PROVIDED মানটি ফেরত দেওয়া হয়।
উন্মুক্ত নিলাম থেকে প্রাপ্ত পরীক্ষামূলক ধারণা
একটি টেস্ট রিকোয়েস্টের মাধ্যমে কোনো ওপেন বিডিং অ্যাড সোর্সের জন্য ইম্প্রেশন-লেভেল অ্যাড রেভিনিউ ইভেন্ট সংঘটিত হওয়ার পর, আপনি শুধুমাত্র নিম্নলিখিত ভ্যালুগুলো পাবেন:
-
Unknown: নির্ভুলতার ধরণ নির্দেশ করে।
-
0: বিজ্ঞাপনের মান নির্দেশ করে।
পূর্বে, আপনি হয়তো প্রিসিশন টাইপটিকে Unknown ছাড়া অন্য কোনো মান এবং 0 এর বেশি কোনো অ্যাড ভ্যালু হিসেবে দেখে থাকতে পারেন।
টেস্ট বিজ্ঞাপনের অনুরোধ পাঠানোর বিস্তারিত তথ্যের জন্য, ‘টেস্ট ডিভাইস সক্ষম করুন’ দেখুন।