Unity Ads को मीडिएशन के साथ इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android (बीटा) Android iOS Unity Flutter

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

इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट

Unity Ads के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:

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

• Android का एपीआई लेवल 24 या इसके बाद का वर्शन

• [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Unity अडैप्टर 4.16.0.1 या इसके बाद के वर्शन का इस्तेमाल करें (नए वर्शन का इस्तेमाल करने का सुझाव दिया जाता है)

• GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

पहला चरण: Unity Ads के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

Unity Ads के लिए साइन अप करें या लॉग इन करें.

प्रोजेक्ट बनाना

Unity Ads डैशबोर्ड पर, प्रोजेक्ट पर जाएं और नया पर क्लिक करें.

फ़ॉर्म भरें और अपना प्रोजेक्ट जोड़ने के लिए, बनाएं पर क्लिक करें.

Unity Ads Monetization पर जाएं. इसके बाद, शुरू करें पर क्लिक करें.

नया प्रोजेक्ट मोडल में, मीडिएशन पार्टनर के लिए मैं मीडिएशन का इस्तेमाल करूंगा और Google AdMob को चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

विज्ञापन सेटिंग का विकल्प चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

प्लेसमेंट का सेटअप चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

फ़ॉर्म भरें. इसके बाद, प्रोजेक्ट जोड़ें पर क्लिक करें.

गेम आईडी को नोट करें.

विज्ञापन यूनिट और प्लेसमेंट बनाना

Unity Ads Monetization > Placements पर जाएं. इसके बाद, अपना प्रोजेक्ट चुनें और विज्ञापन यूनिट जोड़ें पर क्लिक करें.

विज्ञापन यूनिट का नाम डालें. इसके बाद, अपना प्लैटफ़ॉर्म और विज्ञापन फ़ॉर्मैट चुनें.

आखिर में, अपनी विज्ञापन यूनिट और प्लेसमेंट को सेव करने के लिए, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

Unity Ads Reporting API का पासकोड ढूंढना

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

Unity Ads के लिए app-ads.txt लागू करने के लिए, पहली बार app-ads.txt सेट अप करना लेख पढ़ें.

टेस्ट मोड को चालू करना

टेस्ट मोड को Unity Ads डैशबोर्ड से चालू किया जा सकता है. Unity Ads Monetization > Testing पर जाएं.

अपने ऐप्लिकेशन के लिए टेस्ट मोड को चालू किया जा सकता है.इसके लिए, Google Play Store के बगल में मौजूद बदलाव करें बटन पर क्लिक करें. इसके बाद, क्लाइंट के टेस्ट मोड को बदलें को चालू करें और सभी डिवाइसों के लिए टेस्ट मोड चालू करें (यानी कि टेस्ट विज्ञापनों का इस्तेमाल करें) को चुनें.

इसके अलावा, टेस्ट डिवाइस जोड़ें पर क्लिक करके, कुछ डिवाइसों के लिए टेस्ट मोड चालू किया जा सकता है.

टेस्ट डिवाइस की जानकारी डालें. इसके बाद, सेव करें पर क्लिक करें.

दूसरा चरण: AdMob के यूआई में Unity Ads की डिमांड सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Unity Ads को जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, Unity Ads को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

Unity Ads को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में मौजूद बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Unity Ads को चुनें .

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और Unity Ads के साथ बिडिंग पार्टनरशिप सेट अप करें.



स्वीकार करें और सहमति दें पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.



अगर आपने Unity Ads को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



इसके बाद, पिछले सेक्शन में मिला गेम आईडी और प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

झरना

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

Unity Ads को चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. Unity Ads के लिए विज्ञापन सोर्स ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिली एपीआई कुंजी और संगठन का मुख्य आईडी डालें. इसके बाद, Unity Ads के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.



अगर आपने Unity Ads को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिले गेम आईडी और प्लेसमेंट आईडी डालें. फिर हो गया पर क्लिक करें.

GDPR और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनर की सूची में Unity Ads को जोड़ना

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Unity Ads को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग

तीसरा चरण: Unity Ads SDK और अडैप्टर को इंपोर्ट करना

Android Studio इंटिग्रेशन (सुझाया गया)

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.16.6.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.16.6.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

मैन्युअल इंटिग्रेशन

1. Unity Ads SDK (unity-ads.aar) का नया वर्शन, उनकी GitHub रिपॉज़िटरी से डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

2. Google की मेवन रिपॉज़िटरी पर, Unity Ads अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, Unity Ads अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

चौथा चरण: Unity Ads SDK पर निजता सेटिंग लागू करना

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

एसडीके टूल के 2.0.0 वर्शन में, Unity Ads ने निजता सेटिंग के लिए एक एपीआई जोड़ा है. यहां दिए गए सैंपल कोड में, सहमति की यह जानकारी Unity Ads SDK को भेजने का तरीका बताया गया है. अगर आपको सहमति की जानकारी को Unity Ads SDK में मैन्युअल तरीके से भेजना है, तो हमारा सुझाव है कि GMA Next-Gen SDK के ज़रिए विज्ञापनों का अनुरोध करने से पहले, इस कोड को कॉल किया जाए.

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

ज़्यादा जानकारी के लिए, Unity Ads का GDPR Compliance लेख पढ़ें. साथ ही, यह भी जानें कि हर तरीके में कौनसी वैल्यू दी जा सकती हैं.

अमेरिका के राज्यों के निजता कानून

अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.

एसडीके टूल के 2.0.0 वर्शन में, Unity Ads ने निजता सेटिंग के लिए एक एपीआई जोड़ा है. यहां दिए गए सैंपल कोड में, सहमति की यह जानकारी Unity Ads SDK को भेजने का तरीका बताया गया है. अगर आपको सहमति की जानकारी को Unity Ads SDK में मैन्युअल तरीके से भेजना है, तो हमारा सुझाव है कि GMA Next-Gen SDK के ज़रिए विज्ञापनों का अनुरोध करने से पहले, इस कोड को कॉल किया जाए.

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

ज़्यादा जानकारी के लिए, Unity Ads का Consumer privacy act compliance लेख पढ़ें. साथ ही, यह भी जानें कि हर तरीके में कौनसी वैल्यू दी जा सकती हैं.

पांचवां चरण: ज़रूरी कोड जोड़ना

गतिविधि के संदर्भ के साथ विज्ञापन लोड करें

बैनर, इंटरस्टीशियल, और नेटिव विज्ञापन फ़ॉर्मैट लोड करते समय, Activity कॉन्टेक्स्ट पास करें. गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड नहीं होगा.

छठा चरण: लागू किए गए बदलावों की जांच करना

टेस्ट विज्ञापनों को चालू करना

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Unity Ads यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

टेस्ट विज्ञापनों की पुष्टि करना

यह पुष्टि करने के लिए कि आपको Unity Ads से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में Unity Ads (बिडिंग) और Unity Ads (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

गड़बड़ी के कोड

अगर अडैप्टर को Unity Ads से विज्ञापन नहीं मिलता है, तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo.getAdSourceResponses() का इस्तेमाल कर सकते हैं:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

विज्ञापन लोड न होने पर, UnityAds अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं: