যখন কোনও ইম্প্রেশন দেখা দেয়, তখন Google মোবাইল বিজ্ঞাপন SDK সেই ইম্প্রেশনের সাথে সম্পর্কিত বিজ্ঞাপনের আয়ের ডেটা সরবরাহ করে। আপনি ব্যবহারকারীর জীবনকাল গণনা করতে ডেটা ব্যবহার করতে পারেন, অথবা অন্যান্য প্রাসঙ্গিক সিস্টেমে ডেটা ফরোয়ার্ড করতে পারেন।
এই নির্দেশিকাটি আপনার ইউনিটি প্রকল্পে ইম্প্রেশন-স্তরের বিজ্ঞাপন রাজস্ব ডেটা ক্যাপচার বাস্তবায়নে সহায়তা করার উদ্দেশ্যে তৈরি।
পূর্বশর্ত
- বিজ্ঞাপন ম্যানেজার UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন আয়ের বৈশিষ্ট্যটি চালু করেছেন কিনা তা নিশ্চিত করুন।
- ইউনিটি প্লাগইন ৫.০.০ বা তার বেশি।
- শুরু করুন সম্পূর্ণ করুন । আপনার ইউনিটি অ্যাপে ইতিমধ্যেই Google মোবাইল বিজ্ঞাপন ইউনিটি প্লাগইন আমদানি করা উচিত।
কোনও ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ডেটা পাওয়ার আগে, আপনাকে কমপক্ষে একটি বিজ্ঞাপন ফর্ম্যাট প্রয়োগ করতে হবে:
একটি পেইড ইভেন্ট হ্যান্ডলার বাস্তবায়ন করুন
প্রতিটি বিজ্ঞাপন ফর্ম্যাটের একটি OnPaidEvent ইভেন্ট থাকে। একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google মোবাইল বিজ্ঞাপন SDK ইম্প্রেশন ইভেন্টগুলি পর্যবেক্ষণ করে এবং একটি অর্জিত মান সহ হ্যান্ডলারকে আহ্বান করে।
নিচের কোডটি দেখায় কিভাবে একটি পুরস্কৃত বিজ্ঞাপনের জন্য অর্থপ্রদানের ইভেন্টগুলি পরিচালনা করতে হয়:
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) এর সাথে একীভূতকরণ
বিজ্ঞাপনের রাজস্বের তথ্য বিশ্লেষণ প্ল্যাটফর্মে ফরোয়ার্ড করার সম্পূর্ণ বিবরণের জন্য, অংশীদারের নির্দেশিকাটি দেখুন:
| পার্টনার SDK |
|---|
| সামঞ্জস্য করুন |
| অ্যাপসফ্লায়ার |
| একবচন |
| তেনজিন |
বাস্তবায়নের সর্বোত্তম অনুশীলন
- বিজ্ঞাপনের অবজেক্ট তৈরি করার সাথে সাথে অথবা অ্যাক্সেস পাওয়ার সাথে সাথেই
OnPaidEventইভেন্ট সেট করুন, এবং অবশ্যই বিজ্ঞাপন দেখানোর আগে। এটি নিশ্চিত করে যে আপনি কোনও কলব্যাক মিস করবেন না। - আপনার
OnPaidEventহ্যান্ডলারে আপনার পছন্দের অ্যানালিটিক্স সার্ভারে ইম্প্রেশন-লেভেল বিজ্ঞাপনের রাজস্ব তথ্য অবিলম্বে পাঠান। এটি নিশ্চিত করে যে আপনি ভুলবশত কোনও কলব্যাক ড্রপ করবেন না এবং ডেটার অসঙ্গতি এড়াবেন।
বিজ্ঞাপন মূল্য
AdValue হল এমন একটি শ্রেণী যা একটি বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যের প্রতিনিধিত্ব করে, যার মধ্যে মূল্যের মুদ্রা কোড এবং নীচের মতো এনকোড করা তার নির্ভুলতার ধরণ অন্তর্ভুক্ত থাকে।
AdValue.PrecisionType | বিবরণ |
|---|---|
Unknown | একটি অজানা বিজ্ঞাপনের মান। LTV পিংব্যাক সক্ষম করা থাকলে এটি ফেরত দেওয়া হয় কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না। |
Estimated | সমষ্টিগত ডেটা থেকে আনুমানিক একটি বিজ্ঞাপনের মূল্য। |
PublisherProvided | একজন প্রকাশক একটি মধ্যস্থতা গোষ্ঠীতে বিজ্ঞাপনের মূল্য প্রদান করেছেন, যেমন ম্যানুয়াল সিপিএম। |
Precise | এই বিজ্ঞাপনের সঠিক মূল্য। |
মধ্যস্থতার ক্ষেত্রে, বিজ্ঞাপন পরিচালক স্বয়ংক্রিয় ডেটা সংগ্রহ চালু থাকা বিজ্ঞাপন উৎসগুলির জন্য একটি ESTIMATED মান প্রদান করার চেষ্টা করে। আরও তথ্যের জন্য, স্বয়ংক্রিয় ডেটা সংগ্রহ দেখুন। স্বয়ংক্রিয় ডেটা সংগ্রহ চালু না থাকা বিজ্ঞাপন উৎসগুলির জন্য, অথবা যেখানে অর্থপূর্ণ অনুমান রিপোর্ট করার জন্য পর্যাপ্ত সমষ্টিগত ডেটা নেই, PUBLISHER_PROVIDED মানটি ফেরত পাঠানো হয়।
ওপেন বিডিং থেকে পরীক্ষার ইম্প্রেশন
একটি পরীক্ষার অনুরোধের মাধ্যমে একটি ওপেন বিডিং বিজ্ঞাপন উৎসের জন্য একটি ইম্প্রেশন-লেভেল বিজ্ঞাপন আয়ের ইভেন্ট সংঘটিত হওয়ার পরে, আপনি শুধুমাত্র নিম্নলিখিত মানগুলি পাবেন:
-
Unknown: নির্ভুলতার ধরণ নির্দেশ করে।
-
0: বিজ্ঞাপনের মান নির্দেশ করে।
পূর্বে, আপনি হয়তো Precision টাইপটিকে Unknown ব্যতীত অন্য একটি মান এবং 0 এর বেশি বিজ্ঞাপনের মান হিসেবে দেখেছেন।
পরীক্ষামূলক বিজ্ঞাপনের অনুরোধ পাঠানোর বিশদ বিবরণের জন্য, পরীক্ষামূলক ডিভাইস সক্ষম করুন দেখুন।