इनाम वाला इंटरस्टीशियल विज्ञापन, नए तरह से तैयार किया गया विज्ञापन फ़ॉर्मैट है. इसकी मदद से, ऐप्लिकेशन में स्वाभाविक तौर पर हुए ट्रांज़िशन के दौरान दिखने वाले विज्ञापनों के लिए, इनाम दिए जा सकते हैं. उपयोगकर्ताओं को इनाम वाला इंटरस्टीशियल विज्ञापन देखने के लिए, ऑप्ट-इन करना ज़रूरी नहीं होता. इनाम वाले विज्ञापनों के लिए ऐसा करना ज़रूरी है.
ज़रूरी शर्तें
आगे बढ़ने से पहले, सेट अप करें Google Mobile Ads SDK.
लागू करना
इनाम वाले इंटरस्टीशियल विज्ञापनों को इंटिग्रेट करने के लिए, यह तरीका अपनाएं:
- विज्ञापन लोड करना
- [ज़रूरी नहीं] एसएसवी कॉलबैक की पुष्टि करना
- कॉलबैक के लिए रजिस्टर करना
- विज्ञापन दिखाना और इनाम वाले इवेंट को मैनेज करना
विज्ञापन लोड करना
विज्ञापन लोड करने के लिए, load(adUnitID:request)
तरीके का इस्तेमाल GADRewardedInterstitialAd क्लास पर किया जाता है.
Swift
SwiftUI
import GoogleMobileAds
class RewardedInterstitialViewModel: NSObject, ObservableObject,
FullScreenContentDelegate
{
@Published var coins = 0
private var rewardedInterstitialAd: RewardedInterstitialAd?
func loadAd() async {
do {
rewardedInterstitialAd = try await RewardedInterstitialAd.load(
with: "ca-app-pub-3940256099942544/6978759866", request: Request())
rewardedInterstitialAd?.fullScreenContentDelegate = self
} catch {
print(
"Failed to load rewarded interstitial ad with error: \(error.localizedDescription)")
}
}
Objective-C
adUnitID की जगह, अपनी विज्ञापन यूनिट का आईडी डालें.
[ज़रूरी नहीं] सर्वर-साइड पर की गई पुष्टि (एसएसवी) वाले कॉलबैक की पुष्टि करना
जिन ऐप्लिकेशन को सर्वर-साइड
पर की गई पुष्टि वाले कॉलबैक में ज़्यादा डेटा की ज़रूरत होती है उन्हें
इनाम वाले विज्ञापनों की पसंद के मुताबिक डेटा वाली सुविधा का इस्तेमाल करना चाहिए. इनाम वाले विज्ञापन के ऑब्जेक्ट पर सेट की गई कोई भी स्ट्रिंग वैल्यू, एसएसवी कॉलबैक के custom_data क्वेरी पैरामीटर को पास की जाती है. अगर पसंद के मुताबिक डेटा की कोई वैल्यू सेट नहीं की जाती है, तो एसएसवी कॉलबैक में custom_data क्वेरी पैरामीटर की वैल्यू मौजूद नहीं होगी.
नीचे दिए गए कोड सैंपल में, विज्ञापन का अनुरोध करने से पहले, इनाम वाले इंटरस्टीशियल विज्ञापन के ऑब्जेक्ट पर पसंद के मुताबिक डेटा सेट करने का तरीका बताया गया है.
Swift
Objective-C
SAMPLE_CUSTOM_DATA_STRING की जगह, अपना पसंद के मुताबिक डेटा डालें.
कॉलबैक के लिए रजिस्टर करना
प्रज़ेंटेशन इवेंट की सूचनाएं पाने के लिए, आपको दिखाए गए विज्ञापन की fullScreenContentDelegate प्रॉपर्टी को GADFullScreenContentDelegate असाइन करना होगा:
Swift
rewardedInterstitialAd?.fullScreenContentDelegate = self
SwiftUI
rewardedInterstitialAd?.fullScreenContentDelegate = self
Objective-C
self.rewardedInterstitialAd.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 interstitial ad.
rewardedInterstitialAd = 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 interstitial ad.
rewardedInterstitialAd = 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 interstitial ad.
self.rewardedInterstitialAd = nil;
}
- (void)ad:(id)ad didFailToPresentFullScreenContentWithError:(NSError *)error {
NSLog(@"%s called with error: %@", __PRETTY_FUNCTION__, error.localizedDescription);
}
विज्ञापन दिखाना और इनाम वाले इवेंट को मैनेज करना
विज्ञापन दिखाते समय, आपको उपयोगकर्ता के लिए इनाम को मैनेज करने के लिए, GADUserDidEarnRewardHandler ऑब्जेक्ट देना होगा.
नीचे दिए गए कोड में, इनाम वाला इंटरस्टीशियल विज्ञापन दिखाने का सबसे अच्छा तरीका बताया गया है.
Swift
func showRewardedInterstitialAd() {
guard let rewardedInterstitialAd = rewardedInterstitialAd else {
return print("Ad wasn't ready.")
}
// The UIViewController parameter is an optional.
rewardedInterstitialAd.present(from: nil) {
let reward = rewardedInterstitialAd.adReward
print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
// TODO: Reward the user.
}
}
SwiftUI
विज्ञापन दिखाने के लिए, व्यू में यूज़र इंटरफ़ेस (यूआई) इवेंट सुनें.
var rewardedInterstitialBody: some View {
// ...
}
.onChange(
of: showAd,
perform: { newValue in
if newValue {
viewModel.showAd()
}
}
)
व्यू मॉडल से इनाम वाला इंटरस्टीशियल विज्ञापन दिखाएं:
func showAd() {
guard let rewardedInterstitialAd = rewardedInterstitialAd else {
return print("Ad wasn't ready.")
}
rewardedInterstitialAd.present(from: nil) {
let reward = rewardedInterstitialAd.adReward
print("Reward amount: \(reward.amount)")
self.addCoins(reward.amount.intValue)
}
}
Objective-C
- (void)showRewardedInterstitialAd {
[self.rewardedInterstitialAd presentFromRootViewController:self
userDidEarnRewardHandler:^{
GADAdReward *reward = self.rewardedInterstitialAd.adReward;
NSString *rewardMessage = [NSString
stringWithFormat:@"Reward received with "
@"currency %@ , amount %ld",
reward.type, [reward.amount longValue]];
NSLog(@"%@", rewardMessage);
// TODO: Reward the user.
}];
}
GitHub पर मौजूद उदाहरण
अपनी पसंद की भाषा में, इनाम वाले इंटरस्टीशियल विज्ञापनों के पूरे उदाहरण देखें:
अगले चरण
उपयोगकर्ता की निजता के बारे में ज़्यादा जानें.