शुरू करें

इस गाइड में Unity ऐप्लिकेशन में AdMob के नेटिव विज्ञापनों को लागू करने के लिए, नेटिव विज्ञापनों के ऐड-ऑन का इस्तेमाल करने का तरीका बताया गया है. साथ ही, इसमें कुछ ज़रूरी बातों का भी ध्यान रखा गया है.

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

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

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

नेटिव विज्ञापन फ़ॉर्मैट लोड करें

नेटिव विज्ञापन, 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 का इस्तेमाल करता है. GameObject से BoxCollider के जुड़ने के बाद, यह 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 का टेक्सचर सेट करके, आइकॉन वाली विज्ञापन ऐसेट को कैसे दिखाया जा सकता है, और ऐसेट को दिखाने के लिए 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;
}