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

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

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

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

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

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

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

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

3 Pangle US (बिडिंग) इंटिग्रेशन और Pangle KR (बिडिंग) इंटिग्रेशन, चुनिंदा उपयोगकर्ताओं के लिए बीटा वर्शन में उपलब्ध है. इसका ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

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 इंस्टॉल किया है, तो Google Mobile Ads Pangle Mediation Plugin for Unity को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री में जाकर यह कमांड चलाएं:

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

OpenUPM

Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > Package Manager चुनें.

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

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

OpenUPM की जानकारी

इसके बाद, विंडो > पैकेज मैनेजर पर जाकर Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity की रजिस्ट्री

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

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

Unity पैकेज

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

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

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

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

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

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

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

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

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

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

Pangle के लिए Google Mobile Ads मीडिएशन प्लगिन में Pangle.SetPAConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, 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 बिड रिस्पॉन्स मौजूद नहीं है या अमान्य है.
-1-60000 com.pangle.ads Pangle SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Pangle का दस्तावेज़ देखें.

iOS

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

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

वर्शन 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 adapter version 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

  • Pangle क्लास से SetDoNotSell() को SetPAConsent() से बदला गया.
    • ऐसा हो सकता है कि SetDoNotSell() के लिए दी गई वैल्यू, SetPAConsent() के लिए सही वैल्यू न हो. कृपया पक्का करें कि SetPAConsent() एट्रिब्यूट के लिए सही वैल्यू दी गई हो. PA की सहमति के लिए कौनसी वैल्यू सेट की जा सकती हैं, इसके लिए 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 Plugin के 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

Version 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 adapter version 5.0.0.7.0 के साथ काम करता है.
  • Pangle iOS adapter version 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

  • Pangle क्लास में इन तरीकों के नाम बदले गए हैं:
    • SetGDPR() -> SetGDPRConsent()
    • SetCCPA() -> SetDoNotSell()
  • Pangle Android adapter version 4.7.0.5.0 के साथ काम करता है.
  • Pangle iOS adapter version 4.7.0.5.0 के साथ काम करता है.
  • इसे Google Mobile Ads Unity Plugin के 7.2.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.0