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

नेटिव टेंप्लेट डाउनलोड करना

अहम जानकारी: आगे बढ़ने से पहले, नेटिव विज्ञापन लोड करने का तरीका जानें. नेटिव विज्ञापनों के बारे में ज़्यादा जानने के लिए, हमारी नेटिव विज्ञापन प्लेबुक पढ़ें.

नेटिव विज्ञापनों का इस्तेमाल करके, अपने विज्ञापनों को पसंद के मुताबिक बनाया जा सकता है. इससे उपयोगकर्ता को बेहतर अनुभव मिलता है. बेहतर उपयोगकर्ता अनुभव से, यूज़र ऐक्टिविटी बढ़ सकती है और आपका कुल रिटर्न बेहतर हो सकता है.

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

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

ध्यान दें: अगर आपको अपने नेटिव लेआउट को शुरू से डिज़ाइन करना है, तो नेटिव ऐडवांस दस्तावेज़ पर वापस जाएं.

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

टेंप्लेट के साइज़

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

GADTSmallTemplateView

छोटा टेंप्लेट, UICollectionView या UITableView सेल के लिए सही होता है. उदाहरण के लिए, इसका इस्तेमाल इन-फ़ीड विज्ञापनों के लिए किया जा सकता है. इसके अलावा, जहां भी आपको पतला रेक्टैंगल विज्ञापन व्यू की ज़रूरत हो वहां भी इसका इस्तेमाल किया जा सकता है. इस टेंप्लेट का डिफ़ॉल्ट साइज़ 91 पॉइंट ऊंचाई और 355 पॉइंट चौड़ाई का होता है.

GADTMediumTemplateView

मीडियम टेंप्लेट का मतलब है कि यह 1/2 से 3/4 पेज व्यू का होना चाहिए. यह विकल्प, लैंडिंग या स्प्लैश पेजों के लिए अच्छा है. हालांकि, इसे UITableViews में भी शामिल किया जा सकता है. इस टेंप्लेट का डिफ़ॉल्ट साइज़, 370 पॉइंट ऊंचाई और 355 पॉइंट चौड़ाई का होता है.

हमारे सभी टेंप्लेट में ऑटोलेआउट की सुविधा काम करती है. इसलिए, प्लेसमेंट के साथ एक्सपेरिमेंट करने में संकोच न करें. बेशक, अपनी ज़रूरतों के हिसाब से सोर्स कोड और xib फ़ाइलों को भी बदला जा सकता है.

नेटिव विज्ञापन टेंप्लेट इंस्टॉल करना

नेटिव टेंप्लेट इंस्टॉल करने के लिए, बस ZIP फ़ाइल डाउनलोड करें और उसे अपने Xcode प्रोजेक्ट में खींचें और छोड़ें. ज़रूरत पड़ने पर आइटम कॉपी करें को चुनना न भूलें.

नेटिव विज्ञापन टेंप्लेट का इस्तेमाल करना

अपने प्रोजेक्ट में फ़ोल्डर जोड़ने और अपनी फ़ाइल में उससे जुड़ी क्लास को शामिल करने के बाद, टेंप्लेट का इस्तेमाल करने के लिए इस रेसिपी को फ़ॉलो करें. ध्यान दें कि फ़ॉन्ट और स्टाइल प्रॉपर्टी को बदलने का एकमात्र तरीका, स्टाइल डिक्शनरी का इस्तेमाल करना है. फ़िलहाल, हम xib में सेट की गई किसी भी स्टाइल को बदल देते हैं.

Objective-C

/// Step 1: Import the templates that you need.
#import "NativeTemplates/GADTSmallTemplateView.h"
#import "NativeTemplates/GADTTemplateView.h"
...

// STEP 2: Initialize your template view object.
GADTSmallTemplateView *templateView =
    [[NSBundle mainBundle] loadNibNamed:@"GADTSmallTemplateView" owner:nil options:nil]
      .firstObject;

// STEP 3: Template views are just GADNativeAdViews.
_nativeAdView = templateView;
nativeAd.delegate = self;

// STEP 4: Add your template as a subview of whichever view you'd like.
// This must be done before calling addHorizontalConstraintsToSuperviewWidth.
// Please note: Our template objects are subclasses of GADNativeAdView so
// you can insert them into whatever type of view you’d like, and don’t need to
// create your own.
[self.view addSubview:templateView];

// STEP 5 (Optional): Create your styles dictionary. Set your styles dictionary
// on the template property. A default dictionary is created for you if you do
// not set this. Note - templates do not currently respect style changes in the
// xib.

NSString *myBlueColor = @"#5C84F0";
NSDictionary *styles = @{
    GADTNativeTemplateStyleKeyCallToActionFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyCallToActionFontColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCallToActionBackgroundColor :
        [GADTTemplateView colorFromHexString:myBlueColor],
    GADTNativeTemplateStyleKeySecondaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeySecondaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeySecondaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyPrimaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyPrimaryFontColor : UIColor.blackColor,
    GADTNativeTemplateStyleKeyPrimaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyTertiaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyTertiaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeyTertiaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyMainBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCornerRadius : [NSNumber numberWithFloat:7.0],
};

templateView.styles = styles;

// STEP 6: Set the ad for your template to render.
templateView.nativeAd = nativeAd;

// STEP 7 (Optional): If you'd like your template view to span the width of your
// superview call this method.
[templateView addHorizontalConstraintsToSuperviewWidth];
[templateView addVerticalCenterConstraintToSuperview];

स्टाइल डिक्शनरी की कुंजियां

अपने टेंप्लेट को पसंद के मुताबिक बनाने का सबसे तेज़ तरीका, इन बटन का इस्तेमाल करके डिक्शनरी बनाना है:

Objective-C

/// Call to action font. Expects a UIFont.
GADTNativeTemplateStyleKeyCallToActionFont

/// Call to action font color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionFontColor;

/// Call to action background color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionBackgroundColor;

/// The font, font color and background color for the first row of text in the
/// template.

/// All templates have a primary text area which is populated by the native ad's
/// headline.

/// Primary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFont;

/// Primary text font color. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFontColor;

/// Primary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyPrimaryBackgroundColor;

/// The font, font color and background color for the second row of text in the
/// template.

/// All templates have a secondary text area which is populated either by the
/// body of the ad, or by the rating of the app.

/// Secondary text font. Expects a UIFont.
GADTNativeTemplateStyleKeySecondaryFont;

/// Secondary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryFontColor;

/// Secondary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryBackgroundColor;

/// The font, font color and background color for the third row of text in the
/// template. The third row is used to display store name or the default
/// tertiary text.

/// Tertiary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyTertiaryFont;

/// Tertiary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryFontColor;

/// Tertiary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryBackgroundColor;

/// The background color for the bulk of the ad. Expects a UIColor.
GADTNativeTemplateStyleKeyMainBackgroundColor;

/// The corner rounding radius for the icon view and call to action. Expects an
/// NSNumber.
GADTNativeTemplateStyleKeyCornerRadius;

अक्सर पूछे जाने वाले सवाल

टेंप्लेट ऑब्जेक्ट को इंस्टैंशिएट करने की कोशिश करने पर, मुझे अपवाद क्यों मिलता है?

ऐसा तब हो सकता है, जब आपने xib फ़ाइल में व्यू का साइज़ बदल दिया हो, लेकिन सबक्लास के "setup" तरीके में बनाए गए फ़्रेम का साइज़ न बदला हो.

मैं इन टेंप्लेट को और कैसे पसंद के मुताबिक बनाऊं?

ये टेंप्लेट, सिर्फ़ उन xibs होते हैं जिनमें से जुड़े व्यू ऑब्जेक्ट होते हैं. जैसे, iOS डेवलपमेंट में इस्तेमाल होने वाले किसी भी दूसरे xib और कस्टम व्यू क्लास. अगर आपको नेटिव विज्ञापनों को शुरू से बनाना है, तो हमारी नेटिव ऐडवांस गाइड देखें.

XIB में स्टाइल सेट करने पर, वे अपडेट क्यों नहीं हो रही हैं?

फ़िलहाल, हम GADTTemplateView.m में मौजूद डिफ़ॉल्ट स्टाइल डिक्शनरी की मदद से, सभी xib स्टाइल को बदल देते हैं.

योगदान दें

हमने नेटिव टेंप्लेट बनाए हैं, ताकि आप जल्दी से नेटिव विज्ञापन बना सकें. हमें नए टेंप्लेट या सुविधाएं जोड़ने के लिए, हमारे GitHub रिपॉज़िटरी में आपका योगदान मिलना अच्छा लगेगा. हमें पुल का अनुरोध भेजें और हम उस पर गौर करेंगे.