যখন একটি ইমপ্রেশন ঘটে, তখন Google মোবাইল বিজ্ঞাপন SDK অর্থপ্রদানকারী ইভেন্ট হ্যান্ডলারকে তার সম্পর্কিত আয়ের ডেটা সহ কল করে। এই হ্যান্ডলারটি প্রয়োগ করে, আপনি ব্যবহারকারীর জীবনকালের মূল্য গণনা করতে ডেটা ব্যবহার করতে পারেন, বা অন্যান্য প্রাসঙ্গিক সিস্টেমে ডাটা ডাউনস্ট্রিম ফরোয়ার্ড করতে পারেন।
এই নির্দেশিকাটি আপনার iOS অ্যাপে LTV ডেটা ক্যাপচার বাস্তবায়নে সাহায্য করার উদ্দেশ্যে তৈরি করা হয়েছে।
পূর্বশর্ত
- নিশ্চিত করুন যে আপনি AdMob UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন আয় বৈশিষ্ট্যটি চালু করেছেন ।
- Google মোবাইল বিজ্ঞাপন SDK 9.10.0 বা উচ্চতর আমদানি করুন৷
- শুরু করুন গাইডটি সম্পূর্ণ করুন।
আপনি যেকোন ইম্প্রেশন-লেভেল বিজ্ঞাপনের আয় পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট বাস্তবায়ন করতে হবে:
একটি প্রদত্ত ইভেন্ট হ্যান্ডলার প্রয়োগ করুন
প্রতিটি বিজ্ঞাপন ফর্ম্যাটে GADPaidEventHandler
টাইপের একটি paidEventHandler
প্রপার্টি রয়েছে। একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google মোবাইল বিজ্ঞাপন SDK ইম্প্রেশন ইভেন্টগুলি নিরীক্ষণ করে এবং একটি অর্জিত মূল্য সহ হ্যান্ডলারকে আহ্বান করে৷
সুইফট
class ViewController: UIViewController, GADFullScreenContentDelegate {
var rewardedAd: GADRewardedAd?
func requestRewardedAd() {
GADRewardedAd.load(
withAdUnitID: "AD_UNIT_ID", request: GADRequest()
) { (ad, error) in
if let error = error {
print("Rewarded ad failed to load with error: \(error.localizedDescription)")
return
}
if let ad = ad {
self.rewardedAd = ad
self.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 precision = adValue.precision
let currencyCode = adValue.currencyCode
// Get the ad unit ID.
let adUnitId = ad.adUnitID
let responseInfo = ad.responseInfo
let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
}
}
}
}
}
উদ্দেশ্য-C
@import GoogleMobileAds;
@import UIKit;
@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end
@implementation ViewController
- (void)requestRewardedAd {
__weak ViewController *weakSelf = self;
GADRequest *request = [GADRequest request];
[GADRewardedAd
loadWithAdUnitID:@"AD_UNIT_ID"
request:request
completionHandler:^(GADRewardedAd *ad, NSError *error) {
if (error) {
NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
return;
}
self.rewardedAd = ad;
self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
ViewController *strongSelf = weakSelf;
// 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; = value.value;
NSString *currencyCode = value.currencyCode;
GADAdValuePrecision precision = value.precision;
// Get the ad unit ID.
NSString *adUnitId = strongSelf.rewardedAd.adUnitID;
GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
NSString *mediationGroupName = extras["mediation_group_name"];
NSString *mediationABTestName = extras["mediation_ab_test_name"];
NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
};
]};
}
বিজয়ী বিজ্ঞাপন উত্স সম্পর্কে আরও তথ্যের জন্য, বিজ্ঞাপন প্রতিক্রিয়া সম্পর্কে তথ্য পুনরুদ্ধার দেখুন।
অ্যাপ অ্যাট্রিবিউশন পার্টনারদের (AAP) সাথে একীভূত করুন
অ্যানালিটিক্স প্ল্যাটফর্মে বিজ্ঞাপনের আয়ের ডেটা ফরওয়ার্ড করার সম্পূর্ণ বিবরণের জন্য, অংশীদারের নির্দেশিকা পড়ুন:
অংশীদার SDK |
---|
সামঞ্জস্য করুন |
অ্যাপসফ্লায়ার |
একবচন |
তেনজিন |
বাস্তবায়নের সর্বোত্তম অনুশীলন
- আপনি বিজ্ঞাপন অবজেক্ট তৈরি বা অ্যাক্সেস পেতে অবিলম্বে হ্যান্ডলার সেট করুন, এবং অবশ্যই বিজ্ঞাপন দেখানোর আগে। এটি নিশ্চিত করে যে আপনি কোনো প্রদত্ত ইভেন্ট কলব্যাক মিস করবেন না।
-
paidEventHandler
পদ্ধতিতে কল করার সাথে সাথেই আপনার পছন্দের অ্যানালিটিক্স সার্ভারে অর্থপ্রদানের ইভেন্টের তথ্য পাঠান। এটি নিশ্চিত করে যে আপনি ভুলবশত কোনো কলব্যাক ড্রপ করবেন না এবং ডেটার অসঙ্গতি এড়ান।
GADAdValue
GADAdValue
হল এমন একটি শ্রেণী যা একটি বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যকে প্রতিনিধিত্ব করে, যার মধ্যে মানের মুদ্রা কোড এবং নিচের মত এনকোড করা এর নির্ভুলতা প্রকার।
GADAdValuePrecision | বর্ণনা |
---|---|
GADAdValuePrecisionUnknown | একটি বিজ্ঞাপন মান যা অজানা। এলটিভি পিংব্যাক সক্ষম হলে এটি ফেরত দেওয়া হয় কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না। |
GADAdValuePrecisionEstimated | সমষ্টিগত ডেটা থেকে আনুমানিক একটি বিজ্ঞাপন মান। |
GADAdValuePrecisionPublisherProvided | একজন প্রকাশক বিজ্ঞাপনের মান প্রদান করেছেন, যেমন একটি মধ্যস্থতা গোষ্ঠীতে ম্যানুয়াল CPM। |
GADAdValuePrecisionPrecise | এই বিজ্ঞাপনের জন্য প্রদত্ত সুনির্দিষ্ট মান। |
বিডিং বিজ্ঞাপন উত্স থেকে ইম্প্রেশন পরীক্ষা করুন
একটি পরীক্ষার অনুরোধের মাধ্যমে একটি বিডিং বিজ্ঞাপন উত্সের জন্য একটি ইম্প্রেশন-স্তরের বিজ্ঞাপন আয় ইভেন্ট হওয়ার পরে, আপনি শুধুমাত্র নিম্নলিখিত মানগুলি পাবেন:
-
GADAdValuePrecisionUnknown
: নির্ভুলতা প্রকার নির্দেশ করে।
-
0
: বিজ্ঞাপনের মান নির্দেশ করে।
পূর্বে, আপনি GADAdValuePrecisionUnknown
ব্যতীত অন্য একটি মান এবং 0
এর বেশি বিজ্ঞাপনের মান হিসাবে নির্ভুলতার ধরন দেখে থাকতে পারেন।
পরীক্ষার বিজ্ঞাপনের অনুরোধ পাঠানোর বিষয়ে বিস্তারিত জানার জন্য, পরীক্ষা ডিভাইস সক্ষম করুন দেখুন।