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

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

इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, AdMob मीडिएशन की मदद से Pangle से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल और बिडिंग, दोनों तरह के इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Pangle को कैसे जोड़ा जाता है. साथ ही, किसी Android ऐप्लिकेशन में Pangle SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.

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

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

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

• Android का एपीआई लेवल 24 या इसके बाद का वर्शन

• [बिडिंग के लिए]: बिडिंग में, सभी काम करने वाले विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Pangle अडैप्टर 5.5.0.4.0 या इसके बाद के वर्शन का इस्तेमाल करें (हमारा सुझाव है कि आप नया वर्शन इस्तेमाल करें)

• नवीनतम GMA Next-Gen SDK

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

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

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

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

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

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

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

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

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

Pangle Reporting API की कुंजी ढूंढना

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

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

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

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

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

दूसरा चरण: AdMob के यूज़र इंटरफ़ेस (यूआई) में Pangle की डिमांड सेट अप करना

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Pangle को जोड़ना होगा.

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

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

Pangle को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में मौजूद बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Pangle को चुनें.

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और Pangle के साथ बिडिंग पार्टनरशिप सेट अप करें.



**स्वीकार करें और सहमति दें** पर क्लिक करें. इसके बाद, **जारी रखें** पर क्लिक करें.



अगर आपने Pangle को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



इसके बाद, पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और विज्ञापन प्लेसमेंट आईडी डालें. फिर, हो गया पर क्लिक करें.

वॉटरफ़ॉल

विज्ञापन सोर्स सेक्शन में मौजूद वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

Pangle को चुनें. इसके बाद, Pangle के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.



अगर आपने Pangle को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और विज्ञापन प्लेसमेंट आईडी डालें. फिर, हो गया पर क्लिक करें.

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

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

अपने ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pangle:7.9.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. Android के लिए Pangle SDK का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड किए गए संग्रह फ़ोल्डर से open_ad_sdk.aar को एक्सट्रैक्ट करें और इसे अपने प्रोजेक्ट में जोड़ें.

2. Google के मेवन डेटाबेस पर, Pangle अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, Pangle अडैप्टर की .aar फ़ाइल डाउनलोड करें, और इसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

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

Pangle अडैप्टर, PangleMediationAdapter.setPAConsent() तरीका उपलब्ध कराता है. इससे सहमति की जानकारी, Pangle अडैप्टर को फ़ॉरवर्ड की जाती है. इसके बाद, यह जानकारी Pangle SDK को फ़ॉरवर्ड की जाती है. यहां दिए गए सैंपल कोड में, Pangle SDK को सहमति की जानकारी भेजने का तरीका बताया गया है. सहमति की जानकारी सेट करें. इसके बाद ही, शुरू करेंGMA Next-Gen SDK , ताकि यह पक्का किया जा सके कि यह जानकारी Pangle SDK को सही तरीके से फ़ॉरवर्ड की गई है.

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

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

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

ProGuard की मदद से कोड को अस्पष्ट बनाना

अगर Android कोड को अस्पष्ट बनाने के लिए ProGuard का इस्तेमाल किया जाता है, तो Pangle के दस्तावेज़ में दिए गए निर्देशों का पालन करें. इससे यह पक्का किया जा सकेगा कि Pangle SDK का कोड अस्पष्ट न हो.

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

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

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

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

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

वैकल्पिक चरण

नेटिव विज्ञापन

विज्ञापन रेंडर करना

Pangle अडैप्टर, अपने नेटिव विज्ञापनों को NativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह इन फ़ील्ड को NativeAd के लिए भरता है.

¹ Pangle अडैप्टर, अपने नेटिव विज्ञापनों के लिए, मुख्य इमेज एसेट को सीधे तौर पर ऐक्सेस करने की सुविधा नहीं देता. इसके बजाय, अडैप्टर MediaView में कोई वीडियो या इमेज दिखाता है.

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

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

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

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