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

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

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

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

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

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

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

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

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

  • Google Mobile Ads Flutter Plugin का नया वर्शन.
  • [For Pangle US bidding]: Use Pangle adapter version 3.1.0 or higher.
  • Flutter फ़्रेमवर्क का वर्शन 3.7.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Flutter 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 और अडैप्टर को इंपोर्ट करना

    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: ^4.2.1

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

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

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

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

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

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

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

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

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

    ज़्यादा जानकारी के लिए, 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 Flutter मीडिएशन अडैप्टर के बदलावों का लॉग

    वर्शन 4.2.1

    वर्शन 4.2.0

    वर्शन 4.1.2

    वर्शन 4.1.1

    वर्शन 4.1.0

    वर्शन 4.0.0

    वर्शन 3.6.0

    • Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया.
    • Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
    • Pangle Android अडैप्टर के 7.9.1.3.0 वर्शन के साथ काम करता है.
    • इसमें Pangle iOS अडैप्टर के 7.9.0.8.0 वर्शन के साथ काम करने की सुविधा है.
    • इसे Google Mobile Ads Flutter प्लगिन के वर्शन 8.0.0 के साथ बनाया और टेस्ट किया गया है.

    वर्शन 3.5.3

    वर्शन 3.5.2

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

    वर्शन 3.5.1

    वर्शन 3.5.0

    वर्शन 3.4.0

    वर्शन 3.3.0

    वर्शन 3.2.1

    वर्शन 3.2.0

    वर्शन 3.1.1

    वर्शन 3.1.0

    वर्शन 3.0.0

    वर्शन 2.2.0

    वर्शन 2.1.0

    वर्शन 2.0.0

    वर्शन 1.1.0

    वर्शन 1.0.0