इस पेज का अनुवाद Cloud Translation API से किया गया है.

पसंद के मुताबिक नेटिव विज्ञापन फ़ॉर्मैट

कस्टम विज्ञापन फ़ॉर्मैट

सिस्टम की ओर से तय किए गए नेटिव विज्ञापन फ़ॉर्मैट की तरह ही, पसंद के मुताबिक नेटिव विज्ञापन फ़ॉर्मैट भी GADAdLoader ऑब्जेक्ट का इस्तेमाल करके लोड किए जाते हैं. GADAdLoader को शुरू करते समय, adTypes कलेक्शन में GADAdLoaderAdTypeCustomNative कॉन्स्टेंट को शामिल करने पर, विज्ञापन लोड करते समय इसे कस्टम नेटिव फ़ॉर्मैट का अनुरोध करने के लिए कॉन्फ़िगर किया जाएगा.

GADCustomNativeAdLoaderDelegate

कस्टम फ़ॉर्मैट लोड करने के प्रोटोकॉल के दो तरीके हैं. पहले का इस्तेमाल, GADAdLoader यह पता लगाने के लिए करता है कि उसे किन फ़ॉर्मैट आईडी का अनुरोध करना चाहिए:

Swift

public func customNativeAdFormatIDs(for adLoader: GADAdLoader) -> [Any]

Objective-C

- (NSArray *)customNativeAdFormatIDsForAdLoader:(GADAdLoader *)adLoader;

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

दूसरा मैसेज तब भेजा जाता है, जब कस्टम नेटिव विज्ञापन लोड हो जाता है. यह मैसेज, सिस्टम के तय किए गए फ़ॉर्मैट के लिए भेजे गए मैसेज की तरह ही होता है:

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didReceive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

फ़ॉर्मैट आईडी

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

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

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

कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाना

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

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

यहां एक विज्ञापन व्यू का उदाहरण दिया गया है, जो आसान कस्टम नेटिव विज्ञापन दिखा सकता है:

MySimpleNativeAdView.h

Swift

import UIKit
import GoogleMobileAds

/// Custom native ad view class with format ID 10063170.
class MySimpleNativeAdView: UIView {

  /// Weak references to this ad's asset views.
  @IBOutlet weak var headlineView: UILabel!
  @IBOutlet weak var mainImageView: UIImageView!
  @IBOutlet weak var captionView: UILabel!

  ...

  /// Populates the ad view with the custom native ad object.
  func populateWithCustomNativeAd(_ customNativeAd: GADCustomNativeAd) {
    ...
  }
}

Objective-C

@import UIKit;
@import GoogleMobileAds;

/// View representing a custom native ad format with format ID 10063170.
@interface MySimpleNativeAdView : UIView

// Weak references to this ad's asset views.
@property(weak, nonatomic) IBOutlet UILabel *headlineView;
@property(weak, nonatomic) IBOutlet UIImageView *mainImageView;
@property(weak, nonatomic) IBOutlet UILabel *captionView;

/// Populates the ad view with the custom native ad object.
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

@end

MySimpleNativeAdView.m (बाकी हिस्सा)

Swift

...
func populateWithCustomNativeAd(_ customNativeAd: GADCustomNativeAd) {
  self.customNativeAd = customNativeAd

  // Populate the custom native ad assets.
  headlineView.text = self.customNativeAd.stringForKey("Headline")
  mainImageView.image = self.customNativeAd.imageForKey("MainImage")?.image
  captionView.text = self.customNativeAd.stringForKey("Caption")
}
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  self.customNativeAd = customNativeAd;

  // Populate the custom native ad assets.
  self.headlineView.text = [customNativeAd stringForKey:@"Headline"];
  self.mainImageView.image = [customNativeAd imageForKey:@"MainImage"].image;
  self.captionView.text = [customNativeAd stringForKey:@"Caption"];
}
...

AdChoices आइकॉन को रेंडर करना

डिजिटल सर्विसेज़ ऐक्ट (डीएसए) का पालन करने के लिए, यूरोपियन इकनॉमिक एरिया (ईईए) में रिज़र्वेशन करके दिखाए जाने वाले विज्ञापनों में AdChoices आइकॉन और Google के 'विज्ञापन के बारे में जानकारी' पेज का लिंक होना ज़रूरी है. कस्टम नेटिव विज्ञापन लागू करते समय, AdChoices आइकॉन को रेंडर करने की ज़िम्मेदारी आपकी होती है. मुख्य विज्ञापन एसेट को रेंडर करते समय, AdChoices आइकॉन के लिए क्लिक Listener को रेंडर और सेट करना ज़रूरी है.

यहां दिए गए उदाहरण में, AdChoices आइकॉन को रेंडर किया गया है और क्लिक के सही व्यवहार को कॉन्फ़िगर किया गया है.

Swift

class MySimpleNativeAdView: UIView {
  @IBOutlet weak var adChoicesView: UIImageView!

  override func awakeFromNib() {
    super.awakeFromNib()

    // Enable clicks on AdChoices.
    adChoicesView.addGestureRecognizer(
      UITapGestureRecognizer(
        target: self,
        action: #selector(performClickOnAdChoices(_:))))
    adChoicesView.isUserInteractionEnabled = true
  }

  @objc func performClickOnAdChoices(_ sender: UIImage!) {
    customNativeAd.performClickOnAsset(withKey:
      GADNativeAssetIdentifier.adChoicesViewAsset.rawValue)
  }

  func populate(withCustomNativeAd customNativeAd: GADCustomNativeAd) {

    // Render the AdChoices image.
    let adChoicesKey = GADNativeAssetIdentifier.adChoicesViewAsset.rawValue
    let adChoicesImage = customNativeAd.image(forKey: adChoicesKey)?.image
    adChoicesView.image = adChoicesImage
    adChoicesView.isHidden = adChoicesImage == nil
    ...
  }
}

Objective-C

@interface MySimpleNativeAdView ()

@property(nonatomic, weak) IBOutlet UIImageView *adChoicesView;

@end

@implementation MySimpleNativeAdView

- (void)awakeFromNib {
  [super awakeFromNib];
  // Enable clicks on AdChoices.
  [self.adChoicesView addGestureRecognizer:[[UITapGestureRecognizer alloc]
                                            initWithTarget:self
                                            action:@selector(performClickOnAdChoices:)]];
  self.adChoicesView.userInteractionEnabled = YES;
}

- (void)performClickOnAdChoices:(UITapGestureRecognizer *)sender {
    [self.customNativeAd performClickOnAssetWithKey:GADNativeAdChoicesViewAsset];
}

- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  // Render the AdChoices image.
  GADNativeAdImage *adChoicesAsset = [customNativeAd
    imageForKey:GADNativeAdChoicesViewAsset];
  self.adChoicesView.image = adChoicesAsset.image;
  self.adChoicesView.hidden = (adChoicesAsset == nil);
  ...
}

पसंद के मुताबिक नेटिव विज्ञापन फ़ॉर्मैट के लिए नेटिव वीडियो

कस्टम फ़ॉर्मैट बनाते समय, आपके पास फ़ॉर्मैट को वीडियो के लिए उपलब्ध कराने का विकल्प होता है.

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

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

Swift

...
  /// Populates the ad view with the custom native ad object.
  func populate(withCustomNativeAd customNativeAd: GADCustomNativeAd) {
    if customNativeAd.videoController.hasVideoContent(),
      let mediaView = customNativeAd.mediaView {
      updateMainView(mediaView)
    } else {
      // Assumes your native format has an image asset with the name MainImage.
      let image: UIImage? = customNativeAd.image(forKey: "MainImage")?.image
      updateMainView(UIImageView(image: image))
    }
  }

  private func updateMainView(_ mainView:UIView) {
    // Assumes you have a placeholder view for your media content.
    // Remove all the placeholder's subviews.
    for subview: UIView in mainPlaceholder.subviews {
      subview.removeFromSuperview()
    }
    mainPlaceholder.addSubview(mainView)
    // Size the media view to fill our container size.
    mainView.translatesAutoresizingMaskIntoConstraints = false
    let viewDictionary: [AnyHashable: Any] = ["mainView":mainView]
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "H:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "V:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
  }
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)ad {
  UIView *mainView = nil;
  if (ad.videoController.hasVideoContent) {
    mainView = ad.mediaView;
  } else {
    // Assumes your native format has an image asset with the name MainImage.
    UIImage *image = [ad imageForKey:@"MainImage"].image;
    mainView = [[UIImageView alloc] initWithImage:image];
  }
  // Assumes you have a placeholder view for your media content.
  for (UIView *subview in self.mainPlaceholder.subviews) {
    [subview removeFromSuperview];
  }
  [self.mainPlaceholder addSubview:mainView];

  // Size the main view to fill our container size.
  [mainView setTranslatesAutoresizingMaskIntoConstraints:NO];
  NSDictionary *viewDictionary = NSDictionaryOfVariableBindings(mainView);
  [self.mainPlaceholder
      addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|[mainView]|"
                                                             options:0
                                                             metrics:nil
                                                               views:viewDictionary]];
}
...

कस्टम नेटिव विज्ञापन के वीडियो अनुभव को पसंद के मुताबिक बनाने के तरीके के बारे में ज़्यादा जानने के लिए, GADVideoController देखें.

नेटिव वीडियो के काम करने के उदाहरण के लिए, Ad Manager में कस्टम रेंडरिंग का उदाहरण डाउनलोड करें.

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

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

इंप्रेशन रिकॉर्ड करना

कस्टम नेटिव विज्ञापन के लिए इंप्रेशन रिकॉर्ड करने के लिए, उससे जुड़े GADCustomNativeAd पर recordImpression तरीका कॉल करें:

Swift

myCustomNativeAd.recordImpression()

Objective-C

[myCustomNativeAd recordImpression];

SDK टूल, एक ही अनुरोध के लिए डुप्लीकेट इंप्रेशन रिकॉर्ड होने से रोकता है. ऐसा तब होता है, जब आपका ऐप्लिकेशन किसी एक विज्ञापन के लिए, गलती से कई बार इस तरीके को कॉल करता है.

क्लिक की रिपोर्टिंग

SDK को यह रिपोर्ट करने के लिए कि किसी ऐसेट व्यू पर क्लिक हुआ है, उससे जुड़े GADCustomNativeAd पर performClickOnAssetWithKey: मेथड को कॉल करें और क्लिक की गई ऐसेट का नाम पास करें. उदाहरण के लिए, अगर आपके कस्टम फ़ॉर्मैट में "MainImage" नाम की कोई ऐसेट है और आपको उस ऐसेट से जुड़े व्यू पर क्लिक की रिपोर्ट करनी है, तो आपका कोड कुछ ऐसा दिखेगा:

Swift

myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[myCustomNativeAd performClickOnAssetWithKey:@"MainImage"];

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

कस्टम क्लिक ऐक्शन का जवाब देना

GADCustomNativeAd में एक प्रॉपर्टी customClickHandler है, जो GADNativeAdCustomClickHandler टाइप की है

Swift

typealias GADNativeAdCustomClickHandler = (assetID: String) -> Void

Objective-C

typedef void (^GADNativeAdCustomClickHandler)(NSString *assetID);

यह एक ब्लॉक (Objective-C) / क्लोज़र (Swift) है, जो assetID को इनपुट पैरामीटर के तौर पर स्वीकार करता है. इससे उस एसेट की पहचान की जाती है जिस पर क्लिक किया गया है.

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

अगर कोई ब्लॉक सेट किया गया था, तो Objective-C में customClickHandler ब्लॉक या Swift में क्लोज़र को चालू करें.
विज्ञापन के डीपलिंक यूआरएल पर जाएं और पहला ऐसा यूआरएल खोलें जिसके लिए मिलता-जुलता ऐप्लिकेशन मिल सकता है.
कोई ब्राउज़र खोलें और विज्ञापन के पारंपरिक डेस्टिनेशन यूआरएल पर जाएं.

customClickHandler प्रॉपर्टी, Objective-C में ब्लॉक और Swift में क्लोज़र को स्वीकार करती है. अगर आपने ब्लॉक या बंद करने की सुविधा सेट की है, तो SDK उसे चलाएगा और कोई और कार्रवाई नहीं करेगा. हालांकि, अगर आपने कोई वैल्यू सेट नहीं की है, तो SDK टूल, विज्ञापन के साथ रजिस्टर किए गए डीपलिंक और/या डेस्टिनेशन यूआरएल पर भेज देगा.

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

Swift

myCustomNativeAd.customClickHandler = { assetID in
  if assetID == "MainImage" {
    let alertView = UIAlertView(title: "Custom Click",
        message: "You just clicked on the image!",
        delegate: self,
        cancelButtonTitle: "OK")
    alertView.alertViewStyle = .default
    alertView.show()
  }
}
myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[self.customNativeAd setCustomClickHandler:^(NSString *assetID){
  if ([assetID isEqualToString:@"MainImage"]) {
    [[[UIAlertView alloc] initWithTitle:@"Custom Click"
                                message:@"You just clicked on the image!"
                               delegate:self
                      cancelButtonTitle:@"OK"
                      otherButtonTitles:nil] show];
  }
}];
[self.customNativeAd performClickOnAssetWithKey:@"MainImage"];

पहली बार में, यह अजीब लग सकता है कि कस्टम क्लिक हैंडल मौजूद हैं. आखिरकार, आपके ऐप्लिकेशन ने SDK टूल को सिर्फ़ यह बताया है कि क्लिक हुआ है, तो SDK टूल को ऐप्लिकेशन को इसकी शिकायत क्यों करनी चाहिए?

जानकारी का यह फ़्लो कई वजहों से फ़ायदेमंद है. हालांकि, सबसे अहम बात यह है कि इससे SDK टूल, क्लिक के जवाब को कंट्रोल कर पाता है. उदाहरण के लिए, यह क्रिएटिव के लिए सेट किए गए तीसरे पक्ष के ट्रैकिंग यूआरएल को अपने-आप पिंग कर सकता है. साथ ही, किसी अतिरिक्त कोड के बिना बैकग्राउंड में अन्य टास्क को मैनेज कर सकता है.

नेटिव विज्ञापन कोड की जांच करना

सीधे तौर पर बेचे जाने वाले विज्ञापन

अगर आपको यह टेस्ट करना है कि सीधे तौर पर बेचे जाने वाले नेटिव विज्ञापन कैसा दिखते हैं, तो इस Ad Manager विज्ञापन यूनिट आईडी का इस्तेमाल करें:

/21775744923/example/native

इसे ऐप्लिकेशन इंस्टॉल करने और कॉन्टेंट विज्ञापनों के सैंपल दिखाने के लिए कॉन्फ़िगर किया गया है. साथ ही, इसे इन ऐसेट के साथ कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाने के लिए भी कॉन्फ़िगर किया गया है:

हेडलाइन (टेक्स्ट)
MainImage (इमेज)
कैप्शन (टेक्स्ट)

नेटिव बैकफ़िल विज्ञापन

नेटिव बैकफ़िल विज्ञापनों के व्यवहार की जांच करने के लिए, इस Ad Manager विज्ञापन यूनिट का इस्तेमाल करें:

/21775744923/example/native-backfill

यह ऐप्लिकेशन इंस्टॉल करने और कॉन्टेंट के नमूने के तौर पर विज्ञापन दिखाएगा. इनमें AdChoices ओवरले शामिल होगा.

लाइव जाने से पहले, अपने कोड को अपडेट करना न भूलें, ताकि वह आपकी असल विज्ञापन यूनिट और फ़ॉर्मैट आईडी को रेफ़र कर सके!