iOS के लिए मोबाइल ऐप्लिकेशन (AFSMA) लागू करने के लिए AFS

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

इस गाइड में यह माना गया है कि आपको इनके बारे में जानकारी है:

खास जानकारी

इस दस्तावेज़ में मोबाइल ऐप्लिकेशन (AFSMA) के विज्ञापनों के लिए, AFS को इंटिग्रेट करने की प्रोसेस के बारे में बताया गया है आपके iOS मोबाइल ऐप्लिकेशन में. AFSMA विज्ञापनों को कभी-कभी डाइनैमिक भी कहा जाता है खोज विज्ञापनों की लंबाई के बारे में बात करते हैं. iOS पर AFSMA विज्ञापनों का अनुरोध करने और उन्हें रेंडर करने के लिए, आपको ये काम करने होंगे इन्हें लागू करें:

GADSearchBannerView

  • यह क्लास, iOS UIView क्लास से इनहेरिट करती है और AFSMA विज्ञापन दिखाती है. कॉन्टेंट बनाने GADSearchBannerView ऐसे विज्ञापन के लिए अनुरोध करता है जिसमें GADDynamicHeightSearchRequest और दिखाए गए विज्ञापनों को रेंडर करता है. कॉन्टेंट बनाने GADSearchBannerView को ऐप्लिकेशन के किसी भी मौजूदा व्यू में जोड़ा जाना चाहिए; आम तौर पर, यह पैरंट व्यू कंट्रोलर होता है, जिसमें GADSearchBannerView को जोड़ा गया. सही प्रतिनिधियों को सेट किया जाना चाहिए GADSearchBannerView.
  • GADSearchBannerView को इससे इंस्टैंशिएट किया जाना चाहिए AFSMA विज्ञापनों का अनुरोध करने के लिए, initWithAdSize:kGADAdSizeFluid. इंस्टैंशिएट हो रहा है GADSearchBannerView ने लेगसी AFSMA के initWithAdSize:kGADAdSizeBanner का अनुरोध किया है विज्ञापन.
  • इस ऑब्जेक्ट की adUnitID प्रॉपर्टी को आपके प्रॉपर्टी कोड पर सेट करना ज़रूरी है.

GADDynamicHeightSearchRequest

  • यह ऑब्जेक्ट, विज्ञापन अनुरोध के पैरामीटर इनकैप्सुलेट करता है. यह JavaScript विज्ञापन अनुरोध के ऑब्जेक्ट (पेज के विकल्प, यूनिट) में पैरामीटर सेट करना विकल्प) AFS डेस्कटॉप और मोबाइल वेब के लिए.

(void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)size

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

लागू करने का उदाहरण

नीचे दिए गए उदाहरण में बताया गया है कि कैसे GBannerViewController का इस्तेमाल करके UIScrollView के सबव्यू के तौर पर GADSearchBannerView. AFSMA का सही तरीके से अनुरोध करने के लिए विज्ञापनों के लिए, GADSearchBannerView ऑब्जेक्ट इसके साथ इंस्टैंशिएट होना चाहिए initWithAdSize:kGADAdSizeFluid.

// GBannerViewController.m implementation

@interface GBannerViewController () <GADAdSizeDelegate,
                                     GADBannerViewDelegate>

@property(nonatomic, strong) GADSearchBannerView *searchBannerView;

@property(nonatomic, strong) UIScrollView *scrollView;

@end

@implementation GBannerViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Create the scroll view.
  ....
  ....

  // Create the banner.
  self.searchBannerView = [[GADSearchBannerView alloc] initWithAdSize:kGADAdSizeFluid];

  // Replace with your pub ID (e.g. ms-app-pub-9616389000213823).
  self.searchBannerView.adUnitID = @"ms-app-pub-################";

  // Set the initial location and size of the banner. The initial height
  // is set to 0 since we might not get an ad back.
  self.searchBannerView.frame = CGRectMake(0,
                                           0,
                                           CGRectGetWidth(self.view.bounds),
                                           0);
  self.searchBannerView.autoresizingMask = UIViewAutoresizingFlexibleWidth;

  // Set the delegate properties.
  self.searchBannerView.adSizeDelegate = self;
  self.searchBannerView.delegate = self;

  // Add the new search banner into the parent scrollView.
  [self.scrollView addSubview:self.searchBannerView];
  }

उसी GBannerViewController में, GADDynamicHeightSearchRequest बनाएं जो GADSearchView में रेंडर किए जाने वाले विज्ञापन के पैरामीटर के बारे में बताता है.

// Create a search request and load the banner.
GADDynamicHeightSearchRequest *searchRequest = [[GADDynamicHeightSearchRequest alloc] init];

// Ad request options (set using GADDynamicHeightSearchRequest properties).
searchRequest.query = @"flowers";
searchRequest.numberOfAds = 2;

// Replace with the ID of a style from your custom search styles
[searchRequest setAdvancedOptionValue:@"0000000001"
                               forKey:@"styleId"];

पसंद के मुताबिक बनाने के दूसरे विकल्प GADDynamicHeightSearchRequest पर अन्य प्रॉपर्टी सेट करने से ऐसा हो सकता है ऑब्जेक्ट है.

विज्ञापन अनुरोध करने के लिए, GADDynamicHeightSearchRequest के साथ loadRequest को कॉल करें GADSearchBannerView ऑब्जेक्ट से ऑब्जेक्ट:

[self.searchBannerView loadRequest:searchRequest];

एक बार पैरंट व्यू में, GADSearchBannerView को ठीक से शामिल करने के लिए विज्ञापन वापस आते हैं, तो नीचे दिया गया कॉलबैक लागू किया जाना चाहिए.

// Callback to update the parent view height.
- (void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)size {
  // Update the banner view based on the ad size.
  CGRect newFrame = self.searchBannerView.frame;
  newFrame.size.height = size.size.height;
  self.searchBannerView.frame = newFrame;

  // Perform any additional logic needed due to banner view size change.
  ...
}

बेहतर विकल्प

विज्ञापन अनुरोध के ज़्यादातर पैरामीटर, प्रॉपर्टी की मदद से सेट किए जा सकते हैं GADDynamicHeightSearchRequest ऑब्जेक्ट (searchRequest ऊपर). अन्य पैरामीटर को setAdvancedOptionValue के साथ की-वैल्यू पेयर का इस्तेमाल करके सेट करना होगा तरीका:

// Advanced customization options (set using key-value pair).

// Set a parameter (parameter_name) and its value (parameter_value).
[searchRequest setAdvancedOptionValue:@"parameter_value"
                               forKey:@"parameter_name"];

// Example: Show visible URL below description (domainLinkAboveDescription: false).
[searchRequest setAdvancedOptionValue:@"false"
                               forKey:@"domainLinkAboveDescription"];

उपलब्ध पैरामीटर की पूरी सूची देखें.

गड़बड़ियों की जांच करना

GADBannerViewDelegate में कॉलबैक होता है, ताकि गड़बड़ियों की जांच करने में आपकी मदद की जा सके:

- (void)adView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(GADRequestError *)error {

  // This callback is triggered when the ad request fails.
  // Add code here to debug the error object to discover causes of failure
  NSLog(@"Ad call failed due to %@", error.userInfo[@"NSUnderlyingError"]);
}

अगर कोई विज्ञापन अनुरोध फ़ेल होता है, तो गड़बड़ी को ठीक से हैंडल करने के लिए आप इस कॉलबैक का इस्तेमाल कर सकते हैं और गड़बड़ी ऑब्जेक्ट के ज़रिए गड़बड़ी की जांच करें.