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

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

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

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

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

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

• Google Mobile Ads Flutter Plugin पर अपलोड हुआ नया वीडियो
• Flutter 3.7.0 या इसके बाद का वर्शन
• [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Pangle 2.4.0 या इसके बाद के वर्शन के लिए Google Mobile Ads mediation plugin का इस्तेमाल करें (नए वर्शन का सुझाव दिया जाता है)
• Android पर डिप्लॉय करने के लिए
  • Android का एपीआई लेवल 23 या इसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का वर्शन होना चाहिए
• Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Flutter Plugin सेट अप करना लेख पढ़ें.
• मीडिएशन सेट अप करें.

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

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

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

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

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

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

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

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

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 की डिमांड सेट अप करना

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

(सिर्फ़ Android के लिए) अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

अपने पैकेज की pubspec.yaml फ़ाइल में, Pangle SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_pangle: ^3.5.2

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

Pangle के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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

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

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

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

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

Pangle.SetGDPRConsent(0);

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

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

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

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

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

Pangle.SetPAConsent(0);

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

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

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

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

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

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

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

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

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

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

GADMediationAdapterPangle

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

Pangle Flutter Mediation Adapter के बदलावों का लॉग

वर्शन 3.5.2

• Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
• Google Mobile Ads Flutter Plugin के 7.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
• Pangle Android अडैप्टर 7.8.0.8.0 के साथ काम करता है.
• Pangle iOS अडैप्टर के 7.8.0.6.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.5.1

• Pangle Android अडैप्टर 7.8.0.8.0 के साथ काम करता है.
• Pangle iOS अडैप्टर वर्शन 7.8.0.5.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.5.0

• Pangle Android अडैप्टर वर्शन 7.8.0.7.0 के साथ काम करता है.
• Pangle iOS अडैप्टर वर्शन 7.8.0.3.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.4.0

• Pangle Android adapter version 7.7.0.2.0 के साथ काम करता है.
• Pangle iOS अडैप्टर के वर्शन 7.7.0.5.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.3.0

• Pangle Android अडैप्टर वर्शन 7.6.0.4.0 के साथ काम करता है.
• Pangle iOS अडैप्टर वर्शन 7.6.0.5.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.2.1

• Pangle Android अडैप्टर 7.3.0.5.0 के साथ काम करता है.
• Pangle iOS अडैप्टर के 7.4.1.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.2.0

• Pangle Android अडैप्टर वर्शन 7.3.0.4.0 के साथ काम करता है.
• Pangle iOS अडैप्टर के 7.4.0.9.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.1.1

• Pangle Android adapter version 7.2.0.6.0 के साथ काम करता है.
• Pangle iOS adapter version 7.2.0.5.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.1.0

• Pangle Android अडैप्टर 7.2.0.4.0 के साथ काम करता है.
• Pangle iOS adapter version 7.2.0.4.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.0.0

• Pangle Android अडैप्टर के 7.1.0.8.0 वर्शन के साथ काम करता है.
• Pangle iOS अडैप्टर के वर्शन 7.1.1.1.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.2.0

• Pangle Android adapter version 6.5.0.8.0 के साथ काम करता है.
• Pangle iOS adapter version 6.5.0.9.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.1.0

• Pangle Android अडैप्टर 6.5.0.4.1 के साथ काम करता है.
• Pangle iOS adapter version 6.5.0.8.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.0.0

• Pangle Android अडैप्टर वर्शन 6.4.0.6.0 के साथ काम करता है.
• Pangle iOS अडैप्टर के 6.4.1.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 5.3.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.0

• Pangle Android अडैप्टर 5.9.0.4.0 के साथ काम करता है.
• Pangle iOS अडैप्टर 5.9.0.7.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• शुरुआती रिलीज़.
• Pangle Android अडैप्टर वर्शन 5.8.0.9.0 के साथ काम करता है.
• Pangle iOS adapter version 5.8.0.8.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 5.0.1 वर्शन के साथ बनाया और टेस्ट किया गया है.