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

GADAdLoader को बनाने में जो आखिरी पैरामीटर शामिल है वह ऑब्जेक्ट का एक वैकल्पिक कलेक्शन है. इस सेक्शन में उन विकल्पों के बारे में बताया गया है.

Swift

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

Objective-C

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

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions इसमें नेटिव विज्ञापनों में इमेज से जुड़ी प्रॉपर्टी शामिल हैं. ऐप्लिकेशन यह कंट्रोल कर सकते हैं कि GADAdLoader, इमेज एसेट को कैसे मैनेज करता है. इसके लिए, GADNativeAdImageAdLoaderOptions ऑब्जेक्ट बनाकर, उसकी प्रॉपर्टी सेट करके (disableImageLoading, preferredImageOrientation, और shouldRequestMultipleImages) उसे शुरू किया जाता है और उसके बाद उसे पास किया जाता है.

GADNativeAdImageAdLoaderOptions की ये प्रॉपर्टी हैं:

disableImageLoading

नेटिव विज्ञापनों की इमेज एसेट GADNativeAdImage के इंस्टेंस के ज़रिए दिखाई जाती हैं, जिनमें image और imageURL प्रॉपर्टी शामिल हैं. अगर disableImageLoading को false पर सेट किया जाता है, जो डिफ़ॉल्ट (Objective-C में NO) है, तो SDK टूल, इमेज एसेट अपने-आप फ़ेच कर देगा. साथ ही, आपके लिए image और imageURL, दोनों प्रॉपर्टी को पॉप्युलेट कर देगा. अगर इसे true (या Objective-C में YES) पर सेट किया जाता है, तो SDK टूल सिर्फ़ imageURL को पॉप्युलेट करेगा. इससे, आपको अपने हिसाब से इमेज डाउनलोड करने की सुविधा मिलेगी. मैन्युअल रूप से इमेज डाउनलोड करते समय, मीडिया व्यू के लिए इमेज सेट करने के लिए, GADMediaContent की mainImage प्रॉपर्टी का इस्तेमाल करें.

preferredImageOrientation

कुछ क्रिएटिव में अलग-अलग डिवाइस ओरिएंटेशन के लिए कई इमेज उपलब्ध होती हैं. ऐप्लिकेशन इस प्रॉपर्टी को किसी एक ओरिएंटेशन कॉन्सटेंट पर सेट करके, किसी खास ओरिएंटेशन के लिए इमेज मांग सकते हैं:

• GADNativeAdImageAdLoaderOptionsOrientationAny
• GADNativeAdImageAdLoaderOptionsOrientationLandscape

• GADNativeAdImageAdLoaderOptionsOrientationPortrait

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

  अगर इस मेथड को कॉल नहीं किया जाता है, तो GADNativeAdImageAdLoaderOptionsOrientationAny की डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा.

shouldRequestMultipleImages

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

अगर GADAdLoader शुरू करते समय कोई GADAdLoaderOptions ऑब्जेक्ट पास न हो, तो हर विकल्प के लिए डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा.

GADNativeAdViewAdOptions

GADNativeAdViewAdOptions ऑब्जेक्ट का इस्तेमाल, यह बताने के लिए किया जाता है कि नेटिव विज्ञापन व्यू को विज्ञापनों को किस तरह से दिखाना चाहिए. उनके पास एक प्रॉपर्टी होती है: preferredAdChoicesPosition, जिस जगह का इस्तेमाल करके AdChoices आइकॉन डाला जाना चाहिए, यह तय किया जा सकता है. आइकॉन, विज्ञापन के किसी भी कोने में दिख सकता है और डिफ़ॉल्ट रूप से GADAdChoicesPositionTopRightCorner पर सेट होता है. इस प्रॉपर्टी की ये वैल्यू हो सकती हैं:

• GADAdChoicesPositionTopRightCorner
• GADAdChoicesPositionTopLeftCorner
• GADAdChoicesPositionBottomRightCorner
• GADAdChoicesPositionBottomLeftCorner

यहां एक उदाहरण दिया गया है, जिसमें विज्ञापन के ऊपरी बाएं कोने में AdChoices आइकॉन डालने का तरीका बताया गया है:

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

GADVideoOptions ऑब्जेक्ट का इस्तेमाल, यह बताने के लिए किया जाता है कि नेटिव वीडियो एसेट कैसे दिखाए जाने चाहिए.

startMuted बूलियन से पता चलता है कि वीडियो एसेट को म्यूट स्थिति में चलाना शुरू करना चाहिए या नहीं. डिफ़ॉल्ट वैल्यू true है.

Swift

let videoOptions = GADVideoOptions()
// Ads start muted by default. Set to false to start video ads with sound.
videoOptions.startMuted = false
adLoader = GADAdLoader(
    adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
// Ads start muted by default. Set to NO to start video ads with sound.
videoOptions.startMuted = NO;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

GADMULTIAdsAdLoaderOptions

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

GADNativeAdMediaAdLoaderOptions

इस सुविधा का इस्तेमाल करने के लिए, GADAdLoader इनीशियलाइज़ेशन के नेटिव विज्ञापन विकल्प की कैटगरी में GADNativeAdMediaAdLoaderOptions क्लास को शामिल करें.

GADNativeAdMediaAdLoaderOptions ऑब्जेक्ट, आपको मीडिया आसपेक्ट रेशियो (चौड़ाई-ऊंचाई का अनुपात) से जुड़ी प्राथमिकताएं चुनने की सुविधा देता है. यह विकल्प इमेज और वीडियो दोनों पर लागू होता है. इस क्लास में एक प्रॉपर्टी है: इसका इस्तेमाल, ऐसे mediaAspectRatio आसपेक्ट रेशियो (चौड़ाई-ऊंचाई का अनुपात) की जानकारी देने के लिए किया जा सकता है जो वीडियो पर काम करता है. इस प्रॉपर्टी की ये वैल्यू हो सकती हैं:

Objective-C	Swift
GADMediaAspectRatioAny	.any
GADMediaAspectRatioLandscape	.landscape
GADMediaAspectRatioPortrait	.portrait
GADMediaAspectRatioSquare	.square

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