नेटिव विज्ञापन

नेटिव विज्ञापन ऐसे विज्ञापन एसेट होते हैं जो उपयोगकर्ताओं को यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के ज़रिए पेश किए जाते हैं. ये कॉम्पोनेंट प्लैटफ़ॉर्म पर उपलब्ध होते हैं. ये उन्हीं क्लास का इस्तेमाल करके दिखाए जाते हैं जिनका इस्तेमाल आप पहले से ही अपने स्टोरीबोर्ड में कर रहे हैं. इन्हें आपके ऐप्लिकेशन के विज़ुअल डिज़ाइन के हिसाब से फ़ॉर्मैट किया जा सकता है.

जब कोई नेटिव विज्ञापन लोड होता है, तो आपके ऐप्लिकेशन को ऐसे विज्ञापन ऑब्जेक्ट मिलते हैं जिसमें उसके एसेट होते हैं. साथ ही, ऐप्लिकेशन की ज़िम्मेदारी होती है कि वह Google Mobile Ads SDK टूल की जगह विज्ञापन दिखाए.

मोटे तौर पर, नेटिव विज्ञापनों को सही तरीके से लागू करने के दो हिस्से होते हैं: SDK टूल का इस्तेमाल करके विज्ञापन लोड करना और फिर अपने ऐप्लिकेशन में विज्ञापन का कॉन्टेंट दिखाना.

इस पेज पर नेटिव विज्ञापन को लोड करने के लिए, SDK टूल इस्तेमाल करने का तरीका बताया गया है.

सलाह: हमारी नेटिव विज्ञापन प्लेबुक में नेटिव विज्ञापनों के बारे में ज़्यादा जानें. ये सैंपल, Swift और Objective-C के लिए उपलब्ध हैं. ग्राहक की सफलता की कुछ कहानियां भी देखें: केस स्टडी 1, केस स्टडी 2.

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

• शुरू करने के लिए गाइड को पूरा करें.

हमेशा टेस्ट विज्ञापनों से टेस्ट करें

अपने ऐप्लिकेशन बनाते और टेस्ट करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें.

टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका यह है कि आप iOS पर नेटिव विज्ञापनों के लिए, हमारे खास टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करें:

ca-app-pub-3940256099942544/3986624511

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

Google Mobile Ads SDK के टेस्ट विज्ञापनों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, विज्ञापनों की जांच करें देखें.

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

नेटिव विज्ञापन, GADAdLoader क्लास से लोड होते हैं, जो उनके प्रतिनिधियों को GADAdLoaderDelegate प्रोटोकॉल के मुताबिक मैसेज भेजते हैं.

विज्ञापन लोड करने की प्रोसेस शुरू करना

विज्ञापन लोड करने से पहले, आपको विज्ञापन लोड करने की प्रक्रिया शुरू करनी होगी. इस कोड से पता चलता है कि GADAdLoader को शुरू कैसे किया जाता है:

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

आपको विज्ञापन यूनिट आईडी (टेस्ट आईडी का इस्तेमाल किया जा सकता है) की ज़रूरत होगी. साथ ही, adTypes कलेक्शन में पास करने के लिए कॉन्सटेंट की ज़रूरत होगी, ताकि यह बताया जा सके कि आपको कौनसे नेटिव फ़ॉर्मैट का अनुरोध करना है, और options पैरामीटर में सेट किए जाने वाले विकल्प क्या हैं. options पैरामीटर के लिए संभावित वैल्यू की सूची, नेटिव विज्ञापन के विकल्प सेट करने के विकल्प पेज पर देखें.

adTypes कलेक्शन में यह कॉन्सटेंट :

• GADAdLoaderAdTypeNative

विज्ञापन लोड करने का ऐक्सेस किसी और को देना

विज्ञापन लोड करने वाले जिस व्यक्ति को आपने विज्ञापन लोड करने का ऐक्सेस दिया है उसे आपके विज्ञापन टाइप के लिए खास प्रोटोकॉल लागू करने होंगे. नेटिव विज्ञापनों के लिए, GADNativeAdLoaderDelegate प्रोटोकॉल में एक मैसेज शामिल होता है, जो नेटिव विज्ञापन लोड होने पर, प्रतिनिधि को भेजा जाता है.

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

विज्ञापन जोड़ने का अनुरोध करें

सलाह: विज्ञापन लोड करने के लिए कॉल करने की सुविधा का इस्तेमाल करके, पहले से लोड किए गए विज्ञापनों की कैश मेमोरी तैयार कर ली जा सकती है. ऐसा करने से, विज्ञापनों को बिना किसी देरी के दिखाया जा सकता है. विज्ञापनों की समयसीमा एक घंटे बाद खत्म हो जाती है, इसलिए आपको यह कैश मेमोरी मिटानी चाहिए और हर घंटे नए विज्ञापनों के साथ फिर से लोड करना चाहिए.

GADAdLoader शुरू होने के बाद, विज्ञापन का अनुरोध करने के लिए, इसके loadRequest: तरीके को कॉल करें:

Swift

adLoader.load(GADRequest())

Objective-C

[self.adLoader loadRequest:[GADRequest request]];

loadRequest: GADAdLoader में शामिल किए गए तरीके में, GADRequest बैनर और पेज पर अचानक दिखने वाले विज्ञापन के लिए एक जैसे ऑब्जेक्ट स्वीकार किए जाते हैं. दूसरे टाइप के विज्ञापन की तरह ही टारगेटिंग की जानकारी जोड़ने के लिए, अनुरोध ऑब्जेक्ट का इस्तेमाल किया जा सकता है.

एक से ज़्यादा विज्ञापन लोड करें (ज़रूरी नहीं)

एक ही अनुरोध में कई विज्ञापन लोड करने के लिए, GADAdLoader शुरू करते समय GADMultipleAdsAdLoaderOptions ऑब्जेक्ट सेट करें.

Swift

let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ multipleAdOptions ])

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
    [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdsOptions.numberOfAds = 5;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ multipleAdsOptions ]];

हर अनुरोध के लिए विज्ञापनों की संख्या पांच तक सीमित है. इस बात की कोई गारंटी नहीं है कि SDK टूल, मांगे गए विज्ञापन दिखाएगा.

Google पर दिखाए गए सभी विज्ञापन एक-दूसरे से अलग होंगे. हालांकि, यह ज़रूरी नहीं है कि रिज़र्व की गई इन्वेंट्री या तीसरे पक्ष के खरीदारों के विज्ञापन यूनीक हों.

अगर आप मीडिएशन का इस्तेमाल कर रहे हैं, तो GADMultipleAdsAdLoaderOptions क्लास का इस्तेमाल न करें, क्योंकि एक से ज़्यादा नेटिव विज्ञापनों के अनुरोध इस समय उन विज्ञापन यूनिट आईडी के लिए काम नहीं करते जिन्हें मीडिएशन के लिए कॉन्फ़िगर किया गया है.

लोड होने की प्रोसेस पूरी होने का समय तय करना

जब कोई ऐप्लिकेशन loadRequest: को कॉल करता है, तो वह इन कामों को करने के लिए कॉल का इस्तेमाल करके किए गए अनुरोध के नतीजे पा सकता है:

• GADAdLoaderDelegate में adLoader:didFailToReceiveAdWithError:
• GADNativeAdLoaderDelegate में adLoader:didReceiveNativeAd:

किसी एक विज्ञापन का अनुरोध करने पर, उनमें से किसी एक तरीके को एक बार ही कॉल किया जाएगा.

कई विज्ञापनों के लिए अनुरोध करने से, ऊपर दिए गए तरीकों का कम से कम एक कॉलबैक मिलेगा, लेकिन यह अनुरोध किए गए विज्ञापनों की ज़्यादा से ज़्यादा संख्या से ज़्यादा नहीं होगा.

इसके अलावा, GADAdLoaderDelegate, adLoaderDidFinishLoading कॉलबैक की सुविधा भी देता है. प्रतिनिधि बनाने का यह तरीका बताता है कि विज्ञापन लोड करने वाले ने विज्ञापन लोड कर लिए हैं और अनुरोध के लिए किसी दूसरे विज्ञापन या गड़बड़ी की रिपोर्ट नहीं की जाएगी. यहां एक उदाहरण दिया गया है कि एक साथ कई नेटिव विज्ञापन लोड करते समय, इसका इस्तेमाल कैसे करें:

Swift

class ViewController: UIViewController, GADNativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
    multipleAdOptions.numberOfAds = 5;
    adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
        rootViewController: self,
        adTypes: [ .native ],
        options: [ multipleAdOptions ])

    adLoader.delegate = self
    adLoader.load(GADRequest())
  }

  func adLoader(_ adLoader: GADAdLoader,
       didReceive nativeAd: GADNativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: GADAdLoader) {
    // The adLoader has finished loading ads, and a new request can be sent.
  }

}

Objective-C

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;
  self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:rootViewController
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ multipleAdsOptions ]];

  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

पूरे न हो पाने वाले अनुरोधों पर कार्रवाई करना

ऊपर दिए गए प्रोटोकॉल GADAdLoaderDelegate प्रोटोकॉल को बढ़ाते हैं, जो विज्ञापनों के लोड न होने पर भेजे जाने वाले मैसेज को परिभाषित करता है.

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

चेतावनी: हम adLoader:didFailToReceiveAdWithError: को मंज़ूरी देने वाले तरीके से, नया विज्ञापन लोड करने की कोशिश नहीं करते. अगर आपको adLoader:didFailToReceiveAdWithError: से कोई विज्ञापन लोड करना है, तो सीमित नेटवर्क कनेक्टिविटी जैसी स्थितियों में विज्ञापन अनुरोधों के लगातार विफल होने से बचने के लिए विज्ञापन लोड करने की एक बार फिर से कोशिश करें.

नेटिव विज्ञापन इवेंट की सूचना पाएं

नेटिव विज्ञापन इंटरैक्शन से जुड़े इवेंट की सूचना पाने के लिए, नेटिव विज्ञापन की डेलिगेट प्रॉपर्टी सेट करें:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

इसके बाद, GADNativeAdDelegate इन्हें लागू करें, ताकि आप इन लोगों को कॉल कर सकें:

Swift

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

सबसे सही तरीके

विज्ञापन लोड करते समय इन नियमों का पालन करें.

• सूची में नेटिव विज्ञापनों का इस्तेमाल करने वाले ऐप्लिकेशन को, विज्ञापनों की सूची को पहले से कैश मेमोरी में सेव करना चाहिए.

• विज्ञापनों को प्री-कैशिंग करते समय, कैश मेमोरी मिटाएं और एक घंटे बाद पेज को फिर से लोड करें.

• पहला अनुरोध लोड होने तक, loadAd() या loadAds() को GADAdLoader पर कॉल न करें.

अपना विज्ञापन दिखाएं

कोई विज्ञापन लोड करने के बाद, बस उसे आपके उपयोगकर्ताओं को दिखाना ही बाकी है. इसका तरीका जानने के लिए, हमारी नेटिव ऐडवांस्ड गाइड पर जाएं.