निजी ओवरले विज्ञापन

अपनी प्रोफ़ाइल बनाना शुरू करें

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

नेटिव ओवरले विज्ञापन, मीडिएशन और वीडियो विज्ञापनों के साथ काम करते हैं. यह नेटिव विज्ञापनों के मुकाबले, नेटिव ओवरले विज्ञापनों का एक मुख्य फ़ायदा है.

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

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

• शुरुआती निर्देशों की गाइड को पूरा करें.
• Unity प्लग इन 9.0.0 या इसके बाद का वर्शन.

हमेशा टेस्ट विज्ञापनों की मदद से जांच करें

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

हालांकि, Ad Manager के वेब इंटरफ़ेस में ऐप्लिकेशन रजिस्टर करने और अपने ऐप्लिकेशन में इस्तेमाल करने के लिए विज्ञापन यूनिट आईडी बनाने के बाद, डेवलपमेंट के दौरान अपने डिवाइस को टेस्ट डिवाइस के तौर पर कॉन्फ़िगर करें.

/21775744923/example/native

नेटिव ओवरले विज्ञापन लोड करना

नेटिव ओवरले विज्ञापन को लोड करने के लिए, NativeOverlayAd क्लास पर स्टैटिक Load() तरीके का इस्तेमाल किया जाता है. लोड किया गया NativeOverlayAd ऑब्जेक्ट, पूरी होने के हैंडलर में पैरामीटर के तौर पर दिया जाता है.

नीचे दिया गया कोड, विज्ञापन लोड करने के लिए NativeOverlayAd का इस्तेमाल करता है:

// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/example/native";



private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

नेटिव ओवरले विज्ञापन को रेंडर करना और उसे स्टाइल देना

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

TemplateID एक ज़रूरी स्ट्रिंग है, जो नेटिव ओवरले विज्ञापन को रेंडर करने के लिए इस्तेमाल किए गए नेटिव टेंप्लेट के बारे में बताती है. अपने विज्ञापन के लिए सही नेटिव टेंप्लेट चुनने के लिए, NativeTemplateID कॉन्स्टेंट का इस्तेमाल करें.

नीचे दिया गया कोड, मीडियम टेंप्लेट और पसंद के मुताबिक स्टाइल के साथ नेटिव ओवरले विज्ञापन को रेंडर करता है.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

नेटिव ओवरले विज्ञापन दिखाना और छिपाना

नीचे दिए गए कोड में, लोड किए गए नेटिव ओवरले विज्ञापन को दिखाने का तरीका बताया गया है.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

नेटिव ओवरले विज्ञापन छिपाना

यहां दिए गए कोड में, नेटिव ओवरले विज्ञापन को छिपाने का तरीका बताया गया है.

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

नेटिव ओवरले विज्ञापन को हटाना

नेटिव ओवरले विज्ञापन का इस्तेमाल करने के बाद, संसाधनों को रिलीज़ करने के लिए Destroy() को कॉल करना न भूलें.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}