इस गाइड में आपको मीडिएशन की मदद से, Meta Audience Network से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK के इस्तेमाल का तरीका बताया गया है. इसमें बिडिंग इंटिग्रेशन के बारे में भी बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Meta Audience Network को जोड़ने का तरीका बताया गया है. साथ ही, Meta Audience Network और एडेप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Meta Audience Network के लिए, AdMob मीडिएशन अडैप्टर में ये काम किए जा सकते हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
वॉटरफ़ॉल 1 | |
फ़ॉर्मैट | |
बैनर | |
मध्यवर्ती | |
इनाम दिया गया | |
इनाम वाला इंटरस्टीशियल विज्ञापन |
1 Meta Audience Network, 2021 में सिर्फ़ बिडिंग के तौर पर उपलब्ध हुआ.
ज़रूरी शर्तें
- Google Mobile Ads SDK का नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिवाइस पर 10.0 या इसके बाद का डिप्लॉयमेंट टारगेट
- आम तौर पर, Meta Audience Network के नए SDK टूल के लिए, Xcode के नए वर्शन की ज़रूरत होती है.
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया एक चालू Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मध्यस्थता को पूरा करें शुरुआती निर्देश
पहला चरण: Meta Audience Network के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
Business Manager के शुरुआती पेज पर साइन अप करें और लॉग इन करें.
शुरू करें पर क्लिक करने के बाद, नया खाता बनाएं पर क्लिक करें.
अपने कारोबार की जानकारी के साथ ज़रूरी फ़ील्ड भरें और आगे बढ़ें पर क्लिक करें.
प्रॉपर्टी बनाना
ज़रूरी जानकारी भरने के बाद, आपको अपने ऐप्लिकेशन के लिए प्रॉपर्टी बनाने के लिए कहा जाएगा. अपने ऐप्लिकेशन के लिए प्रॉपर्टी का मनचाहा नाम डालें और आगे बढ़ें पर क्लिक करें.
इसके बाद, कमाई करने के लिए अपना प्लैटफ़ॉर्म चुनें.
अपने ऐप्लिकेशन के बारे में जानकारी जोड़ें और आगे बढ़ें पर क्लिक करें.
Android
iOS
नया पेमेंट खाता जोड़ें पर क्लिक करके, अपना पेमेंट खाता सेट अप करें. पेमेंट की जानकारी डालने के लिए, आपको एक नए पेज पर रीडायरेक्ट किया जाएगा. ज़रूरी जानकारी भरें, फिर आगे बढ़ें पर क्लिक करें.
मीडिएशन प्लैटफ़ॉर्म के तौर पर Google AdMob चुनें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.
कोई फ़ॉर्मैट चुनें, फ़ॉर्म भरें, और बनाएं पर क्लिक करें.
प्लेसमेंट आईडी को नोट करें.
हो गया पर क्लिक करें.
टेस्ट मोड चालू करना
Meta Audience Network के टेस्ट विज्ञापनों को चालू करने के बारे में ज़्यादा जानकारी के लिए, Audience Network को लागू करने की जांच करने के लिए गाइड देखें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में Meta Audience Network की मांग सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Facebook जोड़ें
AdMob के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Meta जोड़ने के लिए, जीडीपीआर सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: Meta Audience Network SDK टूल और अडैप्टर इंपोर्ट करना
pub.dev की मदद से इंटिग्रेशन
अपने पैकेज की pubspec.yaml
फ़ाइल में,Meta Audience Network SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_meta: ^1.0.0
मैन्युअल इंटिग्रेशन
इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें
Meta Audience Network,
डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें
(और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने
pubspec.yaml
फ़ाइल में यह डिपेंडेंसी जोड़कर:
dependencies:
gma_mediation_meta:
path: path/to/local/package
चौथा चरण: Meta Audience Network SDK टूल पर निजता सेटिंग लागू करना
ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं को कुछ जानकारी दी गई हो और उनसे सहमति ली गई हो. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति लेते समय, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा को इकट्ठा, हासिल या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क पर उपयोगकर्ता की सहमति की जानकारी अपने-आप नहीं भेज सकता.
जीडीपीआर और मेटा विज्ञापन के बारे में जानकारी पाने के लिए, मेटा के दिशा-निर्देश देखें.
अमेरिका के निजता कानून
अमेरिका के निजता कानून लोगों को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" (जैसा कि कानून में बताया गया है) को "बिक्री" से ऑप्ट आउट करने का विकल्प दें. साथ ही, "बिक्री" करने वाली पार्टी के होम पेज पर मौजूद, "मेरी निजी जानकारी न बेचें" लिंक से ऑप्ट-आउट करें. अमेरिका के निजता कानूनों के पालन से जुड़ी गाइड, Google विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा देती है. हालांकि, Google आपकी मीडिएशन चेन के हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकता है. साथ ही, नीति का पालन करने के लिए, उन सभी नेटवर्क के दिशा-निर्देशों का पालन करना होगा.
कैलिफ़ोर्निया के उपयोगकर्ताओं के लिए, Meta के डेटा प्रोसेसिंग के विकल्प देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
Meta Audience Network इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist
फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Meta Audience Network के दस्तावेज़ को अपनाएं.
विज्ञापन ट्रैकिंग चालू की गई
अगर iOS 14 या इसके बाद के वर्शन के लिए ऐप्लिकेशन बनाया जा रहा है, तो Meta Audience Network के विज्ञापन ट्रैकिंग फ़्लैग को सेट करने का तरीका जानें.
छठा चरण: लागू करने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और Meta Audience Network यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. AdMob
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि Meta Audience Networkसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, Meta Audience Network (Bidding) विज्ञापन सोर्स का इस्तेमाल करें.
वैकल्पिक चरण
Android 9 पर कैश मेमोरी में सेव करना
Android
Android 9 (एपीआई लेवल 28) में, क्लियरटेक्स्ट सहायता की सुविधा डिफ़ॉल्ट रूप से बंद रहती है. इससे Meta Audience Network SDK टूल की मीडिया कैश मेमोरी में डेटा सेव करने की सुविधा पर असर पड़ेगा. साथ ही, उपयोगकर्ता अनुभव और विज्ञापन से मिलने वाले रेवेन्यू पर भी असर पड़ सकता है. अपने ऐप्लिकेशन में नेटवर्क की सुरक्षा से जुड़े कॉन्फ़िगरेशन को अपडेट करने के लिए, Meta के दस्तावेज़ में दिए गए निर्देशों का पालन करें.
iOS
यह सुविधा, iOS इंटिग्रेशन के लिए लागू नहीं होती है.
गड़बड़ी कोड
अगर अडैप्टर को Audience Network से विज्ञापन नहीं मिलता है, तो ResponseInfo
का इस्तेमाल करके इस गड़बड़ी की जांच करें. इसके लिए, इन क्लास के तहत जाएं:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
जब कोई विज्ञापन लोड नहीं होता, तो Meta Audience Network अडैप्टर से ये कोड और मैसेज मिलते हैं:
Android
गड़बड़ी का कोड | कारण |
---|---|
101 | अमान्य सर्वर पैरामीटर (उदाहरण के लिए, प्लेसमेंट आईडी मौजूद नहीं है). |
102 | विज्ञापन का जिस साइज़ का अनुरोध किया गया है वह Meta Audience Network में काम करने वाले बैनर साइज़ से मेल नहीं खाता. |
103 | पब्लिशर को Activity संदर्भ वाले विज्ञापनों का अनुरोध करना होगा. |
104 | Meta Audience Network SDK टूल शुरू नहीं हो सका. |
105 | पब्लिशर ने यूनिफ़ाइड नेटिव विज्ञापनों के लिए अनुरोध नहीं किया है. |
106 | लोड किया गया नेटिव विज्ञापन, उम्मीद से अलग ऑब्जेक्ट है. |
107 | इस्तेमाल किया गया Context ऑब्जेक्ट अमान्य है. |
108 | लोड किए गए विज्ञापन में ज़रूरी नेटिव विज्ञापन एसेट मौजूद नहीं हैं. |
109 | बोली पेलोड से नेटिव विज्ञापन नहीं बनाया जा सका. |
110 | Meta Audience Network SDK टूल, इंटरस्टीशियल/इनाम वाला विज्ञापन नहीं दिखा सका. |
111 | Meta Audience Network AdView ऑब्जेक्ट बनाते समय अपवाद मिला. |
1000-9999 | Meta Audience Network ने SDK से जुड़ी गड़बड़ी का मैसेज दिखाया. ज़्यादा जानकारी के लिए, Meta Audience Network का दस्तावेज़ देखें. |
iOS
गड़बड़ी का कोड | कारण |
---|---|
101 | अमान्य सर्वर पैरामीटर (उदाहरण के लिए, प्लेसमेंट आईडी मौजूद नहीं है). |
102 | विज्ञापन का जिस साइज़ का अनुरोध किया गया है वह Meta Audience Network में काम करने वाले बैनर साइज़ से मेल नहीं खाता. |
103 | Meta Audience Network विज्ञापन ऑब्जेक्ट को शुरू नहीं किया जा सका. |
104 | Meta Audience Network SDK टूल, इंटरस्टीशियल/इनाम वाला विज्ञापन नहीं दिखा सका. |
105 | बैनर विज्ञापन का रूट व्यू कंट्रोलर nil है. |
106 | Meta Audience Network SDK टूल को शुरू नहीं किया जा सका. |
1000-9999 | मेटा ऑडियंस नेटवर्क ने SDK टूल से जुड़ी गड़बड़ी दिखाई. ज़्यादा जानकारी के लिए, Meta Audience Network का दस्तावेज़ देखें. |
मेटा ऑडियंस नेटवर्क फ़्लटर मीडिएशन अडैप्टर चेंजलॉग
अगला वर्शन
- Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.
1.1.0
- Meta के Android अडैप्टर के 6.17.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
- Meta iOS अडैप्टर के वर्शन 6.15.2.0 के साथ काम करने की पुष्टि की गई
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.
1.0.1
- होस्ट प्लैटफ़ॉर्म के साथ सही तरीके से काम करने के विश्लेषण की अनुमति देने के लिए, डार्ट क्लास जोड़ी गई
- Meta के Android अडैप्टर के 6.17.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
- Meta iOS अडैप्टर के वर्शन 6.15.0.0 के साथ काम करने की पुष्टि की गई है
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.
1.0.0
- शुरुआती रिलीज़.
- इस बात की पुष्टि की गई है कि यह Meta Android अडैप्टर के 6.17.0.0 वर्शन के साथ काम करता है या नहीं
- Meta iOS अडैप्टर के वर्शन 6.15.0.0 के साथ काम करने की पुष्टि की गई है
- Google Mobile Ads Flutter प्लग इन के 5.0.0 वर्शन के साथ बनाया और टेस्ट किया गया.