Meta Audience Network को बिडिंग के साथ इंटिग्रेट करना

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल  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 के टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में ज़्यादा जानकारी के लिए, Testing 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

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

Meta Audience Network के लिए, Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लग इन फ़ोल्डर (और उसके कॉन्टेंट) को अपने 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 से टेस्ट विज्ञापन मिल रहे हैं या नहीं, Meta Audience Network (बिडिंग) विज्ञापन स्रोत का इस्तेमाल करके, Ad Inspector में विज्ञापन के किसी एक स्रोत की जांच करने की सुविधा चालू करें.

वैकल्पिक चरण

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 Meta Audience Network ने SDK से जुड़ी गड़बड़ी का मैसेज दिखाया. ज़्यादा जानकारी के लिए, Meta Audience Network का दस्तावेज़ देखें.

Meta Audience Network Flutter मीडिएशन अडैप्टर का बदलावों का इतिहास

अगला वर्शन

  • 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

  • होस्ट प्लैटफ़ॉर्म के साथ काम करने की क्षमता का सही विश्लेषण करने के लिए, Dart क्लास जोड़ी गई
  • 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 की मदद से बनाया और टेस्ट किया गया है.