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

इस गाइड में बताया गया है कि 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 के ज़रिए इंटिग्रेशन

    (सिर्फ़ Android के लिए) अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifactory.bidmachine.io/bidmachine")
      }
  }

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

    dependencies:
  gma_mediation_bidmachine: ^1.5.1

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

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

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

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

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

    BidMachine Flutter अडैप्टर का वर्शन 1.0.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल BidMachine SDK टूल को भेज सकते हैं. ये सिग्नल, IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट किए गए सहमति मैनेजमेंट प्लैटफ़ॉर्म से भेजे जाते हैं. ज़्यादा जानकारी के लिए, BidMachine के Android और iOS जीडीपीआर दस्तावेज़ देखें.

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

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

    BidMachine, कंसेंट मैनेजमेंट प्लैटफ़ॉर्म से सेट की गई GPP सहमति को अपने-आप पढ़ लेता है. इसमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए BidMachine की GPP गाइड देखें.

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

    Android

    BidMachine को इंटिग्रेट करने के लिए, किसी अतिरिक्त कोड की ज़रूरत नहीं है.

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

    संस्‍करण 1.5.1

    वर्शन 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 अडैप्टर के 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