इस गाइड में, नेटिव विज्ञापन ऐड-ऑन का इस्तेमाल करके, Unity ऐप्लिकेशन में AdMob नेटिव विज्ञापन लागू करने का तरीका बताया गया है. साथ ही, इस दौरान ध्यान रखने वाली कुछ ज़रूरी बातें भी बताई गई हैं.
नेटिव विज्ञापन, जिस ऐप्लिकेशन या वेबसाइट पर दिखाए जाते हैं वे उसके उपयोगकर्ता अनुभव के हिसाब से ढल जाते हैं. साथ ही, ये विज्ञापन उस ऐप्लिकेशन के विज़ुअल डिज़ाइन से भी मैच कर जाते हैं जिसमें इन्हें दिखाया जाता है. AdMob के नेटिव विज्ञापन फ़ॉर्मैट में, पब्लिशर ऐसे विज्ञापनों को रेंडर कर सकते हैं जो कॉन्टेंट से मैच करते हैं. इस टेक्नोलॉजी का इस्तेमाल करके, अपनी ज़रूरत के हिसाब से रेंडरिंग लागू की जा सकती हैं. ये रेंडर, Unity ऐप्लिकेशन में नेटिव कोड का पूरा इस्तेमाल करते हैं.
नेटिव विज्ञापन दिखाने के लिए, उसी तरह के GameObjects
का इस्तेमाल किया जाता है जिनसे पहले से ही आपके ऐप्लिकेशन बनाए जा रहे हैं. साथ ही, इन्हें उस ऐप्लिकेशन के विज़ुअल डिज़ाइन के हिसाब से फ़ॉर्मैट किया जा सकता है जिस पर इन्हें दिखाया जाता है. जब कोई नेटिव विज्ञापन लोड होता है, तब आपके ऐप्लिकेशन को एक नेटिव ऑब्जेक्ट मिलता है. इसमें उसकी ऐसेट होती हैं. Unity ऐप्लिकेशन, SDK के बजाय इन ऐसेट को दिखाता है.
ज़रूरी शर्तें
- Google Mobile Ads Unity प्लगिन का 7.0.0 या इसके बाद का वर्शन.
- शुरुआती निर्देश पढ़ें.
- नेटिव विज्ञापन ऐड-ऑन को डाउनलोड करें और इंस्टॉल करें.
नेटिव विज्ञापन फ़ॉर्मैट लोड करना
नेटिव विज्ञापन, AdLoader
क्लास के ज़रिए लोड किए जाते हैं. इसमें AdLoader.Builder
क्लास होती है, ताकि विज्ञापन बनाते समय इसे अपनी पसंद के मुताबिक बनाया जा सके. ForNativeAd()
मेथड, AdLoader को नेटिव विज्ञापनों को मैनेज करने के लिए कॉन्फ़िगर करता है.
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
}
AdLoader के विज्ञापन इवेंट के लिए रजिस्टर करना
जब कोई नेटिव विज्ञापन लोड हो जाता है या लोड नहीं हो पाता है, तो इसकी सूचना पाने के लिए, नीचे दिए गए इवेंट के लिए AdLoader
क्लास में डेलिगेट जोड़ें.
OnNativeAdLoaded
इस कॉलबैक को तब शुरू किया जाता है, जब नेटिव विज्ञापन लोड हो जाता है. लोड किए गए विज्ञापन को ऐक्सेस करने के लिए, इस इवेंट के लिए किसी डेलिगेट का होना ज़रूरी है.
OnAdFailedToLoad
नेटिव विज्ञापन लोड न होने पर इस फ़ंक्शन को कॉल किया जाता है.
विज्ञापन लोड करना
AdLoader
बनाने के बाद, विज्ञापन का अनुरोध करने के लिए, इसके LoadAd()
तरीके को कॉल करें:
adLoader.LoadAd(new AdRequest.Builder().Build());
विज्ञापन अनुरोध को एक साथ जोड़ना
यहां दिए गए कोड स्निपेट में, AdLoader
बनाने का तरीका बताया गया है. इसे नेटिव विज्ञापनों का अनुरोध करने के लिए कॉन्फ़िगर किया गया है. साथ ही, इसमें विज्ञापन लोड होने और लोड न होने पर, डेलिगेट सेट किए गए हैं और विज्ञापन का अनुरोध किया गया है.
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
adLoader.LoadAd(new AdRequest.Builder().Build());
}
विज्ञापन लोड न होने की समस्या हल करना
OnAdFailedToLoad
इवेंट, EventHandle<AdFailedToLoadEventArgs>
टाइप का है.
इस इवेंट से, विज्ञापन लोड न होने की वजह को पार्स करने का तरीका यहां दिखाया गया है.
private void RequestNativeAd() {
...
adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}
private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
Debug.Log("Native ad failed to load: " + args.Message);
}
नेटिव विज्ञापन दिखाना
जब कोई नेटिव विज्ञापन लोड होता है, तब उससे जुड़े विज्ञापन फ़ॉर्मैट के लिए विज्ञापन इवेंट शुरू होता है. इसके बाद, विज्ञापन दिखाने की ज़िम्मेदारी आपके ऐप्लिकेशन की होती है. हालांकि, यह ज़रूरी नहीं है कि वह विज्ञापन तुरंत दिखाए.
विज्ञापन लोड करने की प्रोसेस को मैनेज करना
OnNativeAdLoaded
इवेंट, EventHandler<NativeAdEventArgs>
टाइप का है. NativeAd
ऑब्जेक्ट में शामिल विज्ञापन को NativeAdEventArgs
से इस तरह से वापस पाया जा सकता है:
private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
}
नेटिव विज्ञापन ऐसेट वापस पाना
विज्ञापन लोड होने के बाद, उनकी ऐसेट को नीचे दिए गए तरीके से ऐक्सेस किया जा सकता है. ग्राफ़िकल ऐसेट को Texture2D
ऑब्जेक्ट के तौर पर और टेक्स्ट ऐसेट को string
ऑब्जेक्ट के तौर पर दिखाया जाता है.
private bool nativeAdLoaded;
private NativeAd nativeAd;
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for the icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
// Get string for headline asset of native ad.
string headline = this.nativeAd.GetHeadlineText();
}
}
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}
ध्यान दें कि विज्ञापन ऐसेट को सिर्फ़ मुख्य थ्रेड पर ऐक्सेस किया जाना चाहिए. उदाहरण के लिए,
Unity स्क्रिप्ट के Update()
तरीके से. यह भी ध्यान दें कि ये ऐसेट हमेशा मौजूद नहीं होती हैं. इसलिए, इन्हें दिखाने से पहले इनकी जांच कर लेनी चाहिए:
GetStarRating()
GetStore()
GetPrice()
GetAdvertiser()
GetIconTexture()
AdChoices ऐसेट
नेटिव विज्ञापन के हिस्से के तौर पर, AdChoices विज्ञापन ऐसेट को दिखाना ज़रूरी है. साथ ही, यह ज़रूरी है कि AdChoices विज्ञापन ऐसेट आसानी से दिखे. इसलिए, बैकग्राउंड के लिए सही रंग और इमेज चुनें.
विज्ञापन ऐसेट के लिए GameObjects रजिस्टर करना
अपने Unity ऐप्लिकेशन में विज्ञापन ऐसेट दिखाने के लिए, आपको GameObject
को रजिस्टर करना होगा. अगर रजिस्ट्रेशन हो जाता है, तो GameObject
को रजिस्टर करने के लिए इस्तेमाल किया गया तरीका, bool
दिखाता है. List<GameObject>
के लिए, यह तरीका int
दिखाता है. इससे पता चलता है कि GameObject
कितनी बार रजिस्टर किया गया है.
अगर विज्ञापन ऐसेट का रजिस्ट्रेशन नहीं हो पाता है, तो उससे जुड़े नेटिव विज्ञापन पर मिले इंप्रेशन और क्लिक को नहीं गिना जाएगा.
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register the icon ad asset.
}
विज्ञापन ऐसेट के लिए रजिस्टर किए गए GameObject
में, कॉन्वेक्स कोलाइडर कॉम्पोनेंट होना चाहिए. यह कॉम्पोनेंट, GameObject
के साइज़ और शेप के हिसाब से होना चाहिए. अगर विज्ञापन ऐसेट के लिए रजिस्टर किए गए GameObject
ऑब्जेक्ट में Collider
कॉम्पोनेंट मौजूद नहीं हैं या उन्हें गलत तरीके से कॉन्फ़िगर किया गया है, तो नेटिव विज्ञापन सही तरीके से काम नहीं करेंगे.
नीचे दिए गए कोड स्निपेट में, GameObject
में BoxCollider
जोड़ा गया है. यह TextMesh
का इस्तेमाल करके, नेटिव विज्ञापन की हेडलाइन वाली विज्ञापन ऐसेट दिखाता है. BoxCollider
को GameObject
से अटैच करने के बाद, यह TextMesh
कॉम्पोनेंट के टेक्स्ट के हिसाब से अपने-आप स्केल हो जाएगा.
// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;
// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;
// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();
डेमो
यहां दिए गए कोड में, यह दिखाया गया है कि लोड किए गए नेटिव विज्ञापन की आइकॉन ऐसेट को कैसे वापस पाया जाता है. साथ ही, Quad
की बनावट सेट करके आइकॉन विज्ञापन ऐसेट को कैसे दिखाया जाता है. इसके अलावा, ऐसेट दिखाने के लिए Quad
को कैसे रजिस्टर किया जाता है.GameObject
विज्ञापन की ऐसेट को वापस पाने और उसे नेटिव विज्ञापन क्लास के साथ रजिस्टर करने की इस प्रोसेस को, ऐप्लिकेशन में दिखने वाली हर ऐसेट के लिए दोहराया जाना चाहिए.
private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
icon.transform.position = new Vector3(1, 1, 1);
icon.transform.localScale = new Vector3(1, 1, 1);
icon.GetComponent<Renderer>().material.mainTexture = iconTexture;
// Register GameObject that will display icon asset of native ad.
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register ad asset.
}
}
}
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}