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 API (एपीआई) लेवल 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 के टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में ज़्यादा जानकारी के लिए, ऑडियंस नेटवर्क को लागू करने की गाइड देखें.

दूसरा चरण: Meta Audience Network की मांग को AdMob यूज़र इंटरफ़ेस (यूआई) में सेट अप करना

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

Android

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

iOS

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

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

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

तीसरा चरण: 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 ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति का विकल्प अपने-आप नहीं भेज सकता.

जीडीपीआर और मेटा विज्ञापन के बारे में जानकारी के लिए, Meta के दिशा-निर्देश देखें.

अमेरिका के निजता कानून

अमेरिका के निजता कानून उपयोगकर्ताओं को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" को "बेचने" से ऑप्ट आउट कर सकें (जैसा कि कानून में उन शर्तों के बारे में बताया गया है). साथ ही, "बिक्री" पार्टी के होम पेज पर "मेरी निजी जानकारी न बेचें" लिंक से, "मेरी निजी जानकारी न बेचें" विकल्प से ऑप्ट-आउट करने का अधिकार देना ज़रूरी है. अमेरिका के निजता कानून के पालन से जुड़ी गाइड में, 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 इंटिग्रेशन के लिए लागू नहीं.

गड़बड़ी कोड

अगर अडैप्टर को ऑडियंस नेटवर्क से कोई विज्ञापन नहीं मिलता है, तो नीचे दी गई क्लास में 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 नेटवर्क ने 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 नेटवर्क ने SDK टूल से जुड़ी गड़बड़ी का मैसेज दिखाया. ज़्यादा जानकारी के लिए, Meta Audience Network के दस्तावेज़ देखें.

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

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 वर्शन के साथ बनाया और टेस्ट किया गया.