ইম্প্রেশন হলে, Google Mobile Ads SDK সেই ইম্প্রেশনের সাথে সম্পর্কিত বিজ্ঞাপন থেকে উপার্জনের ডেটা প্রদান করে। আপনি এই ডেটা ব্যবহার করে কোনও ব্যবহারকারীর লাইফটাইম ভ্যালু গণনা করতে পারেন অথবা ডেটা ডাউনস্ট্রিমে অন্য প্রাসঙ্গিক সিস্টেমে পাঠাতে পারেন।
আপনার iOS অ্যাপে LTV ডেটা ক্যাপচার করার সুবিধা প্রয়োগ করতে এই নির্দেশিকা আপনাকে সাহায্য করবে।
পূর্বশর্ত
- Ad Manager UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন ফিচার চালু করেছেন কিনা তা ভালভাবে দেখে নিন।
- Google Mobile Ads SDK 9.10.0 বা তার পরের যেকোনও ভার্সন ইমপোর্ট করুন।
- Google Mobile Ads SDK সেট-আপ করুন।
ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট প্রয়োগ করতে হবে:
পেড ইভেন্ট ম্যানেজ করা
প্রতিটি বিজ্ঞাপন ফর্ম্যাটের ডেলিগেট প্রোটোকলে একটি didRecordPaidEventWithAdValue:
মেথড অন্তর্ভুক্ত থাকে। বিজ্ঞাপনের লাইফসাইকেল চলাকালীন, Google Mobile Ads SDK ইম্প্রেশন ইভেন্ট মনিটর করে এবং
উপার্জিত GADAdValue অবজেক্টের সাথে এই ডেলিগেট পদ্ধতিকে
কল করে।
নিম্নলিখিত উদাহরণটি পুরস্কার প্রদানকারী বিজ্ঞাপনের জন্য পেড ইভেন্ট ম্যানেজ করে:
Swift
func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: 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.
let value = adValue.value
let currencyCode = adValue.currencyCode
let precision = adValue.precision
print(
"Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
)
}
Objective-C
- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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প্রপার্টি পান।- বিজ্ঞাপন সোর্সের একটি অনন্য নাম সেট করুন।
নিম্নলিখিত উদাহরণে কাস্টম ইভেন্টের জন্য একটি অনন্য বিজ্ঞাপন সোর্সের নাম সেট করা হয়েছে:
Swift
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
}Objective-C
- (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;
}জয়ী বিজ্ঞাপন সোর্স সম্পর্কে আরও তথ্যের জন্য, বিজ্ঞাপনের উত্তর সম্পর্কে তথ্য ফিরিয়ে আনুন দেখুন।
প্রয়োগ করার পেশাদার পদ্ধতি
- বিজ্ঞাপন অবজেক্ট তৈরি করার বা সেটির অ্যাক্সেস পাওয়ার সাথে সাথেই ডেলিগেট সেট করুন, এবং অবশ্যই বিজ্ঞাপন দেখানোর আগে। এটি নিশ্চিত করে যে আপনি কোনও পেড ইভেন্ট কলব্যাক মিস করবেন না।
didRecordPaidEventWithAdValue:ডেলিগেট পদ্ধতি কল করার সাথে সাথেই আপনার পছন্দের অ্যানালিটিক্স সার্ভারে পেড ইভেন্টের তথ্য পাঠান। এটি নিশ্চিত করে যে আপনি ভুলবশত কোনও কলব্যাক ড্রপ করবেন না এবং ডেটার অসঙ্গতি এড়িয়ে যাবেন।
GADAdValue
GADAdValue হল এমন একটি ক্লাস যা কোনও বিজ্ঞাপনের জন্য উপার্জিত আর্থিক মূল্যকে উপস্থাপন করে,
যার মধ্যে মূল্যের কারেন্সি কোড এবং এর নির্ভুলতার ধরন নিম্নলিখিতভাবে এনকোড করা থাকে।
| GADAdValuePrecision | বিবরণ |
|---|---|
GADAdValuePrecisionUnknown
|
বিজ্ঞাপনের ভ্যালু যা অজানা। LTV পিংব্যাক চালু করা থাকলে কিন্তু পর্যাপ্ত ডেটা উপলভ্য না থাকলে এটি রিটার্ন করা হয়। |
GADAdValuePrecisionEstimated
|
এগ্রিগেট করা ডেটা থেকে অনুমান করা বিজ্ঞাপনের ভ্যালু। |
GADAdValuePrecisionPublisherProvided
|
প্রকাশকের প্রদান করা বিজ্ঞাপনের ভ্যালু, যেমন মধ্যস্থতাকারী গ্রুপে ম্যানুয়াল CPM। |
GADAdValuePrecisionPrecise
|
এই বিজ্ঞাপনের জন্য পেমেন্ট করা সঠিক মূল্য। |
ওপেন বিডিং থেকে টেস্ট ইমপ্রেশন
টেস্ট অনুরোধের মাধ্যমে ওপেন বিডিং বিজ্ঞাপন সোর্সের জন্য ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন ইভেন্ট হওয়ার পরে, আপনি শুধুমাত্র নিম্নলিখিত ভ্যালু পাবেন:
GADAdValuePrecisionUnknown: প্রিসিশনের ধরন নির্দেশ করে।
0: বিজ্ঞাপনের ভ্যালু দেখায়।
GADAdValuePrecisionUnknown ছাড়া অন্য কোনও ভ্যালু এবং বিজ্ঞাপনের ভ্যালু 0-এর থেকে বেশি হিসেবে দেখেছেন।
টেস্ট বিজ্ঞাপনের অনুরোধ পাঠানোর ব্যাপারে বিস্তারিত জানতে, টেস্ট ডিভাইস চালু করুন বিকল্প দেখুন।