যখন একটি ইম্প্রেশন ঘটে, তখন Google মোবাইল বিজ্ঞাপন SDK সেই ইম্প্রেশনের সাথে যুক্ত বিজ্ঞাপনের আয়ের ডেটা প্রদান করে। আপনি একটি ব্যবহারকারীর জীবনকালের মান গণনা করতে ডেটা ব্যবহার করতে পারেন, বা অন্যান্য প্রাসঙ্গিক সিস্টেমে ডাটা ডাউনস্ট্রিম ফরোয়ার্ড করতে পারেন।
এই নির্দেশিকাটি আপনার ইউনিটি প্রজেক্টে ইম্প্রেশন-লেভেল অ্যাড রেভিনিউ ডেটা ক্যাপচার বাস্তবায়নে সাহায্য করার উদ্দেশ্যে।
পূর্বশর্ত
- নিশ্চিত করুন যে আপনি AdMob UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন আয় বৈশিষ্ট্যটি চালু করেছেন ।
- ইউনিটি প্লাগইন 5.0.0 বা উচ্চতর।
- শুরু করুন সম্পূর্ণ করুন। আপনার ইউনিটি অ্যাপে ইতিমধ্যেই Google মোবাইল বিজ্ঞাপন ইউনিটি প্লাগইন আমদানি করা উচিত।
আপনি কোনো ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ডেটা পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট বাস্তবায়ন করতে হবে:
একটি প্রদত্ত ইভেন্ট হ্যান্ডলার বাস্তবায়ন
প্রতিটি বিজ্ঞাপন বিন্যাস একটি OnAdPaid ইভেন্ট আছে. একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google মোবাইল বিজ্ঞাপন SDK ইম্প্রেশন ইভেন্টগুলি নিরীক্ষণ করে এবং অর্জিত মান উপস্থাপন করে একটি 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"];
}
বিজয়ী বিজ্ঞাপন উত্স সম্পর্কে আরও তথ্যের জন্য, বিজ্ঞাপন প্রতিক্রিয়া সম্পর্কে তথ্য পুনরুদ্ধার করা দেখুন।
অ্যাপ অ্যাট্রিবিউশন পার্টনারদের (AAP) সাথে একীভূত করুন
অ্যানালিটিক্স প্ল্যাটফর্মে বিজ্ঞাপনের আয়ের ডেটা ফরওয়ার্ড করার সম্পূর্ণ বিবরণের জন্য, অংশীদারের নির্দেশিকা পড়ুন:
| অংশীদার SDK |
|---|
| সামঞ্জস্য করুন |
| অ্যাপসফ্লায়ার |
| একবচন |
| তেনজিন |
বাস্তবায়নের সর্বোত্তম অনুশীলন
- আপনি একবার বিজ্ঞাপন অবজেক্ট তৈরি বা অ্যাক্সেস পাওয়ার সাথে সাথে এবং অবশ্যই বিজ্ঞাপন দেখানোর আগে
OnPaidEventইভেন্ট ইভেন্ট সেট করুন। এটি নিশ্চিত করে যে আপনি কোনো কলব্যাক মিস করবেন না। - আপনার
OnPaidEventহ্যান্ডলারে অবিলম্বে আপনার পছন্দের অ্যানালিটিক্স সার্ভারে ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের তথ্য পাঠান। এটি নিশ্চিত করে যে আপনি ভুলবশত কোনো কলব্যাক ড্রপ করবেন না এবং ডেটার অসঙ্গতি এড়ান।
AdValue
AdValue হল এমন একটি শ্রেণী যা একটি বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যকে প্রতিনিধিত্ব করে, যার মধ্যে মানের মুদ্রা কোড এবং নিচের মত এনকোড করা এর নির্ভুলতা প্রকার।
AdValue.PrecisionType | বর্ণনা |
|---|---|
Unknown | একটি বিজ্ঞাপন মান যা অজানা। এলটিভি পিংব্যাক সক্ষম হলে এটি ফেরত দেওয়া হয় কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না। |
Estimated | সমষ্টিগত ডেটা থেকে আনুমানিক একটি বিজ্ঞাপন মান। |
PublisherProvided | একজন প্রকাশক বিজ্ঞাপনের মান প্রদান করেছেন, যেমন একটি মধ্যস্থতা গোষ্ঠীতে ম্যানুয়াল CPM। |
Precise | এই বিজ্ঞাপনের সুনির্দিষ্ট মান. |
মধ্যস্থতার ক্ষেত্রে, AdMob অপ্টিমাইজ করা বিজ্ঞাপন উত্সগুলির জন্য একটি Estimated মান প্রদান করার চেষ্টা করে৷ অ-অপ্টিমাইজ করা বিজ্ঞাপন উত্সগুলির জন্য, বা যেখানে অর্থপূর্ণ অনুমান রিপোর্ট করার জন্য পর্যাপ্ত সমষ্টিগত ডেটা নেই, PublisherProvided মান ফেরত দেওয়া হয়।
বিডিং বিজ্ঞাপন উত্স থেকে ইম্প্রেশন পরীক্ষা করুন
একটি পরীক্ষার অনুরোধের মাধ্যমে একটি বিডিং বিজ্ঞাপন উত্সের জন্য একটি ইম্প্রেশন-স্তরের বিজ্ঞাপন আয় ইভেন্ট হওয়ার পরে, আপনি শুধুমাত্র নিম্নলিখিত মানগুলি পাবেন:
-
Unknown: নির্ভুলতা প্রকার নির্দেশ করে।
-
0: বিজ্ঞাপনের মান নির্দেশ করে।
পূর্বে, আপনি Unknown ব্যতীত অন্য একটি মান এবং 0 এর বেশি একটি বিজ্ঞাপনের মান হিসাবে নির্ভুলতা ধরন দেখে থাকতে পারেন।
পরীক্ষার বিজ্ঞাপনের অনুরোধ পাঠানোর বিষয়ে বিস্তারিত জানার জন্য, পরীক্ষা ডিভাইস সক্ষম করুন দেখুন।