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

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

जब कोई नेटिव विज्ञापन लोड होता है, तो आपके ऐप्लिकेशन को एक विज्ञापन ऑब्जेक्ट मिलता है. इसमें उसकी एसेट होती हैं. इसके बाद, उन्हें दिखाने की ज़िम्मेदारी 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",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    // The UIViewController parameter is nullable.
    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]];

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

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

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

Swift

let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    // The UIViewController parameter is optional.
    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"
    // The UIViewController parameter is nullable.
    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",
        // The UIViewController parameter is optional.
        rootViewController: rootViewController,
        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"
      // The UIViewController parameter is nullable.
      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: से कोई विज्ञापन लोड करना है, तो विज्ञापन लोड करने के लिए फिर से कोशिश करने की संख्या सीमित करें. इससे, सीमित नेटवर्क कनेक्शन जैसी स्थितियों में, विज्ञापन के अनुरोध बार-बार अस्वीकार होने से बचा जा सकता है.

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

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

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

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

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

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

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

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

• नेटिव विज्ञापन को सिर्फ़ ज़रूरत के हिसाब से कैश मेमोरी में सेव करें. उदाहरण के लिए, पहले से कैश मेमोरी में सेव करने के दौरान, सिर्फ़ उन विज्ञापनों को कैश मेमोरी में सेव करें जो स्क्रीन पर तुरंत दिखते हैं. नेटिव विज्ञापनों के लिए ज़्यादा मेमोरी का इस्तेमाल होता है. साथ ही, नेटिव विज्ञापनों को मिटाए बिना उन्हें कैश मेमोरी में सेव करने पर, ज़्यादा मेमोरी का इस्तेमाल होता है.

• इस्तेमाल में न होने पर नेटिव विज्ञापनों को मिटा दें.

आपका विज्ञापन दिखाना

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