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

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

इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, Unity Ads से विज्ञापन लोड करने और दिखाने के लिए, मीडिएशन का इस्तेमाल कैसे किया जाता है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन भी शामिल है. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में 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 फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

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

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

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

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

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

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

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

अपने Ad Manager खाते में साइन इन करें.

कंपनियों में Unity Ads जोड़ना

सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा चालू करना

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

Unity Ads बिडिंग को कॉन्फ़िगर करना

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

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

Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 कॉन्टेक्स्ट पास करें. गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड नहीं होगा.

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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 अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं: