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

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

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

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

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

इंटिग्रेशन
बिडिंग  1
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना  2
बैनर  2
मध्यवर्ती
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला  2

1 Pangle बिडिंग में हिस्सा लेने वाले विज्ञापन सोर्स में, Pangle US, Pangle KR, और Pangle ROW शामिल हैं.

2 यह फ़ॉर्मैट, Pangle बिडिंग ऐड सोर्स के लिए काम नहीं करता: Pangle US.

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

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • [अमेरिका में Pangle बिडिंग के लिए]: Pangle अडैप्टर का वर्शन 5.1.0 या इसके बाद का वर्शन इस्तेमाल करें.
  • Unity Editor का वर्शन 5.6 या इसके बाद का वर्शन.
  • [Pangle KR बिडिंग और Pangle ROW बिडिंग के लिए]: बिडिंग में, काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Pangle 2.4.0 या इसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लग इन का इस्तेमाल करें. हमारा सुझाव है कि आप नया वर्शन इस्तेमाल करें.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, सेट अप करना Google Mobile Ads Unity Plugin लेख पढ़ें.
  • मीडिएशन सेट अप करें.

    • पहला चरण: Pangle के यूआई में कॉन्फ़िगरेशन सेट अप करना

    अपने Pangle खाते में साइन अप या लॉग इन करें.

    नया ऐप्लिकेशन जोड़ना

    ऐप्लिकेशन टैब पर जाएं और ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

    वह ऑपरेटिंग सिस्टम चुनें जिसके लिए आपको ऐप्लिकेशन बनाना है. इसके बाद, बाकी फ़ॉर्म भरें. इसके बाद, सबमिट करें पर क्लिक करें.

    Android

    iOS

    अपने ऐप्लिकेशन का ऐप्लिकेशन आईडी नोट करें.

    Android

    iOS

    विज्ञापन प्लेसमेंट बनाना

    ऐप्लिकेशन बन जाने के बाद, विज्ञापन प्लेसमेंट बनाने के लिए Add बटन पर क्लिक करें.

    Android

    iOS

    बिडिंग

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

    विज्ञापन प्लेसमेंट बनाने के बाद, विज्ञापन प्लेसमेंट आईडी नोट कर लें.

    Android

    iOS

    वॉटरफ़ॉल

    अपना विज्ञापन फ़ॉर्मैट और विज्ञापन प्लेसमेंट का नाम चुनें. इसके बाद, कीमत का टाइप के तौर पर ग्लोबल सीपीएम चुनें. फ़ॉर्म में बाकी जानकारी भरें और सबमिट करें पर क्लिक करें.

    विज्ञापन प्लेसमेंट बनाने के बाद, विज्ञापन प्लेसमेंट आईडी नोट कर लें.

    Android

    iOS

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

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

    Pangle के लिए app-ads.txt लागू करने के लिए, Pangle को अपनी app-ads.txt फ़ाइल में जोड़ने का तरीका देखें.

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

    Pangle के टेस्ट विज्ञापनों को चालू करने के लिए, Pangle की टेस्ट विज्ञापन जोड़ने का तरीका गाइड में दिए गए निर्देशों का पालन करें.

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

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

    Android

    निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.

    iOS

    निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.

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

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

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

    OpenUPM-CLI

    अगर आपके पास OpenUPM-CLI इंस्टॉल है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads Pangle मीडिएशन प्लग इन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

    openupm add com.google.ads.mobile.mediation.pangle

    OpenUPM

    अपने Unity प्रोजेक्ट एडिटर में, Edit > Project Settings > Package Manager को चुनें. इससे Unity Package Manager Settings खुल जाएंगी.

    Scoped Registries टैब में जाकर, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो. इसके लिए, यह जानकारी डालें:

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries चुनें.

    Unity Registries

    Google Mobile Ads Pangle Mediation पैकेज चुनें और Install पर क्लिक करें.

    OpenUPM से इंस्टॉल करना

    Unity पैकेज

    बदलाव की जानकारी में दिए गए डाउनलोड करने के लिंक से, Pangle के लिए Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsPangleMediation.unitypackage को निकालें.

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

    Unity से इंपोर्ट करना

    इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

    ज़बरदस्ती हल करें

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

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

    Pangle Unity अडैप्टर के वर्शन 5.9.0 और इसके बाद के वर्शन में, Pangle जीडीपीआर के तहत ली गई सहमति को अपने-आप पढ़ लेता है. यह सहमति, उन कंसेंट मैनेजमेंट प्लैटफ़ॉर्म से सेट की जाती है जो Google की अतिरिक्त सहमति से जुड़ी खास जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है.

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

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

    यहां दिए गए सैंपल कोड में, Pangle SDK को सहमति की जानकारी देने का तरीका बताया गया है. सहमति की जानकारी सेट करें. इसके बाद ही, शुरू करें Google Mobile Ads Unity Plugin, ताकि यह पक्का किया जा सके कि यह जानकारी Pangle SDK को सही तरीके से फ़ॉरवर्ड की गई है.

    using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

    ज़्यादा जानकारी के लिए, Pangle की इंटिग्रेशन गाइड देखें. साथ ही, यह भी जानें कि हर तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

    Android

    Pangle इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

    Android

    com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

    iOS

    GADMediationAdapterPangle

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

    Android

    गड़बड़ी का कोड डोमेन वजह
    101 com.google.ads.mediation.pangle सर्वर के पैरामीटर अमान्य हैं. जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी मौजूद नहीं है.
    102 com.google.ads.mediation.pangle विज्ञापन का अनुरोध किया गया साइज़, Pangle के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
    103 com.google.ads.mediation.pangle Pangle SDK, नाबालिग उपयोगकर्ताओं के लिए काम नहीं करता.
    -1-60000 com.pangle.ads Pangle SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Pangle का दस्तावेज़ देखें.

    iOS

    गड़बड़ी का कोड डोमेन वजह
    101 com.google.mediation.pangle अमान्य सर्वर पैरामीटर (जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी मौजूद नहीं है).
    102 com.google.mediation.pangle विज्ञापन का अनुरोध किया गया साइज़, Pangle के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
    104 com.google.mediation.pangle Pangle SDK, नाबालिग उपयोगकर्ताओं के लिए काम नहीं करता.
    -1-60000 Pangle SDK टूल ने भेजा Pangle SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Pangle का दस्तावेज़ देखें.

    Pangle Unity Mediation Plugin के बदलावों का लॉग

    वर्शन 7.2.2 (डेवलेपमेंट में है)

    वर्शन 7.2.1

    वर्शन 7.2.0

    वर्शन 7.1.1

    वर्शन 7.1.0

    वर्शन 7.0.0 (रोल बैक किया गया)

    वर्शन 6.0.1

    वर्शन 6.0.0

    वर्शन 5.9.2

    वर्शन 5.9.1

    वर्शन 5.9.0

    • Pangle क्लास से SetGDPRConsent() तरीके को बंद कर दिया गया है. Pangle SDK अब सहमति को अपने-आप मैनेज करता है.
      • यह तरीका अब काम नहीं करता और इसे आने वाली रिलीज़ में हटा दिया जाएगा.
    • Pangle Android अडैप्टर के 7.9.1.1.0 वर्शन के साथ काम करता है.
    • Pangle iOS अडैप्टर के 7.9.0.6.0 वर्शन के साथ काम करता है.
    • इसे Google Mobile Ads Unity प्लगिन के वर्शन 11.0.0 के साथ बनाया और टेस्ट किया गया है.

    वर्शन 5.8.5

    वर्शन 5.8.4

    वर्शन 5.8.3

    वर्शन 5.8.2

    वर्शन 5.8.1

    वर्शन 5.8.0

    वर्शन 5.7.1

    वर्शन 5.7.0

    वर्शन 5.6.0

    वर्शन 5.5.3

    वर्शन 5.5.2

    वर्शन 5.5.1

    वर्शन 5.5.0

    वर्शन 5.4.0

    वर्शन 5.3.0

    वर्शन 5.2.2

    वर्शन 5.2.1

    वर्शन 5.2.0

    वर्शन 5.1.1

    वर्शन 5.1.0

    वर्शन 5.0.0

    • SetDoNotSell() को Pangle क्लास के SetPAConsent() से बदला गया.
      • SetDoNotSell() के लिए पास की गई वैल्यू, SetPAConsent() के लिए सही वैल्यू नहीं हो सकती. कृपया पक्का करें कि SetPAConsent() में सही वैल्यू डाली गई हो. पीए की सहमति के लिए कौनसी वैल्यू सेट की जा सकती हैं, यह जानने के लिए https://www.pangleglobal.com/integration/android-initialize-pangle-sdk पर जाएं.
    • Pangle Android अडैप्टर के वर्शन 7.1.0.8.0 के साथ काम करता है.
    • Pangle iOS अडैप्टर के 7.1.1.1.0 वर्शन के साथ काम करता है.
    • इसे Google Mobile Ads Unity प्लगिन के 10.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

    वर्शन 4.6.2

    वर्शन 4.6.1

    वर्शन 4.6.0

    वर्शन 4.5.4

    वर्शन 4.5.3

    वर्शन 4.5.2

    वर्शन 4.5.1

    वर्शन 4.5.0

    वर्शन 4.4.2

    वर्शन 4.4.1

    वर्शन 4.4.0

    वर्शन 4.3.3

    वर्शन 4.3.2

    वर्शन 4.3.1

    वर्शन 4.3.0

    वर्शन 4.2.1

    वर्शन 4.2.0

    वर्शन 4.1.0

    वर्शन 4.0.1

    वर्शन 4.0.0

    वर्शन 3.0.0

    वर्शन 2.8.1

    वर्शन 2.8.0

    वर्शन 2.7.0

    वर्शन 2.6.0

    वर्शन 2.5.0

    वर्शन 2.4.0

    वर्शन 2.3.0

    वर्शन 2.2.0

    वर्शन 2.1.0

    वर्शन 2.0.0

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

    वर्शन 1.5.1

    वर्शन 1.5.0

    वर्शन 1.4.0

    वर्शन 1.3.1

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0