इनाम वाले विज्ञापन ऐसे विज्ञापन होते हैं जिनसे उपयोगकर्ता ऐप्लिकेशन में मिलने वाले इनाम के बदले इंटरैक्ट कर सकते हैं. इस गाइड में, AdMob के इनाम वाले विज्ञापनों को iOS ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है. ग्राहक की सफलता की कुछ कहानियां पढ़ें: केस स्टडी 1, केस स्टडी 2.
ज़रूरी शर्तें
- शुरुआती निर्देश पढ़ें.
हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करें
अपने ऐप्लिकेशन बनाते और उनकी टेस्टिंग करते समय, पक्का करें कि आपने लाइव और प्रोडक्शन विज्ञापनों के बजाय, टेस्ट विज्ञापनों का इस्तेमाल किया हो. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.
टेस्ट विज्ञापनों को लोड करने का सबसे आसान तरीका यह है कि आप iOS के लिए, इनाम वाले विज्ञापनों की हमारी टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करें:
ca-app-pub-3940256099942544/1712485313
इसे खास तौर पर हर अनुरोध के लिए टेस्ट विज्ञापन दिखाने के लिए कॉन्फ़िगर किया गया है. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, अपने ऐप्लिकेशन में इसका इस्तेमाल किया जा सकता है. हालांकि, ऐप्लिकेशन पब्लिश करने से पहले, इसे अपनी विज्ञापन यूनिट के आईडी से बदलना न भूलें.
Mobile Ads SDK के टेस्ट विज्ञापन कैसे काम करते हैं, इस बारे में ज़्यादा जानने के लिए टेस्ट विज्ञापन देखें.
लागू करना
इनाम वाले विज्ञापन इंटिग्रेट करने के लिए, यह तरीका अपनाएं:
- विज्ञापन लोड करना
- [ज़रूरी नहीं] एसएसवी कॉलबैक की पुष्टि करना
- कॉलबैक के लिए रजिस्टर करना
- विज्ञापन दिखाना और इनाम वाले इवेंट को मैनेज करना
विज्ञापन लोड करना
विज्ञापन को लोड करने के लिए, GADRewardedAd
क्लास में load(adUnitID:request)
तरीके का इस्तेमाल किया जाता है.
Swift
func loadRewardedAd() async {
do {
rewardedAd = try await RewardedAd.load(
// Replace this ad unit ID with your own ad unit ID.
with: "ca-app-pub-3940256099942544/1712485313", request: Request())
rewardedAd?.fullScreenContentDelegate = self
} catch {
print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}
}
SwiftUI
import GoogleMobileAds
class RewardedViewModel: NSObject, ObservableObject, FullScreenContentDelegate {
@Published var coins = 0
private var rewardedAd: RewardedAd?
func loadAd() async {
do {
rewardedAd = try await RewardedAd.load(
with: "ca-app-pub-3940256099942544/1712485313", request: Request())
rewardedAd?.fullScreenContentDelegate = self
} catch {
print("Failed to load rewarded ad with error: \(error.localizedDescription)")
}
}
Objective-C
// Replace this ad unit ID with your own ad unit ID.
[GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
request:[GADRequest request]
completionHandler:^(GADRewardedAd *ad, NSError *error) {
if (error) {
NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
return;
}
self.rewardedAd = ad;
self.rewardedAd.fullScreenContentDelegate = self;
}];
[ज़रूरी नहीं] सर्वर साइड से की जाने वाली पुष्टि (एसएसवी) के कॉलबैक की पुष्टि करना
जिन ऐप्लिकेशन को सर्वर-साइड
वेरिफ़िकेशन कॉलबैक में अतिरिक्त डेटा की ज़रूरत होती है उन्हें इनाम वाले विज्ञापनों की कस्टम डेटा सुविधा का इस्तेमाल करना चाहिए. इनाम वाले विज्ञापन ऑब्जेक्ट पर सेट की गई कोई भी स्ट्रिंग वैल्यू, एसएसवी कॉलबैक के custom_data
क्वेरी पैरामीटर को पास की जाती है. अगर कोई कस्टम डेटा वैल्यू सेट नहीं की जाती है, तो एसएसवी कॉलबैक में custom_data
क्वेरी पैरामीटर वैल्यू मौजूद नहीं होगी.
यहां दिए गए कोड सैंपल में, विज्ञापन का अनुरोध करने से पहले इनाम वाले विज्ञापन ऑब्जेक्ट पर कस्टम डेटा सेट करने का तरीका बताया गया है:
Swift
do {
rewardedAd = try await RewardedAd.load(
// Replace this ad unit ID with your own ad unit ID.
with: "ca-app-pub-3940256099942544/1712485313", request: Request())
let options = ServerSideVerificationOptions()
options.customRewardText = "SAMPLE_CUSTOM_DATA_STRING"
rewardedAd?.serverSideVerificationOptions = options
} catch {
print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}
Objective-C
// Replace this ad unit ID with your own ad unit ID.
[GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
request:[GADRequest request]
completionHandler:^(GADRewardedAd *ad, NSError *error) {
if (error) {
NSLog(@"Rewarded ad failed to load with error: %@", error.localizedDescription);
return;
}
self.rewardedAd = ad;
GADServerSideVerificationOptions *options =
[[GADServerSideVerificationOptions alloc] init];
options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
ad.serverSideVerificationOptions = options;
}];
कॉलबैक के लिए रजिस्टर करना
प्रेज़ेंटेशन इवेंट की सूचनाएं पाने के लिए, आपको दिखाए गए विज्ञापन की GADFullScreenContentDelegate to the
fullScreenContentDelegate` प्रॉपर्टी असाइन करनी होगी:
Swift
rewardedAd?.fullScreenContentDelegate = self
SwiftUI
rewardedAd?.fullScreenContentDelegate = self
Objective-C
self.rewardedAd.fullScreenContentDelegate = self;
GADFullScreenContentDelegate
प्रोटोकॉल, विज्ञापन के दिखने या न दिखने और उसे खारिज किए जाने के बारे में कॉलबैक को मैनेज करता है. नीचे दिए गए कोड में, प्रोटोकॉल लागू करने का तरीका बताया गया है:
Swift
func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
print("\(#function) called.")
}
func adDidRecordClick(_ ad: FullScreenPresentingAd) {
print("\(#function) called.")
}
func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called.")
}
func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called.")
}
func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called.")
// Clear the rewarded ad.
rewardedAd = nil
}
func ad(
_ ad: FullScreenPresentingAd,
didFailToPresentFullScreenContentWithError error: Error
) {
print("\(#function) called with error: \(error.localizedDescription).")
}
SwiftUI
func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
print("\(#function) called")
}
func adDidRecordClick(_ ad: FullScreenPresentingAd) {
print("\(#function) called")
}
func ad(
_ ad: FullScreenPresentingAd,
didFailToPresentFullScreenContentWithError error: Error
) {
print("\(#function) called")
}
func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called")
}
func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called")
}
func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
print("\(#function) called")
// Clear the rewarded ad.
rewardedAd = nil
}
Objective-C
- (void)adDidRecordImpression:(id<GADFullScreenPresentingAd>)ad {
NSLog(@"%s called", __PRETTY_FUNCTION__);
}
- (void)adDidRecordClick:(id<GADFullScreenPresentingAd>)ad {
NSLog(@"%s called", __PRETTY_FUNCTION__);
}
- (void)adWillPresentFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
NSLog(@"%s called", __PRETTY_FUNCTION__);
}
- (void)adWillDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
NSLog(@"%s called", __PRETTY_FUNCTION__);
}
- (void)adDidDismissFullScreenContent:(id<GADFullScreenPresentingAd>)ad {
NSLog(@"%s called", __PRETTY_FUNCTION__);
// Clear the rewarded ad.
self.rewardedAd = nil;
}
- (void)ad:(id)ad didFailToPresentFullScreenContentWithError:(NSError *)error {
NSLog(@"%s called with error: %@", __PRETTY_FUNCTION__, error.localizedDescription);
}
विज्ञापन दिखाना और इनाम वाले इवेंट को मैनेज करना
उपयोगकर्ताओं को इनाम वाला विज्ञापन दिखाने से पहले, आपको उन्हें यह साफ़ तौर पर बताना होगा कि इनाम पाने के लिए, उन्हें इनाम वाले विज्ञापन का कॉन्टेंट देखना होगा. इनाम वाले विज्ञापन हमेशा ऑप्ट-इन करने की सुविधा के साथ उपलब्ध होने चाहिए.
विज्ञापन दिखाते समय, आपको GADUserDidEarnRewardHandler
ऑब्जेक्ट देना होगा, ताकि उपयोगकर्ता को इनाम दिया जा सके.
नीचे दिए गए कोड में, इनाम वाले विज्ञापन को दिखाने का सबसे सही तरीका बताया गया है:
Swift
rewardedAd.present(from: self) {
let reward = rewardedAd.adReward
print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
// TODO: Reward the user.
}
SwiftUI
विज्ञापन कब दिखाना है, यह तय करने के लिए व्यू में यूज़र इंटरफ़ेस (यूआई) इवेंट सुनें.
var body: some View {
VStack(spacing: 20) {
Button("Watch video for additional 10 coins") {
viewModel.showAd()
showWatchVideoButton = false
}
व्यू मॉडल से इनाम वाला विज्ञापन दिखाएं:
func showAd() {
guard let rewardedAd = rewardedAd else {
return print("Ad wasn't ready.")
}
rewardedAd.present(from: nil) {
let reward = rewardedAd.adReward
print("Reward amount: \(reward.amount)")
self.addCoins(reward.amount.intValue)
}
}
Objective-C
[self.rewardedAd presentFromRootViewController:self
userDidEarnRewardHandler:^{
GADAdReward *reward = self.rewardedAd.adReward;
NSString *rewardMessage = [NSString
stringWithFormat:@"Reward received with currency %@ , amount %lf",
reward.type, [reward.amount doubleValue]];
NSLog(@"%@", rewardMessage);
// TODO: Reward the user.
}];
अक्सर पूछे जाने वाले सवाल
- क्या मुझे
GADRewardedAd
के लिए इनाम की जानकारी मिल सकती है? - हां, अगर आपको
userDidEarnReward
कॉलबैक ट्रिगर होने से पहले इनाम की रकम की ज़रूरत है, तोGADRewardedAd
के पास एकadReward
प्रॉपर्टी है. विज्ञापन लोड होने के बाद, इनाम की रकम की पुष्टि करने के लिए इस प्रॉपर्टी का इस्तेमाल किया जा सकता है. - क्या शुरुआती कॉल के लिए कोई टाइमआउट होता है?
- दस सेकंड के बाद, Google Mobile Ads SDK,
GADInitializationCompletionHandler
को कॉल करता है. यहstartWithCompletionHandler:
को दिया जाता है. ऐसा तब भी होता है, जब कोई मीडिएशन नेटवर्क अब भी शुरू नहीं हुआ हो. - अगर मुझे इनिशियलाइज़ेशन कॉलबैक मिलता है, लेकिन कुछ मीडिएशन नेटवर्क तैयार नहीं हैं, तो क्या होगा?
हमारा सुझाव है कि
GADInitializationCompletionHandler
के अंदर कोई विज्ञापन लोड करें. अगर कोई मीडिएशन नेटवर्क विज्ञापन दिखाने के लिए तैयार नहीं है, तब भी Google Mobile Ads SDK उस नेटवर्क से विज्ञापन दिखाने के लिए अनुरोध करता है. इसलिए, अगर कोई मीडिएशन नेटवर्क टाइम आउट के बाद शुरू होता है, तो वह उस सेशन में विज्ञापन के आने वाले अनुरोधों को अब भी पूरा कर सकता है.GADMobileAds.initializationStatus
को कॉल करके, अपने ऐप्लिकेशन सेशन के दौरान सभी अडैप्टर की शुरू होने की स्थिति को पोल किया जा सकता है.- मैं यह कैसे पता लगाऊं कि कोई मीडिएशन नेटवर्क तैयार क्यों नहीं है?
description
ऑब्जेक्ट कीdescription
प्रॉपर्टी से पता चलता है कि कोई अडैप्टर, विज्ञापन अनुरोधों को पूरा करने के लिए तैयार क्यों नहीं है.GADAdapterStatus
- क्या
userDidEarnRewardHandler
कंप्लीशन हैंडलर को हमेशाadDidDismissFullScreenContent:
डेलिगेट मेथड से पहले कॉल किया जाता है? Google विज्ञापनों के लिए, सभी
userDidEarnRewardHandler
कॉल,adDidDismissFullScreenContent:
से पहले होते हैं. मीडिएशन के ज़रिए दिखाए जाने वाले विज्ञापनों के लिए, तीसरे पक्ष की विज्ञापन नेटवर्क कंपनी के SDK टूल को लागू करने से, कॉलबैक का क्रम तय होता है. विज्ञापन नेटवर्क के ऐसे एसडीके के लिए जो इनाम की जानकारी के साथ एक ही डेलिगेट तरीका उपलब्ध कराते हैं, मीडिएशन अडैप्टरuserDidEarnRewardHandler
कोadDidDismissFullScreenContent:
से पहले लागू करता है.
GitHub पर मौजूद उदाहरण
इनाम वाले विज्ञापनों के सभी उदाहरण, अपनी पसंद की भाषा में देखें:
अगले चरण
उपयोगकर्ता की निजता के बारे में ज़्यादा जानें.