विज्ञापन पहले से लोड करना (बीटा वर्शन)

प्लैटफ़ॉर्म चुनें: Android iOS Unity Android (लेगसी)

विज्ञापन को पहले से लोड करने की सुविधा, Google Mobile Ads SDK में Google की मैनेज की जाने वाली विज्ञापन लोड करने की सुविधा है. यह आपकी ओर से विज्ञापन लोड करने और उन्हें कैश मेमोरी में सेव करने की प्रोसेस को मैनेज करती है. विज्ञापन को पहले से लोड करने की सुविधा का इस्तेमाल करने के लिए, आपको विज्ञापन लोड करने के तरीके में बदलाव करना होगा. विज्ञापन को पहले से लोड करने की सुविधा का इस्तेमाल करके परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए, कस्टम कैश मेमोरी में सेव करने की सुविधा बंद करें और इस काम की ज़िम्मेदारी Google Mobile Ads SDK को सौंपें.

विज्ञापन को पहले से लोड करने की सुविधा, मैन्युअल तरीके से विज्ञापन लोड करने की तुलना में ये फ़ायदे देती है:

  • रेफ़रंस मैनेजमेंट: लोड किए गए विज्ञापनों को सेव करके रखती है, ताकि आपको उन्हें दिखाने के लिए तैयार होने तक रेफ़रंस बनाए न रखने पड़ें.
  • अपने-आप रीलोड होना: कैश मेमोरी से कोई विज्ञापन हटाने पर, नया विज्ञापन अपने-आप लोड हो जाता है.
  • मैनेज किए गए फिर से कोशिश करने के अनुरोध: एक्स्पोनेंशियल बैकऑफ़ का इस्तेमाल करके, फ़ेल हुए अनुरोधों को अपने-आप फिर से भेजती है.
  • समयसीमा खत्म होने से पहले रीफ़्रेश करना: विज्ञापन की समयसीमा खत्म होने से पहले (आम तौर पर, एक घंटे बाद) उन्हें अपने-आप रीफ़्रेश करती है.
  • कैश मेमोरी को ऑप्टिमाइज़ करना: अगर कैश मेमोरी का साइज़ एक से ज़्यादा है, तो Google Mobile Ads SDK सबसे अच्छा विज्ञापन दिखाने के लिए कैश मेमोरी के क्रम को ऑप्टिमाइज़ करता है.

इस गाइड में, पहले से लोड किए जाने वाले विज्ञापनों को कॉन्फ़िगर करने, पहले से लोड किए जाने वाले विज्ञापनों की उपलब्धता की जांच करने, और पहले से लोड किए गए विज्ञापन दिखाने के बारे में बताया गया है.

ज़रूरी शर्तें

इस ट्यूटोरियल के साथ आगे बढ़ने से पहले, आपको सेट अप Google Mobile Ads SDK करना होगा.

विज्ञापनों को पहले से लोड करना

ऐप्लिकेशन शुरू होने पर, preload तरीके को एक बार कॉल करें. आप preload तरीके को कॉल करने के बाद, Google Mobile Ads SDK विज्ञापनों को अपने-आप पहले से लोड करता है. साथ ही, पहले से लोड किए गए कॉन्फ़िगरेशन के लिए, फ़ेल हुए अनुरोधों को फिर से भेजता है.

यहां दिए गए उदाहरण में, विज्ञापनों को पहले से लोड करने की प्रोसेस शुरू की गई है:

Swift

private func startPreloading(adUnitID: String) {
  // Start the preloading initialization process.
  let request = Request()
  let interstitialConfig = PreloadConfigurationV2(
    adUnitID: adUnitID, request: request)
  InterstitialAdPreloader.shared.preload(
    for: adUnitID, configuration: interstitialConfig, delegate: self)
}

Objective-C

- (void)startPreloadingWithAdUnitID:(nonnull NSString *)adUnitID {
  // Start the preloading initialization process.
  GADRequest *request = [GADRequest request];
  GADPreloadConfigurationV2 *interstitialConfig =
      [[GADPreloadConfigurationV2 alloc] initWithAdUnitID:adUnitID
                                                  request:request];

  [GADInterstitialAdPreloader.sharedInstance preloadForPreloadID:adUnitID
                                                   configuration:interstitialConfig
                                                        delegate:self];
}

पहले से लोड किए गए विज्ञापन को पाना और दिखाना

विज्ञापन को पहले से लोड करने की सुविधा का इस्तेमाल करने पर, Google Mobile Ads SDK कैश मेमोरी में सेव किए गए विज्ञापनों को सेव करके रखता है. जब आपको कोई विज्ञापन दिखाना हो, तो adWithPreloadID तरीके को कॉल करें. Google Mobile Ads SDK उपलब्ध विज्ञापन को वापस लाता है और बैकग्राउंड में अगले विज्ञापन को अपने-आप पहले से लोड करता है.

जब तक कोई विज्ञापन दिखाने के लिए तैयार न हों, तब तक adWithPreloadID तरीके को कॉल न करें. विज्ञापनों को कैश मेमोरी में सेव रखने से, Google Mobile Ads SDK समयसीमा खत्म हो चुके विज्ञापनों को अपने-आप रीफ़्रेश करता है और कैश मेमोरी को ऑप्टिमाइज़ करता है.

यहां दिए गए उदाहरण में, पहले से लोड किए गए विज्ञापन को वापस लाया गया है और दिखाया गया है:

Swift

private func showInterstitialAd(adUnitID: String) {
  // Verify that the preloaded ad is available before polling.
  guard isInterstitialAvailable(adUnitID: adUnitID) else {
    print("Preloaded interstitial ad is not available.")
    return
  }

  // Polling returns the next available ad and loads another ad in the background.
  let ad = InterstitialAdPreloader.shared.ad(with: adUnitID)

  // Interact with the ad object as needed.
  print("Interstitial ad response info: \(String(describing: ad?.responseInfo))")
  ad?.paidEventHandler = { (value: AdValue) in
    print("Interstitial ad paid event: \(value.value), \(value.currencyCode)")
  }

  ad?.fullScreenContentDelegate = self
  ad?.present(from: self)
}

Objective-C

- (void)showInterstitialAdWithAdUnitID:(nonnull NSString *)adUnitID {
  // Verify that the preloaded ad is available before polling.
  if (![self isInterstitialAvailableWithAdUnitID:adUnitID]) {
    NSLog(@"Preloaded interstitial ad is not available.");
    return;
  }

  // Getting the preloaded ad loads another ad in the background.
  GADInterstitialAd *ad =
      [GADInterstitialAdPreloader.sharedInstance adWithPreloadID:adUnitID];

  // Interact with the ad object as needed.
  NSLog(@"Interstitial ad response info: %@", ad.responseInfo);
  ad.paidEventHandler = ^(GADAdValue *_Nonnull value) {
    NSLog(@"Interstitial ad paid event: %@ %@ ", value.value, value.currencyCode);
  };
  ad.fullScreenContentDelegate = self;
  [ad presentFromRootViewController:self];
}

पहले से लोड किए गए विज्ञापन का मेटाडेटा पाना

पहले से लोड किए गए विज्ञापन का मेटाडेटा पाने के लिए, विज्ञापन के रिस्पॉन्स की जानकारी वाले ऑब्जेक्ट को देखा जा सकता है. इस प्रोसेस से, कैश मेमोरी से विज्ञापन को हटाए बिना उसका मेटाडेटा देखा जा सकता है.

यहां दिए गए उदाहरण में, रिस्पॉन्स की जानकारी वाले ऑब्जेक्ट से, पहले से लोड किए गए विज्ञापन का मेटाडेटा देखा गया है:

Swift

private func getInterstitialAdResponseInfo(preloadID: String) {
  // Get the response info for the preloaded ad.
  if let responseInfo = InterstitialAdPreloader.shared.responseInfo(
    with: preloadID)
  {
    print("Ad response ID: \(responseInfo.responseIdentifier ?? "")")
  }
}

Objective-C

- (void)getInterstitialAdResponseInfoWithPreloadID:(nonnull NSString *)preloadID {
  // Get the response info for the preloaded ad.
  GADResponseInfo *responseInfo =
      [GADInterstitialAdPreloader.sharedInstance
          adResponseInfoWithPreloadID:preloadID];
  if (responseInfo) {
    NSLog(@"Ad response ID: %@", responseInfo.responseIdentifier);
  }
}

पहले से लोड किए जाने वाले विज्ञापन की उपलब्धता की जांच करना

विज्ञापन की उपलब्धता की जांच करने के लिए, इनमें से कोई एक विकल्प चुनें:

पहले से लोड किए जाने वाले विज्ञापन की उपलब्धता की जानकारी पाना

यहां दिए गए उदाहरण में, विज्ञापन की उपलब्धता की जांच की गई है:

Swift

private func isInterstitialAvailable(adUnitID: String) -> Bool {
  // Verify that an ad is available before polling.
  return InterstitialAdPreloader.shared.isAdAvailable(with: adUnitID)
}

Objective-C

- (BOOL)isInterstitialAvailableWithAdUnitID:(nonnull NSString *)adUnitID {
  // Verify that an ad is available before polling.
  return [GADInterstitialAdPreloader.sharedInstance isAdAvailableWithPreloadID:adUnitID];
}

पहले से लोड किए जाने वाले विज्ञापन की उपलब्धता की जानकारी सुनना

पहले से लोड किए जाने वाले विज्ञापनों से जुड़े इवेंट के लिए रजिस्टर करें, ताकि आपको सूचना मिल सके कि विज्ञापन पहले से लोड हो गए हैं या नहीं. साथ ही, यह भी पता चल सके कि विज्ञापन लोड नहीं हो पाए हैं या विज्ञापन की कैश मेमोरी खत्म हो गई है.

पहले से लोड किए जाने वाले विज्ञापनों से जुड़े इवेंट, आंकड़ों के मकसद से होते हैं. पहले से लोड किए जाने वाले विज्ञापनों से जुड़े इवेंट के कॉलबैक में:

  • preload को कॉल न करें.
  • adWithPreloadID को तब तक कॉल न करें, जब तक विज्ञापन तुरंत न दिखाया जाए.

यहां दिए गए उदाहरण में, विज्ञापन से जुड़े इवेंट के लिए रजिस्टर किया गया है:

Swift

func adAvailable(forPreloadID preloadID: String, responseInfo: ResponseInfo) {
  // This callback indicates that an ad is available for the specified configuration.
  // No action is required here, but updating the UI can be useful in some cases.
  print("Ad preloaded successfully for ad preload ID: \(preloadID)")
}

func adsExhausted(forPreloadID preloadID: String) {
  // This callback indicates that all the ads for the specified configuration have been
  // consumed and no ads are available to show. No action is required here, but updating
  // the UI can be useful in some cases.
  // Don't call InterstitialAdPreloader.shared.preload or
  // InterstitialAdPreloader.shared.ad from adsExhausted.
  print("Ad exhausted for ad preload ID: \(preloadID)")
}

func adFailedToPreload(forPreloadID preloadID: String, error: Error) {
  print(
    "Ad failed to load with ad preload ID: \(preloadID), Error: \(error.localizedDescription)"
  )
}

Objective-C

- (void)adAvailableForPreloadID:(nonnull NSString *)preloadID
                   responseInfo:(nonnull GADResponseInfo *)responseInfo {
  // This callback indicates that an ad is available for the specified configuration.
  // No action is required here, but updating the UI can be useful in some cases.
  NSLog(@"Ad preloaded successfully for ad unit ID: %@", preloadID);
}

- (void)adsExhaustedForPreloadID:(nonnull NSString *)preloadID {
  // This callback indicates that all the ads for the specified configuration have been
  // consumed and no ads are available to show. No action is required here, but updating
  // the UI can be useful in some cases.
  // Don't call [GAD<Format>AdPreloader preloadForPreloadID:] or
  // [GAD<Format>AdPreloader adWithPreloadID:] from adsExhaustedForPreloadID.
  NSLog(@"Ad exhausted for ad preload ID: %@", preloadID);
}

- (void)adFailedToPreloadForPreloadID:(nonnull NSString *)preloadID
                                error:(nonnull NSError *)error {
  NSLog(@"Ad failed to load with ad preload ID: %@, Error: %@", preloadID,
        error.localizedDescription);
}

विज्ञापनों को पहले से लोड करने की प्रोसेस बंद करना

अगर आपको सेशन में, पहले से लोड किए गए किसी आईडी के लिए विज्ञापन फिर से नहीं दिखाने हैं, तो विज्ञापनों को पहले से लोड करने की प्रोसेस बंद की जा सकती है. पहले से लोड किए गए किसी खास आईडी के लिए, विज्ञापनों को पहले से लोड करने की प्रोसेस बंद करने के लिए, पहले से लोड किए गए आईडी के साथ stopPreloadingAndRemoveAdsForPreloadID को कॉल करें. पहले से लोड किए जाने वाले सभी विज्ञापनों के लिए, विज्ञापनों को पहले से लोड करने की प्रोसेस बंद करने के लिए, stopPreloadingAndRemoveAllAds को कॉल करें.

बफ़र का साइज़ सेट करना

बफ़र का साइज़, मेमोरी में पहले से लोड किए गए विज्ञापनों की संख्या को कंट्रोल करता है. डिफ़ॉल्ट रूप से, Google, मेमोरी की खपत और विज्ञापन दिखाने में लगने वाले समय के बीच बैलेंस बनाए रखने के लिए, बफ़र के साइज़ को ऑप्टिमाइज़ करता है. अगर आपका ऐप्लिकेशन, अगला विज्ञापन लोड होने से पहले विज्ञापन दिखाता है, तो मेमोरी में सेव किए गए विज्ञापनों की संख्या बढ़ाने के लिए, कस्टम बफ़र साइज़ सेट किया जा सकता है.

Swift

let preloadConfig = PreloadConfigurationV2(adUnitID: "ca-app-pub-3940256099942544/1712485313")
preloadConfig.bufferSize = 3

Objective-C

GADPreloadConfigurationV2 *preloadConfig =
    [[GADPreloadConfigurationV2 alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"];
preloadConfig.bufferSize = 3;

पहले से लोड किए जाने वाले विज्ञापनों की कैश मेमोरी की सीमाएं

Google Mobile Ads SDK ऐप्लिकेशन के लिए, पहले से लोड किए गए विज्ञापनों की कुल संख्या पर सीमा लागू करता है यह सीमा, सभी विज्ञापन यूनिट और पहले से लोड किए गए आईडी पर लागू होती है:

  • डिफ़ॉल्ट सीमा: Google Mobile Ads SDK मेमोरी में ज़्यादा से ज़्यादा छह विज्ञापन पहले से लोड करके रखता है. यह सीमा, सभी फ़ॉर्मैट और पहले से लोड किए गए आईडी पर लागू होती है.
  • हमारा सुझाव है कि पहले से लोड किए गए हर आईडी के लिए, बफ़र साइज़ दो या तीन रखें.