Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

Pangle US या Pangle KR के बिडिंग विज्ञापन सोर्स का इस्तेमाल करने के लिए, Pangle US और Pangle KR के लिए विज्ञापन सोर्स की मैपिंग बनाएं.

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

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

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

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

² यह फ़ॉर्मैट, Pangle के बिडिंग में हिस्सा लेने वाले इन विज्ञापन सोर्स (बिडिंग विज्ञापन सोर्स) के साथ काम नहीं करता: Pangle US.

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

जारी रखने से पहले, इनकी पुष्टि करें:

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

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

GMA Next-Gen SDK का नया वर्शन.
AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

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

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

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

बिडिंग

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

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

वॉटरफ़ॉल

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

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

Pangle Reporting API पासकोड ढूंढना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

पेज पर सबसे नीचे बाएं कोने में मौजूद यूज़र आईडी को नोट करें.

इंटिग्रेशन > SDK टूल और एपीआई > Pangle Reporting API 2.0 पर क्लिक करें. भूमिका का आईडी और सुरक्षा कुंजी नोट करें.

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 US Bidding

अहम जानकारी: Pangle US के लिए, बिडिंग में हिस्सा लेने वाला विज्ञापन सोर्स सेट अप किया जा रहा है. विज्ञापन यूनिट की यह मैपिंग सिर्फ़ Pangle US के लिए है. यह Pangle बिडिंग में हिस्सा लेने वाले अन्य विज्ञापन सोर्स को विज्ञापन के अनुरोध अपने-आप फ़ॉरवर्ड नहीं करेगी.

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Pangle US SDK टूल चुनें.
स्वीकार करें और सहमति दें को चुनें. इसके बाद, सेव करें को चुनें. ज़्यादा जानकारी के लिए, Pangle US के साथ बिडिंग की सुविधा देने वाले और सेटअप की ज़रूरत वाले विज्ञापन सोर्स लेख पढ़ें.
अगर आपने Pangle US को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें को चुनें.
पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और विज्ञापन प्लेसमेंट आईडी डालें. इसके बाद, हो गया को चुनें.

अहम जानकारी: ऐप्लिकेशन आईडी, टारगेट किए गए ऐप्लिकेशन से जुड़ा होना चाहिए, जैसा कि Pangle के यूज़र इंटरफ़ेस (यूआई) में होता है.

Pangle KR Bidding

अहम जानकारी: Pangle KR के लिए, बिडिंग विज्ञापन सोर्स सेट अप किया जा रहा है. यह विज्ञापन यूनिट मैपिंग सिर्फ़ Pangle KR के लिए है. यह विज्ञापन दिखाने के अनुरोधों को Pangle बिडिंग में हिस्सा लेने वाले अन्य विज्ञापन सोर्स को अपने-आप फ़ॉरवर्ड नहीं करेगी.

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Pangle KR SDK टूल चुनें.
स्वीकार करें और सहमति दें को चुनें. इसके बाद, सेव करें को चुनें. ज़्यादा जानकारी के लिए, Pangle KR के साथ काम करने वाले ऐसे विज्ञापन सोर्स जिनमें बिडिंग की सुविधा काम करती है और जिन्हें सेट अप करना ज़रूरी है लेख पढ़ें.
अगर आपने Pangle KR को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें को चुनें.
पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और विज्ञापन प्लेसमेंट आईडी डालें. इसके बाद, हो गया को चुनें.

अहम जानकारी: ऐप्लिकेशन आईडी को टारगेट किए गए ऐप्लिकेशन से उसी तरह से जोड़ना होगा जिस तरह से Pangle के यूज़र इंटरफ़ेस (यूआई) में जोड़ा जाता है.

Pangle ROW बिडिंग

अहम जानकारी: Pangle ROW के लिए, बिडिंग विज्ञापन सोर्स सेट अप किया जा रहा है. विज्ञापन यूनिट की यह मैपिंग सिर्फ़ Pangle ROW के लिए है. यह विज्ञापन दिखाने के अनुरोधों को, बिडिंग में हिस्सा लेने वाले Pangle के अन्य विज्ञापन सोर्स (बिडिंग विज्ञापन सोर्स) पर अपने-आप फ़ॉरवर्ड नहीं करेगी.

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Pangle ROW SDK टूल चुनें.
स्वीकार करें और सहमति दें को चुनें. इसके बाद, सेव करें को चुनें. ज़्यादा जानकारी के लिए, Pangle ROW के साथ बिडिंग की सुविधा देने वाले और सेटअप की ज़रूरत वाले विज्ञापन सोर्स देखें.
अगर आपने Pangle ROW को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें को चुनें.
पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और विज्ञापन प्लेसमेंट आईडी डालें. इसके बाद, हो गया को चुनें.

अहम जानकारी: ऐप्लिकेशन आईडी, टारगेट किए गए ऐप्लिकेशन से जुड़ा होना चाहिए, जैसा कि 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 फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:pangle:8.3.0.4.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:1.5.0'
    implementation 'com.google.ads.mediation:pangle:8.3.0.4.0'
}

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

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

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

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

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

ईयू उपयोगकर्ता की सहमति से जुड़ी 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 को सही तरीके से फ़ॉरवर्ड की गई है.

Java

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);PangleMediationSnippets.java

Kotlin

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)PangleMediationSnippets.kt

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

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

ProGuard obfuscation

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

फ़ील्ड	Pangle अडैप्टर में हमेशा शामिल की जाने वाली ऐसेट
हेडलाइन
इमेज	1
Body
आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत
विज्ञापन देने वाले लोग या कंपनियां

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

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

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

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

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

गड़बड़ी का कोड	डोमेन	वजह
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 का दस्तावेज़ देखें.