हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google Advertising and Measurement Community सर्वर में AdMob के आधिकारिक Discord चैनल से जुड़ें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

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

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

Google Mobile Ads SDK का नया वर्शन
मीडिएशन की सुविधा चालू करना शुरुआती निर्देश

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

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

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

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

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

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

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

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

बिडिंग

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

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

झरना

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

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

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

बिडिंग

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

झरना

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

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

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

Authorized Sellers for Apps 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 के लिए पहले से ही कोई मैपिंग की हुई है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

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

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

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

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

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

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

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Pangle SDK और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:pangle:7.3.0.3.0")
}

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

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

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

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

Pangle अडैप्टर, PangleMediationAdapter.setGDPRConsent() तरीका उपलब्ध कराता है. यह सहमति से जुड़ी जानकारी को Pangle अडैप्टर और फिर Pangle SDK को भेजता है. यहां दिए गए सैंपल कोड में, Pangle SDK को सहमति की जानकारी देने का तरीका बताया गया है. Google Mobile Ads SDK को लागू करने से पहले, सहमति की जानकारी सेट करें, ताकि यह जानकारी Pangle SDK को सही तरीके से भेजी जा सके.

Java

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

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT);

Kotlin

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

PangleMediationAdapter.setGDPRConsent(PAGConstant.PAGGDPRConsentType.PAG_GDPR_CONSENT_TYPE_CONSENT)

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

अमेरिका के निजता कानून

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

Pangle अडैप्टर, PangleMediationAdapter.setPAConsent() तरीका उपलब्ध कराता है. यह सहमति से जुड़ी जानकारी को Pangle अडैप्टर और फिर Pangle SDK को भेजता है. यहां दिए गए सैंपल कोड में, Pangle SDK को सहमति की जानकारी देने का तरीका बताया गया है. Google Mobile Ads SDK को लागू करने से पहले, सहमति की जानकारी सेट करें, ताकि यह जानकारी Pangle SDK को सही तरीके से भेजी जा सके.

Java

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

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

Kotlin

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

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

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

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

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