ইম্প্রেশন হলে, Google Mobile Ads Unity Plugin সেই ইম্প্রেশনের সাথে সম্পর্কিত বিজ্ঞাপন থেকে হওয়া উপার্জনের ডেটা প্রদান করে। আপনি এই ডেটা ব্যবহার করে কোনও ব্যবহারকারীর লাইফটাইম ভ্যালু গণনা করতে পারেন অথবা অন্যান্য প্রাসঙ্গিক সিস্টেমে ডেটা পাঠাতে পারেন।
এই নির্দেশিকাটি আপনার Unity প্রোজেক্টে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন ডেটা ক্যাপচার প্রয়োগ করতে সাহায্য করার জন্য তৈরি করা হয়েছে।
পূর্বশর্ত
- AdMob UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন ফিচার চালু করেছেন কিনা তা ভাল করে দেখে নিন।
- Unity প্লাগ-ইন 5.0.0 বা তার পরবর্তী যেকোনও ভার্সন।
- শুরু করুন বিকল্পে গিয়ে প্রসেসটি সম্পূর্ণ করুন। আপনার Unity অ্যাপে আগে থেকেই Google Mobile Ads Unity প্লাগ-ইন ইমপোর্ট করা থাকতে হবে।
ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে হওয়া উপার্জন সংক্রান্ত ডেটা পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট প্রয়োগ করতে হবে:
পেড ইভেন্ট হ্যান্ডলার প্রয়োগ করা
প্রতিটি বিজ্ঞাপন ফর্ম্যাটে একটি করে OnAdPaid ইভেন্ট থাকে। বিজ্ঞাপন ইভেন্টের লাইফসাইকেলে,
Google Mobile Ads Unity Plugin ইম্প্রেশন ইভেন্ট মনিটর করে এবং উপার্জন করা ভ্যালু
AdValue সহ হ্যান্ডলারকে ইনভোক করে।
নিচের উদাহরণটি পুরস্কার প্রদানকারী বিজ্ঞাপনের জন্য পেড ইভেন্ট ম্যানেজ করে:
private void LoadRewardedAd()
{
// Send the request to load the ad.
AdRequest adRequest = new AdRequest();
RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
{
// If the operation failed with a reason.
if (error != null)
{
Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
return;
}
rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
});
}
public void HandleAdPaidEvent(AdValue adValue)
{
// TODO: Send the impression-level ad revenue information to your
// preferred analytics server directly within this callback.
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"];
}
কাস্টম ইভেন্ট বিজ্ঞাপন সোর্সের নাম শনাক্ত করুন
কাস্টম ইভেন্ট বিজ্ঞাপন সোর্সের জন্য, AdSourceName প্রপার্টি আপনাকে বিজ্ঞাপন সোর্সের
নাম Custom Event দেয়। আপনি একাধিক কাস্টম ইভেন্ট ব্যবহার করলে, বিজ্ঞাপনের সোর্সের নাম
একাধিক কাস্টম ইভেন্টের মধ্যে পার্থক্য করার জন্য যথেষ্ট গ্রানুলার নয়। নির্দিষ্ট কাস্টম ইভেন্ট খুঁজতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
AdapterClassNameপ্রপার্টি পান।- বিজ্ঞাপন সোর্সের একটি অনন্য নাম সেট করুন।
নিম্নলিখিত উদাহরণটি একটি কাস্টম ইভেন্টের জন্য একটি অনন্য বিজ্ঞাপন সোর্সের নাম সেট করে:
private string GetAdSourceName(AdapterResponseInfo loadedAdapterResponseInfo)
{
if (loadedAdapterResponseInfo == null)
{
return string.Empty;
}
string adSourceName = loadedAdapterResponseInfo.AdSourceName;
if (adSourceName == "Custom Event")
{
#if UNITY_ANDROID
if (loadedAdapterResponseInfo.AdapterClassName ==
"com.google.ads.mediation.sample.customevent.SampleCustomEvent")
{
adSourceName = "Sample Ad Network (Custom Event)";
}
#elif UNITY_IPHONE
if (loadedAdapterResponseInfo.AdapterClassName == "SampleCustomEvent")
{
adSourceName = "Sample Ad Network (Custom Event)";
}
#endif
}
return adSourceName;
}সবচেয়ে ভাল পারফর্ম করা বিজ্ঞাপন সোর্স সম্পর্কে আরও জানতে, বিজ্ঞাপন থেকে পাওয়া উত্তরের তথ্য পুনরুদ্ধার করুন।
অ্যাপ অ্যাট্রিবিউশন পার্টনারের (AAP) সাথে ইন্টিগ্রেট করা
অ্যানালিটিক্স প্ল্যাটফর্মে বিজ্ঞাপন থেকে হওয়া উপার্জন সংক্রান্ত ডেটা ফরওয়ার্ড করা সম্পর্কে সম্পূর্ণ বিবরণ পেতে, পার্টনারের নির্দেশিকা দেখুন:
| পার্টনার SDK |
|---|
| অ্যাডজাস্ট করুন |
| AppsFlyer |
| একবচন |
| Tenjin |
প্রয়োগ করা সংক্রান্ত পেশাদার পদ্ধতি
- বিজ্ঞাপন অবজেক্ট তৈরি বা অ্যাক্সেস করার সাথে সাথেই
OnPaidEventইভেন্ট সেট করুন এবং অবশ্যই বিজ্ঞাপন দেখানোর আগে এটি করুন। এটি নিশ্চিত করে যে আপনি কোনও কলব্যাক মিস করবেন না। - আপনার
OnPaidEventহ্যান্ডলারে অবিলম্বে আপনার পছন্দের অ্যানালিটিক্স সার্ভারে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জনের তথ্য পাঠান। এর ফলে আপনি ভুলবশত কোনও কলব্যাক ড্রপ করবেন না এবং ডেটা সংক্রান্ত অসঙ্গতি এড়াতে পারবেন।
AdValue
AdValue হল একটি ক্লাস যা কোনও বিজ্ঞাপনের জন্য উপার্জিত আর্থিক মূল্যকে উপস্থাপন করে,
যার মধ্যে মূল্যের কারেন্সি কোড এবং এর নির্ভুলতার ধরন নিম্নলিখিতভাবে এনকোড করা থাকে।
AdValue.PrecisionType |
বিবরণ |
|---|---|
Unknown |
বিজ্ঞাপনের ভ্যালু যা অজানা। LTV পিংব্যাক চালু করা থাকলে, কিন্তু পর্যাপ্ত ডেটা উপলভ্য না থাকলে এটি ফেরত দেওয়া হয়। |
Estimated |
এগ্রিগেট করা ডেটা থেকে আনুমানিক বিজ্ঞাপন ভ্যালু। |
PublisherProvided |
প্রকাশকের প্রদান করা বিজ্ঞাপনের ভ্যালু, যেমন মধ্যস্থতাকারী গ্রুপে ম্যানুয়াল CPM। |
Precise |
এই বিজ্ঞাপনের সঠিক ভ্যালু। |
মধ্যস্থতার ক্ষেত্রে, AdMob অপ্টিমাইজ করা
বিজ্ঞাপন সোর্সের জন্য Estimatedভ্যালু প্রদান করার চেষ্টা করে। অপ্টিমাইজ না করা বিজ্ঞাপন সোর্সের জন্য অথবা যেখানে অর্থপূর্ণ অনুমান রিপোর্ট করার জন্য পর্যাপ্ত মোট ডেটা নেই,
সেখানে PublisherProvided ভ্যালু দেখানো হয়।
বিডিং বিজ্ঞাপন সোর্স থেকে পাওয়া টেস্ট ইম্প্রেশন
কোনও বিডিং বিজ্ঞাপন সোর্সের জন্য টেস্ট অনুরোধের মাধ্যমে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন সংক্রান্ত ইভেন্ট হওয়ার পরে, আপনি শুধুমাত্র নিম্নলিখিত ভ্যালু পাবেন:
Unknown: নির্ভুলতার ধরন নির্দেশ করে।
0: বিজ্ঞাপনের ভ্যালু নির্দেশ করে।
Unknown
ছাড়া অন্য কোনও ভ্যালু এবং বিজ্ঞাপনের ভ্যালু 0-এর থেকে বেশি হিসেবে দেখেছেন।
টেস্ট বিজ্ঞাপন অনুরোধ পাঠানোর ব্যাপারে বিস্তারিত জানতে, টেস্ট ডিভাইস চালু করুন দেখুন।