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

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

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

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

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

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

• शुरुआती निर्देश के बारे में पूरी जानकारी दें.

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

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

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

ca-app-pub-3940256099942544/3986624511

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

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

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

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

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

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

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

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 प्रोटोकॉल में एक मैसेज शामिल होता है. यह मैसेज, नेटिव विज्ञापन लोड होने पर प्रतिनिधि को भेजा जाता है.

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

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

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

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

adLoader.load(GADRequest())

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

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

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

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

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

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

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.
  }

}

@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 प्रोटोकॉल का दायरा बढ़ाते हैं. यह प्रोटोकॉल, विज्ञापनों के लोड न होने की स्थिति में भेजे जाने वाले मैसेज के बारे में बताता है.

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

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

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

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

nativeAd.delegate = self

nativeAd.delegate = self;

इसके बाद, इन डेलिगेट से मिलने वाले कॉल पाने के लिए, GADNativeAdDelegate को लागू करें:

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.
}

- (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.
}

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

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

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

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

• जब तक पिछला अनुरोध लोड नहीं हो जाता, तब तक loadRequest: को GADAdLoader पर फिर से कॉल न करें, जैसा कि adLoaderDidFinishLoading: में बताया गया है.

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

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