যখন কোনো ইম্প্রেশন ঘটে, Google Mobile Ads SDK তার সংশ্লিষ্ট রেভিনিউ ডেটা সহ পেইড ইভেন্ট হ্যান্ডলারকে কল করে। এই হ্যান্ডলারটি ইমপ্লিমেন্ট করার মাধ্যমে, আপনি ডেটা ব্যবহার করে একজন ব্যবহারকারীর লাইফটাইম ভ্যালু গণনা করতে পারেন, অথবা ডেটাটি পরবর্তী পর্যায়ে অন্যান্য প্রাসঙ্গিক সিস্টেমে ফরোয়ার্ড করতে পারেন।
এই নির্দেশিকাটি আপনাকে আপনার iOS অ্যাপে LTV ডেটা ক্যাপচার বাস্তবায়ন করতে সাহায্য করার উদ্দেশ্যে তৈরি।
পূর্বশর্ত
- নিশ্চিত করুন যে আপনি অ্যাড ম্যানেজার UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন রাজস্ব বৈশিষ্ট্যটি চালু করেছেন ।
- Google Mobile Ads SDK ৯.১০.০ বা উচ্চতর সংস্করণ ইম্পোর্ট করুন।
- Google Mobile Ads SDK সেট আপ করুন ।
ইম্প্রেশন-স্তরের বিজ্ঞাপন থেকে আয় পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফরম্যাট প্রয়োগ করতে হবে:
একটি পেইড ইভেন্ট হ্যান্ডলার প্রয়োগ করুন
প্রতিটি বিজ্ঞাপন ফরম্যাটের GADPaidEventHandler টাইপের একটি paidEventHandler প্রপার্টি থাকে। একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google Mobile Ads SDK ইম্প্রেশন ইভেন্টগুলো পর্যবেক্ষণ করে এবং একটি আর্নড ভ্যালু সহ হ্যান্ডলারটিকে কল করে।
নিম্নলিখিত উদাহরণটি একটি রিওয়ার্ডেড অ্যাডের পেইড ইভেন্টগুলো পরিচালনা করে:
সুইফট
rewardedAd?.paidEventHandler = { adValue in
// TODO: Send the impression-level ad revenue information to your preferred
// analytics server directly within this callback.
// Extract the impression-level ad revenue data.
let value = adValue.value
let currencyCode = adValue.currencyCode
let precision = adValue.precision
print(
"Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
)
}
উদ্দেশ্য-সি
rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
// TODO: Send the impression-level ad revenue information to your preferred
// analytics server directly within this callback.
// Extract the impression-level ad revenue data.
NSDecimalNumber *value = adValue.value;
NSString *currencyCode = adValue.currencyCode;
GADAdValuePrecision precision = adValue.precision;
NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
(long)precision);
};
একটি কাস্টম ইভেন্ট বিজ্ঞাপন উৎসের নাম শনাক্ত করুন
কাস্টম ইভেন্ট অ্যাড সোর্সের ক্ষেত্রে, adSourceName প্রপার্টি আপনাকে Custom event অ্যাড সোর্স নামটি দেয়। আপনি যদি একাধিক কাস্টম ইভেন্ট ব্যবহার করেন, তবে একাধিক কাস্টম ইভেন্টের মধ্যে পার্থক্য করার জন্য অ্যাড সোর্স নামটি যথেষ্ট সুনির্দিষ্ট নয়। একটি নির্দিষ্ট কাস্টম ইভেন্ট খুঁজে বের করতে, নিম্নলিখিত ধাপগুলো অনুসরণ করুন:
-
adNetworkClassNameপ্রপার্টিটি পান। - বিজ্ঞাপনের উৎসের জন্য একটি অনন্য নাম সেট করুন।
নিম্নলিখিত উদাহরণটি একটি কাস্টম ইভেন্টের জন্য একটি অনন্য বিজ্ঞাপন উৎসের নাম নির্ধারণ করে:
সুইফট
func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
if adSourceName == "Custom Event" {
if loadedAdNetworkResponseInfo.adNetworkClassName
== "MediationExample.SampleCustomEventSwift"
{
adSourceName = "Sample Ad Network (Custom Event)"
}
}
return adSourceName
}উদ্দেশ্য-সি
- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
(GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
if ([adSourceName isEqualToString:@"Custom Event"]) {
if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
adSourceName = @"Sample Ad Network (Custom Event)";
}
}
return adSourceName;
}বিজয়ী বিজ্ঞাপন উৎস সম্পর্কে আরও তথ্যের জন্য, 'বিজ্ঞাপন প্রতিক্রিয়া সম্পর্কিত তথ্য পুনরুদ্ধার করুন' দেখুন।
বাস্তবায়নের সর্বোত্তম অনুশীলন
- অ্যাড অবজেক্ট তৈরি করার বা সেটির অ্যাক্সেস পাওয়ার সাথে সাথেই হ্যান্ডলারটি সেট করুন, এবং অবশ্যই বিজ্ঞাপনটি দেখানোর আগে। এর ফলে আপনি কোনো পেইড ইভেন্ট কলব্যাক মিস করবেন না।
-
paidEventHandlerমেথডটি কল করার সাথে সাথেই পেইড ইভেন্টের তথ্য আপনার পছন্দের অ্যানালিটিক্স সার্ভারে পাঠিয়ে দিন। এর ফলে আপনি ভুলবশত কোনো কলব্যাক বাদ দেবেন না এবং ডেটার অমিল এড়ানো যায়।
GADAdValue
GADAdValue হলো একটি ক্লাস যা একটি বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যকে উপস্থাপন করে, যার মধ্যে মূল্যটির মুদ্রা কোড এবং এর প্রিসিশন টাইপ নিম্নোক্তভাবে এনকোড করা থাকে।
| GADAdValuePrecision | বর্ণনা |
|---|---|
GADAdValuePrecisionUnknown | একটি অজানা বিজ্ঞাপনের মান। যখন LTV পিংব্যাক সক্রিয় থাকে কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না, তখন এটি ফেরত আসে। |
GADAdValuePrecisionEstimated | সংগৃহীত ডেটা থেকে আনুমানিক বিজ্ঞাপনের মূল্য। |
GADAdValuePrecisionPublisherProvided | একজন প্রকাশক একটি মিডিয়েশন গ্রুপে ম্যানুয়াল সিपीएम-এর মতো বিজ্ঞাপনের মান প্রদান করেছেন। |
GADAdValuePrecisionPrecise | এই বিজ্ঞাপনের জন্য প্রদত্ত সঠিক মূল্য। |
উন্মুক্ত নিলাম থেকে প্রাপ্ত পরীক্ষামূলক ধারণা
একটি টেস্ট রিকোয়েস্টের মাধ্যমে কোনো ওপেন বিডিং অ্যাড সোর্সের জন্য ইম্প্রেশন-লেভেল অ্যাড রেভিনিউ ইভেন্ট সংঘটিত হওয়ার পর, আপনি শুধুমাত্র নিম্নলিখিত ভ্যালুগুলো পাবেন:
-
GADAdValuePrecisionUnknown: নির্ভুলতার ধরণ নির্দেশ করে।
-
0: বিজ্ঞাপনের মান নির্দেশ করে।
পূর্বে, আপনি হয়তো প্রিসিশন টাইপটিকে GADAdValuePrecisionUnknown ব্যতীত অন্য কোনো মান এবং 0 এর বেশি একটি ad মান হিসেবে দেখে থাকতে পারেন।
টেস্ট বিজ্ঞাপনের অনুরোধ পাঠানোর বিস্তারিত তথ্যের জন্য, ‘টেস্ট ডিভাইস সক্ষম করুন’ দেখুন।