BidMachine को मध्यस्थता के साथ इंटिग्रेट करना

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

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

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

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

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

1 वॉटरफ़ॉल इंटिग्रेशन, चुनिंदा उपयोगकर्ताओं के लिए बीटा वर्शन में उपलब्ध है. ऐक्सेस पाने के लिए अपने खाता मैनेजर से संपर्क करें.

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

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

  • Google Mobile Ads Flutter Plugin का नया वर्शन.
  • Flutter फ़्रेमवर्क का वर्शन 3.7.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • AdMob मीडिएशन सेट अप करें.

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

BidMachine खाते के डैशबोर्ड में लॉग इन करें.

नए प्लेसमेंट बनाना

सोर्स टैब पर जाएं. इसके बाद, सोर्स टेबल में जाकर, बदलाव करें बटन को चुनें.

सोर्स डैशबोर्ड

आपको अपने सभी प्लेसमेंट की सूची दिखेगी. नया प्लेसमेंट बनाने के लिए, डायलॉग बॉक्स में मौजूद प्लेसमेंट जोड़ें बटन पर क्लिक करें.

सोर्स में बदलाव करने का डायलॉग

प्लेसमेंट टाइप के तौर पर बिडिंग चुनें. फ़ॉर्म भरें और सेव करें पर क्लिक करें.

Android

Android प्लेसमेंट बनाना

iOS

iOS प्लेसमेंट बनाना

आखिर में, प्लेसमेंट आईडी को नोट कर लें.

Android

Android प्लेसमेंट की जानकारी

iOS

iOS प्लेसमेंट की जानकारी

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

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

BidMachine के लिए app-ads.txt लागू करने के लिए, डैशबोर्ड में जाकर app-ads.txt टैब पर जाएं. इसके बाद, सूची को कॉपी करें और उसे अपनी वेबसाइट की app-ads.txt फ़ाइल में जोड़ें.

दूसरा चरण: AdMob के यूआई में BidMachine की डिमांड सेट अप करना

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

Android

निर्देशों के लिए, Android के लिए गाइड में दिया गया दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.

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

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

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

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

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

dependencies:
  gma_mediation_bidmachine: ^1.5.0

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

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

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, SKAdNetwork Support के बारे में BidMachine का दस्तावेज़ पढ़ें.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

BidMachine के लिए टेस्ट मोड चालू करने के लिए, BidMachine के दस्तावेज़ में दिए गए निर्देशों का पालन करें. ये निर्देश Android और iOS के लिए दिए गए हैं.

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

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

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

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

Android

io.bidmachine
com.google.ads.mediation.bidmachine

iOS

GADMediationAdapterBidMachine

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

Android

गड़बड़ी का कोड डोमेन कारण
100 com.google.ads.mediation.bidmachine अमान्य या खाली प्लेसमेंट आईडी मिला है.
101 com.google.ads.mediation.bidmachine सिग्नल इकट्ठा करने के दौरान गड़बड़ी: सिग्नल डेटा कॉन्फ़िगरेशन नहीं मिला.
102 com.google.ads.mediation.bidmachine सिग्नल इकट्ठा करने के दौरान, अमान्य विज्ञापन फ़ॉर्मैट मिला.
103 com.google.ads.mediation.bidmachine विज्ञापन के अनुरोध किए गए साइज़ को bidmachine.BannerSize पर मैप नहीं किया जा सका
104 com.google.ads.mediation.bidmachine लोड की गई BidMachine की विज्ञापन दिखाने के अनुरोध की समयसीमा खत्म हो गई है.
105 com.google.ads.mediation.bidmachine फ़ुलस्क्रीन विज्ञापन नहीं दिखाया जा सका.
106 com.google.ads.mediation.bidmachine BidMachine SDK ने null विज्ञापन डेटा के साथ onAdLoaded() कॉलबैक दिखाया.

iOS

गड़बड़ी का कोड डोमेन वजह
101 com.google.mediation.bidmachine सर्वर कॉन्फ़िगरेशन में ज़रूरी पब्लिशर आईडी मौजूद नहीं है.
102 com.google.mediation.bidmachine बिडिंग सिग्नल इकट्ठा करने का अनुरोध पूरा नहीं हुआ. इसकी वजह यह है कि आरटीबी पैरामीटर में विज्ञापन फ़ॉर्मैट शामिल नहीं है या बताया गया फ़ॉर्मैट काम नहीं करता.
103 com.google.mediation.bidmachine विज्ञापन लोड करने के लिए, विज्ञापन कॉन्फ़िगरेशन अमान्य है.
104 com.google.mediation.bidmachine BidMachine SDK ने बैनर विज्ञापन के BidMachineAdProtocol didLoadAd डेलिगेट तरीके को नॉन-बैनर विज्ञापन दिखाया. ऐसा कभी नहीं होना चाहिए.
105 com.google.mediation.bidmachine फ़ुलस्क्रीन विज्ञापन, प्रज़ेंटेशन के लिए तैयार नहीं है.
106 com.google.mediation.bidmachine Bid Machine SDK ने नेटिव विज्ञापन के BidMachineAdProtocol didLoadAd डेलिगेट तरीके को नॉन-नेटिव विज्ञापन दिखाया. ऐसा कभी नहीं होना चाहिए.
107 com.google.mediation.bidmachine नेटिव विज्ञापन की इमेज के किसी सोर्स को लोड नहीं किया जा सका.
108 com.google.mediation.bidmachine BidMachine, इस बैनर विज्ञापन के साइज़ के साथ काम नहीं करता.

BidMachine Flutter Mediation Adapter के बदलावों की जानकारी

वर्शन 1.5.0

वर्शन 1.4.2

वर्शन 1.4.1

वर्शन 1.4.0

वर्शन 1.3.2

  • Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया
  • Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
  • BidMachine Android adapter version 3.6.1.0 के साथ काम करता है.
  • BidMachine iOS अडैप्टर के 3.6.0.0 वर्शन के साथ काम करता है.
  • इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.1

वर्शन 1.3.0

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.0