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

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

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

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

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

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

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

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

    अपने myTarget खाते में लॉग इन करें. हेडर में ऐप्लिकेशन पर क्लिक करके, ऐप्लिकेशन पेज पर जाएं. ऐप्लिकेशन जोड़ें पर क्लिक करके अपना ऐप्लिकेशन जोड़ें.

    अगर आपका ऐप्लिकेशन Android और iOS, दोनों प्लैटफ़ॉर्म पर काम करता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग-अलग सेट अप करना होगा.

    Android

    इसके बाद, अपने ऐप्लिकेशन का Google Play यूआरएल दें.

    iOS

    इसके बाद, अपने ऐप्लिकेशन का iTunes यूआरएल** डालें.

    ऐप्लिकेशन जोड़ते समय, myTarget के लिए ज़रूरी है कि आप प्रोसेस पूरी करने से पहले एक विज्ञापन यूनिट बनाएं.

    उपलब्ध विज्ञापन फ़ॉर्मैट में से बैनर चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

    मध्यवर्ती

    उपलब्ध विज्ञापन फ़ॉर्मैट में से इंटरस्टीशियल चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

    इनाम दिया गया

    उपलब्ध विज्ञापन फ़ॉर्मैट में से इनाम वाला वीडियो विज्ञापन चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

    मूल भाषा वाला

    उपलब्ध विज्ञापन फ़ॉर्मैट में से नेटिव चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

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

    AdMob विज्ञापन यूनिट का आईडी सेट अप करने के लिए, आपको slot_id के साथ-साथ, myTarget के परमानेंट ऐक्सेस टोकन की भी ज़रूरत होगी. Profile टैब पर जाएं और ऐक्सेस टोकन को चुनें. अपना myTarget Permanent Access Token देखने के लिए, Create Token या Show Token पर क्लिक करें.

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

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

    myTarget के लिए app-ads.txt लागू करने के लिए, फ़ाइल बनाने और उसे पब्लिश करने का तरीका देखें.

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

    myTarget के यूज़र इंटरफ़ेस (यूआई) में, टेस्ट डिवाइस को जोड़ने और उसे कॉन्फ़िगर करने के लिए, myTarget के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

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

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

    Android

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

    iOS

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

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

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

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

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

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

    dependencies:
  gma_mediation_mytarget: ^1.15.0

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

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

    dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

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

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

    myTarget Flutter अडैप्टर का वर्शन 1.13.0 और इसके बाद के वर्शन, UMP SDK से जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा के साथ काम करते हैं. साथ ही, ये Google के अन्य सहमति वाले मोड के साथ इंटिग्रेट किए गए सहमति मैनेजमेंट प्लैटफ़ॉर्म से, myTarget SDK टूल को सहमति के सिग्नल पास करने की सुविधा के साथ भी काम करते हैं.

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

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

    Android और iOS की डेवलपर गाइड में, अमेरिका के निजता कानूनों वाला सेक्शन देखें.

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

    Android

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

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

    Android

    com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

    iOS

    GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

    Android

    गड़बड़ी का कोड कारण
    100 myTarget SDK से गड़बड़ी का मैसेज मिला.
    101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
    102 विज्ञापन का अनुरोध किया गया साइज़, myTarget के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
    103 विज्ञापन दिखाने का अनुरोध, यूनिफ़ाइड नेटिव विज्ञापन दिखाने का अनुरोध नहीं है.
    104 myTarget से लोड किया गया नेटिव विज्ञापन, अनुरोध किए गए नेटिव विज्ञापन से अलग है.
    105 myTarget से लोड किए गए नेटिव विज्ञापन में, कुछ ज़रूरी ऐसेट मौजूद नहीं हैं. जैसे, इमेज या आइकॉन.
    106 myTarget SDK, विज्ञापन नहीं दिखा सका.

    iOS

    गड़बड़ी का कोड कारण
    100 myTarget SDK के पास फ़िलहाल कोई विज्ञापन उपलब्ध नहीं है.
    101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
    102 myTarget Adapter, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
    103 myTarget का ऐसा विज्ञापन दिखाने की कोशिश की गई जो लोड नहीं हुआ है.
    104 विज्ञापन का अनुरोध किया गया साइज़, myTarget के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
    105 नेटिव विज्ञापन की ज़रूरी ऐसेट मौजूद नहीं हैं.

    myTarget Flutter मीडिएशन अडैप्टर के बदलावों का लॉग

    वर्शन 1.16.0 (डेवलेपमेंट में है)

    वर्शन 1.15.0

    वर्शन 1.14.1

    वर्शन 1.14.0

    वर्शन 1.13.0

    वर्शन 1.12.0

    वर्शन 1.11.0

    वर्शन 1.10.0

    वर्शन 1.9.0

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

    वर्शन 1.8.0

    वर्शन 1.7.1

    • Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
    • Google Mobile Ads Flutter प्लगिन के वर्शन 7.0.0 के साथ काम करने के लिए अपडेट किया गया

    वर्शन 1.7.0

    वर्शन 1.6.0

    वर्शन 1.5.0

    वर्शन 1.4.0

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0