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

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

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

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

इंटिग्रेशन
बिडिंग
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया

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

  • Google Mobile Ads SDK का नया वर्शन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • Unity 4 या इसके बाद का वर्शन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
  • Google के साथ कॉन्फ़िगर किया गया Unity काम कर रहा प्रोजेक्ट मोबाइल विज्ञापन SDK टूल. यहां जाएं: ज़्यादा जानकारी के लिए, शुरू करें.
  • मध्यस्थता की प्रक्रिया पूरी करें शुरुआती निर्देश

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

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

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

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

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

कमाई करना पर जाएं > शुरू करें. इसके बाद, शुरू करें पर क्लिक करें.

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

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

फ़ॉर्म भरें, फिर प्रोजेक्ट जोड़ें पर क्लिक करें.

गेम आईडी को ध्यान में रखें.

विज्ञापन यूनिट बनाना

कमाई करना पर जाएं > विज्ञापन यूनिट चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

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

Android

iOS

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

प्लेसमेंट जोड़ें

प्रोजेक्ट बनाने के बाद, कमाई करना > प्लेसमेंट. यहां की यात्रा पर हूं नया प्लेसमेंट बनाएं और अपनी विज्ञापन यूनिट के लिए प्लेसमेंट जोड़ें पर क्लिक करें.

ज़रूरी जानकारी भरें और प्लेसमेंट जोड़ें पर क्लिक करें.

प्लेसमेंट आईडी का ध्यान रखें.

Unity Ads Reporting API कुंजी खोजें

बिडिंग

बिडिंग इंटिग्रेशन के लिए, ऐसा करना ज़रूरी नहीं है.

झरना

गेम आईडी और प्लेसमेंट आईडी के अलावा, आपको अपने Unity Ads API Key और Organization कोर आईडी: Ad Manager विज्ञापन यूनिट का आईडी.

कमाई करना > सेटअप > एपीआई मैनेजमेंट और नोट करना में से monetization आंकड़े API ऐक्सेस कुंजी में से.

इसके बाद, कमाई करना > संगठन सेटिंग और नोट लें संगठन का कोर आईडी है.

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

परीक्षण मोड को यहां से सक्षम किया जा सकता है: Unity Ads का डैशबोर्ड. आपके प्रोजेक्ट के सेटिंग में, टेस्टिंग टैब चुनें.

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

Android

iOS

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

फ़ॉर्म भरें और सेव करें पर क्लिक करें.

दूसरा चरण: यूज़र इंटरफ़ेस (यूआई) में Ad Manager Unity Ads की मांग सेट अप करें

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

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

Unity Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन का सबसे नया वर्शन डाउनलोड करें डाउनलोड लिंक से Changelog और एक्सट्रैक्ट करें zip फ़ाइल से GoogleMobileAdsUnityAdsMediation.unitypackage.

Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > अपने हिसाब से चुनी गई रेंज पैकेज और GoogleMobileAdsUnityAdsMediation.unitypackage फ़ाइल चुनें डाउनलोड किया है. पक्का करें कि सभी फ़ाइलें चुनी गई हैं और फिर इंपोर्ट करें पर क्लिक करें.

इसके बाद, ऐसेट > Play services का रिज़ॉल्वर > Android रिज़ॉल्वर > बल समस्या हल करें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी इस्तेमाल करेगी रिज़ॉल्यूशन को रीसेट करें और घोषित डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री.

यूनिटी विज्ञापन सेवाओं के साथ यूनिटी अडैप्टर का इस्तेमाल करना

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

Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml फ़ाइल को अपडेट करें और Unity Ads SDK टूल की डिपेंडेंसी हटाएं:

<!-- If using the Unity Ads Service from Unity3D, comment out this dependency to
avoid including the Unity Ads Android SDK twice. -->
<androidPackage spec="com.unity3d.ads:unity-ads:x.y.z">
  <repositories>
    <repository>https://repo.maven.apache.org/maven2/</repository>
  </repositories>
</androidPackage>

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

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

Unity Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वर्शन 3.3.0 इसमें यह शामिल है UnityAds.SetConsentMetaData() तरीका. नीचे दिया गया सैंपल कोड यह बताता है कि सहमति की जानकारी कैसे Unity Ads SDK टूल. अगर इस तरीके को कॉल करना है, तो हमारा सुझाव है कि इसलिए, यह ज़रूरी है कि आप Google Mobile Ads SDK से विज्ञापनों का अनुरोध करें.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

Unity के लिए विज्ञापन देखें Privacy Consent and Data API और जीडीपीआर का पालन करना गाइड देखें.

अमेरिका के निजता कानून

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

Unity Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वर्शन 3.3.0 इसमें यह शामिल है UnityAds.SetConsentMetaData() तरीका. नीचे दिया गया सैंपल कोड यह बताता है कि सहमति की जानकारी कैसे Unity Ads SDK टूल. अगर इस तरीके को कॉल करना है, तो हमारा सुझाव है कि इसलिए, यह ज़रूरी है कि आप Google Mobile Ads SDK से विज्ञापनों का अनुरोध करें.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

Unity के लिए विज्ञापन देखें Privacy Consent and Data API और सीसीपीए का पालन करना गाइड देखें.

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

Android

Unity Ads के Android इंटिग्रेशन के लिए, किसी अतिरिक्त कोड की ज़रूरत नहीं होती.

iOS

SKAdNetwork इंटिग्रेशन

Unity Ads' को फ़ॉलो करें दस्तावेज़ अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए.

गड़बड़ियों को कंपाइल करें

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

छठा चरण: लागू होने की जांच करना

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

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

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

यह पुष्टि करने के लिए कि Unity Adsसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, Unity Ads (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

गड़बड़ी कोड

अगर अडैप्टर को Unity Ads से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर में मौजूद गड़बड़ी ResponseInfo ये क्लास:

Android

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

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Android

गड़बड़ी का कोड कारण
0-10 UnityAds SDK टूल में कोई गड़बड़ी मिली है. कोड देखें देखें.
101 AdMob के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए UnityAds सर्वर के पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102 UnityAds ने NO_FILL की स्थिति में एक प्लेसमेंट दिखाया.
103 UnityAds का प्लेसमेंट बंद किया गया, लेकिन इसकी स्थिति 'बंद है' पर सेट की गई.
104 UnityAds ने एक ऐसा विज्ञापन दिखाने की कोशिश की जिसमें शून्य कॉन्टेक्स्ट है.
105 Unity Ads से विज्ञापनों को शुरू करने, लोड करने, और/या दिखाने के लिए इस्तेमाल किया जाने वाला कॉन्टेक्स्ट, ऐक्टिविटी इंस्टेंस नहीं है.
106 UnityAds ने एक ऐसा विज्ञापन दिखाने की कोशिश की जो दिखाए जाने के लिए तैयार नहीं है.
107 इस डिवाइस पर UnityAds का इस्तेमाल नहीं किया जा सकता.
108 UnityAds, हर प्लेसमेंट के लिए एक बार में सिर्फ़ एक विज्ञापन लोड कर सकता है.
109 UnityAds में गड़बड़ी की स्थिति दिखी.
200-204 UnityAds बैनर में दिखने वाली गड़बड़ी. कोड देखें देखें.

iOS

0-9 UnityAds SDK टूल में कोई गड़बड़ी मिली है. Unity का दस्तावेज़ देखें देखें.
101 AdMob के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए UnityAds सर्वर के पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102 यह डिवाइस UnityAds पर काम नहीं करता.
103 UnityAds की स्क्रीन पर गड़बड़ी की स्थिति kUnityAdsFinishStateError के साथ पूरी हुई.
104 Unity विज्ञापन ऑब्जेक्ट को शुरू करने वाले टूल को कॉल करने के बाद, यह शून्य हो जाता है.
105 विज्ञापन तैयार नहीं है, इसलिए Unity विज्ञापन नहीं दिखाया जा सका.
106 UnityAds का नाम एक ऐसे प्लेसमेंट को बदलने वाला कॉलबैक है जिसकी प्लेसमेंट स्थिति kUnityAdsplacementStateNoFill में किया गया है.
107 UnityAds का नाम एक ऐसे प्लेसमेंट को बदलने वाला कॉलबैक है जिसकी प्लेसमेंट स्थिति kUnityAdsplacementDisplayd पर नहीं.
108 इस प्लेसमेंट के लिए एक विज्ञापन पहले ही लोड किया जा चुका है. UnityAds SDK टूल, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड नहीं करता.

Unity Ads के लिए यूनिटी मीडिएशन प्लगिन में बदलाव का लॉग

वर्शन अगला

  • DummyClient का नाम बदलकर PlaceholderClient किया गया.

वर्शन 3.12.1

वर्शन 3.12.0

वर्शन 3.11.1

वर्शन 3.11.0

वर्शन 3.10.0

वर्शन 3.9.1

वर्शन 3.9.0

वर्शन 3.8.0

वर्शन 3.7.1

वर्शन 3.7.0

वर्शन 3.6.1

वर्शन 3.6.0

  • अडैप्टर का कॉन्टेंट GoogleMobileAds/Mediation/UnityAds/ में ले जाया गया.
  • GoogleMobileAds.Mediation.UnityAds का इस्तेमाल करने के लिए, अडैप्टर नेमस्पेस को रीफ़ैक्टर किया गया.
  • Unity Ads Android अडैप्टर के वर्शन 4.6.0.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 4.6.0.0 पर काम करता है.
  • Google Mobile Ads Unity प्लगिन के वर्शन 7.4.1 की मदद से, इसे बनाया और टेस्ट किया गया है.

वर्शन 3.5.0

वर्शन 3.4.1

वर्शन 3.4.0

वर्शन 3.3.0

वर्शन 3.2.1

वर्शन 3.2.0

वर्शन 3.1.0

वर्शन 3.0.1

वर्शन 3.0.0

वर्शन 2.7.2

वर्शन 2.7.1

वर्शन 2.7.0

वर्शन 2.6.0

वर्शन 2.5.1

वर्शन 2.5.0

वर्शन 2.4.7

वर्शन 2.4.6

वर्शन 2.4.5

वर्शन 2.4.4

वर्शन 2.4.3

वर्शन 2.4.2

वर्शन 2.4.1

वर्शन 2.4.0

वर्शन 2.3.0

वर्शन 2.2.0

वर्शन 2.1.0

  • Unity Ads के Android अडैप्टर के वर्शन 3.1.0.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 3.1.0.0 के साथ काम करता है.

वर्शन 2.0.3

  • नए ओपन-बीटा Rewarded API के साथ काम करने के लिए, प्लगिन को अपडेट किया गया.
  • बैनर विज्ञापनों के लिए सहायता जोड़ता है.
  • Unity Ads के Android अडैप्टर के वर्शन 3.0.0.2 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 3.0.0.3 के साथ काम करता है.

वर्शन 2.0.2

  • Unity Ads के Android अडैप्टर के वर्शन 3.0.0.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 3.0.0.1 के साथ काम करता है.

वर्शन 2.0.1

  • "असुरक्षित रूप से काम न करने वाला टाइप" ठीक किया गया गड़बड़ी हुई, जिसकी वजह से iOS के लिए ऐप्लिकेशन बनाते समय समस्याएं हुईं.

वर्शन 2.0.0

  • Unity Ads के Android अडैप्टर के वर्शन 3.0.0.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 3.0.0.0 के साथ काम करता है.

वर्शन 1.2.0

  • Unity Ads के Android अडैप्टर के वर्शन 2.3.0.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 2.3.0.0 के साथ काम करता है.

वर्शन 1.1.3

  • Unity Ads के Android अडैप्टर के वर्शन 2.2.1.0 के साथ काम करता है.
  • Unity Ads के iOS अडैप्टर के वर्शन 2.2.1.0 के साथ काम किया जा सकता है.

वर्शन 1.1.2

  • Unity Ads Android SDK के 2.2.0 वर्शन के साथ काम किया जा सकता है.
  • Unity Ads के iOS SDK टूल के वर्शन 2.2.0 के साथ काम किया जा सकता है.
  • टारगेट किए गए विज्ञापन के लिए, उपयोगकर्ता ऑप्ट-इन का मैन्युअल तरीके से अनुरोध करने के लिए, UnityAds.SetGdprConsentMetaData() तरीका जोड़ा गया.

वर्शन 1.1.1

  • Unity Ads Android SDK के 2.2.0 वर्शन के साथ काम किया जा सकता है.
  • Unity Ads के iOS SDK टूल के वर्शन 2.2.1 के साथ काम किया जा सकता है.

वर्शन 1.1.0

  • Unity Ads Android SDK के 2.2.0 वर्शन के साथ काम किया जा सकता है.
  • Unity Ads के iOS SDK टूल के वर्शन 2.2.0 के साथ काम किया जा सकता है.

वर्शन 1.0.0

  • पहली रिलीज़!
  • Unity Ads Android SDK के वर्शन 2.1.2 के साथ काम किया जा सकता है.
  • Unity Ads के iOS SDK टूल के वर्शन 2.1.2 के साथ काम किया जा सकता है.