Ad Manager पब्लिशर के पास, ऐसेट की कस्टम सूचियां तय करके, अपने नेटिव विज्ञापन फ़ॉर्मैट बनाने का विकल्प होता है. इन्हें कस्टम नेटिव विज्ञापन फ़ॉर्मैट कहा जाता है. इनका इस्तेमाल, रिज़र्व किए गए विज्ञापनों के साथ किया जा सकता है. कस्टम नेटिव विज्ञापनों की मदद से, पब्लिशर अपने ऐप्लिकेशन में आर्बिट्रेरी इमेज और स्ट्रिंग डेटा पास कर सकते हैं. इस डेटा को CustomNativeAd ऑब्जेक्ट से दिखाया जाता है.
कस्टम नेटिव विज्ञापन लोड करना
कस्टम नेटिव विज्ञापन, AdLoader ऑब्जेक्ट का इस्तेमाल करके लोड किए जाते हैं. ForCustomNativeAd()
मेथड, AdLoader को कॉन्फ़िगर करता है, ताकि कस्टम नेटिव विज्ञापनों को मैनेज किया जा सके. इस तरीके के लिए
दो पैरामीटर हैं:
- कस्टमाइज़ किए गए विज्ञापन का
formatId, जिसके लिएAdLoaderको अनुरोध करना चाहिए. हर कस्टम नेटिव विज्ञापन फ़ॉर्मैट के साथ, एक फ़ॉर्मैट आईडी वैल्यू जुड़ी होती है. यह पैरामीटर बताता है कि आपका ऐप्लिकेशन,AdLoaderसे किस फ़ॉर्मैट में अनुरोध करना चाहता है. - जब उपयोगकर्ता विज्ञापन पर क्लिक करता है, तब
Action<CustomNativeAd, string>को कॉल किया जाता है. हालांकि, यह ज़रूरी नहीं है.
कस्टम नेटिव विज्ञापन, AdLoader क्लास के ज़रिए लोड किए जाते हैं. इसमें अपनी AdLoader.Builder क्लास होती है, ताकि विज्ञापन बनाते समय उसे पसंद के मुताबिक बनाया जा सके. ForCustomNativeAd() तरीका, नेटिव विज्ञापनों को मैनेज करने के लिए AdLoader को कॉन्फ़िगर करता है.
void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.ForCustomNativeAd("10063170")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
एक विज्ञापन यूनिट को एक से ज़्यादा कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाने के लिए सेट अप किया जा सकता है. इसलिए, ForCustomNativeAd() को अलग-अलग फ़ॉर्मैट आईडी के साथ कई बार कॉल किया जा सकता है. इससे विज्ञापन लोडर को एक से ज़्यादा संभावित कस्टम नेटिव विज्ञापन फ़ॉर्मैट के लिए तैयार किया जा सकता है.
कस्टम नेटिव विज्ञापन इवेंट
AdLoader क्लास, EventHandler टाइप के विज्ञापन इवेंट उपलब्ध कराती है. इससे आपको कस्टम नेटिव विज्ञापन के लाइफ़साइकल के बारे में सूचना मिलती है. यहां दिए गए उदाहरण में, विज्ञापन लोडर पर कस्टम नेटिव विज्ञापन इवेंट के लिए रजिस्टर करने का तरीका बताया गया है:
private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
HandleCustomNativeAdLoaded() वाले तरीके में, CustomNativeAdEventArgs पैरामीटर शामिल होता है. लोड किए गए कस्टम नेटिव विज्ञापन को इस इवेंट पैरामीटर की मदद से ऐक्सेस किया जा सकता है, जैसा कि यहां दिखाया गया है:
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
this.customNativeAd = args.nativeAd;
}
HandleCustomNativeAdFailedToLoad() वाले तरीके में, AdFailedToLoadEventArgs पैरामीटर शामिल है. गड़बड़ी का मैसेज ऐक्सेस करने के लिए, LoadAdError फ़ील्ड पर GetMessage तरीके को कॉल करें. इसके बारे में यहां बताया गया है:
void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
string message = args.LoadAdError.GetMessage();
Debug.Log("Ad Loader fail event received with message: " + message);
}
कस्टम नेटिव विज्ञापन फ़ॉर्मैट दिखाना
कस्टम नेटिव विज्ञापनों में, उपयोगकर्ता के तय किए गए इमेज और टेक्स्ट ऐसेट की संख्या की कोई सीमा नहीं होती. इन ऐसेट को CustomNativeAd क्लास के ज़रिए ऐक्सेस किया जाता है. यह क्लास, GetTexture2D() और GetText() तरीके उपलब्ध कराती है. ये तरीके, फ़ॉर्मैट फ़ील्ड के वैरिएबल आईडी को पैरामीटर के तौर पर लेते हैं.
यहां कस्टम नेटिव विज्ञापन से ऐसेट ऐक्सेस करने का उदाहरण दिया गया है:
private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...
void Update()
{
if(adLoaded)
{
mainImageTexture = customNativeAd.GetTexture2D("MainImage");
headline = customNativeAd.GetText("Headline");
adLoaded = false;
}
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
customNativeAd = args.nativeAd;
adLoaded = true;
...
}
कस्टम नेटिव विज्ञापन के इंप्रेशन और क्लिक मैनेज करना
कस्टम नेटिव विज्ञापन के मामले में, आपका ऐप्लिकेशन इंप्रेशन रिकॉर्ड करने और SDK टूल को क्लिक इवेंट की रिपोर्ट करने के लिए ज़िम्मेदार होता है.
इंप्रेशन रिकॉर्ड करना
कस्टम विज्ञापन के लिए इंप्रेशन रिकॉर्ड करने के लिए, उससे जुड़े CustomNativeAd पर RecordImpression() तरीके को कॉल करें:
customNativeAd.RecordImpression();
क्लिक की रिपोर्ट करना
SDK टूल को यह रिपोर्ट करने के लिए कि किसी ऐसेट पर क्लिक किया गया है, उससे जुड़े CustomNativeAd पर PerformClick() मेथड को कॉल करें. साथ ही, उस ऐसेट का नाम पास करें जिस पर क्लिक किया गया था. उदाहरण के लिए, अगर आपके कस्टम फ़ॉर्मैट में "MainImage" नाम की कोई ऐसेट है और आपको उस ऐसेट से जुड़े टेक्सचर पर हुए क्लिक की रिपोर्ट करनी है, तो आपका कोड कुछ ऐसा दिखेगा:
customNativeAd.PerformClick("MainImage");
कस्टम क्लिक ऐक्शन का जवाब देना
जब कस्टम विज्ञापन पर क्लिक की रिपोर्ट की जाती है, तो SDK टूल से मिलने वाले संभावित जवाबों को इस क्रम में आज़माया जाता है:
विज्ञापन के डीप लिंक यूआरएल के लिए, कॉन्टेंट रिज़ॉल्वर का पता लगाएं और पहले वाले को शुरू करें, जो रिज़ॉल्व करता है.
कोई ब्राउज़र खोलें और विज्ञापन के सामान्य डेस्टिनेशन यूआरएल पर जाएं.
अगर आपको कस्टम नेटिव विज्ञापन फ़ॉर्मैट के लिए, क्लिक ऐक्शन को खुद मैनेज करना है, तो AdLoader.Builder.ForCustomNativeAd() तरीके में वैकल्पिक Action<CustomNativeAd, string> दें. ऐसा करने पर, उपयोगकर्ता को डीप लिंक या वेब ब्राउज़र पर नहीं ले जाया जाएगा. कस्टम क्लिक ऐक्शन सेट करने पर, एसडीके के क्लिक करने के तरीके को बदला जा सकता है. यहां एक उदाहरण दिया गया है, जिसमें किसी ऐसेट के लिए क्लिक को लॉग करने के लिए, कस्टम क्लिक ऐक्शन का इस्तेमाल किया गया है:
private void LoadCustomNativeAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
.Build();
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.LoadAd(createAdRequest());
}
private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}