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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल  1
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
इनाम वाले इंटरस्टीशियल विज्ञापन

1 Meta Audience Network, 2021 में सिर्फ़ बिडिंग के तौर पर काम करने लगा.

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

  • Google Mobile Ads SDK का सबसे नया वर्शन
  • Unity 5.6 या इसके बाद का वर्शन
  • Meta Audience Network 2.11.0 के लिए Google Mobile Ads मीडिएशन प्लग इन (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिवाइस पर 10.0 या इसके बाद का डिप्लॉयमेंट टारगेट
    • आम तौर पर, Meta Audience Network के नए SDK टूल के लिए, Xcode के नए वर्शन की ज़रूरत होती है.
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया एक चालू Unity प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन की शुरुआती निर्देशों वाली गाइड को पूरा करें

पहला चरण: Meta Audience Network के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

साइन अप करें और Business Manager के स्टार्ट पेज पर लॉग इन करें.

शुरू करें पर क्लिक करने के बाद, नया खाता बनाएं पर क्लिक करें.

ज़रूरी फ़ील्ड में अपने कारोबार की जानकारी भरें और आगे बढ़ें पर क्लिक करें.

प्रॉपर्टी बनाना

ज़रूरी जानकारी भरने के बाद, आपसे अपने ऐप्लिकेशन के लिए एक प्रॉपर्टी बनाने के लिए कहा जाएगा. अपने ऐप्लिकेशन के लिए प्रॉपर्टी का मनमुताबिक नाम डालें और आगे बढ़ें पर क्लिक करें.

इसके बाद, कमाई करने के लिए अपना प्लैटफ़ॉर्म चुनें.

अपने ऐप्लिकेशन की जानकारी जोड़ें और आगे बढ़ें पर क्लिक करें.

Android

iOS

पेमेंट का नया खाता जोड़ें पर क्लिक करके, अपना पेमेंट खाता सेट अप करें. क्रेडिट/डेबिट कार्ड की जानकारी डालने के लिए, आपको एक नए पेज पर रीडायरेक्ट किया जाएगा. ज़रूरी जानकारी भरें, फिर आगे बढ़ें पर क्लिक करें.

मीडिएशन प्लैटफ़ॉर्म के तौर पर Google AdMob चुनें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.

कोई फ़ॉर्मैट चुनें, फ़ॉर्म भरें, और बनाएं पर क्लिक करें.

प्लेसमेंट आईडी को नोट करें.

हो गया पर क्लिक करें.

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

Meta Audience Network के टेस्ट विज्ञापनों को चालू करने के बारे में ज़्यादा जानकारी के लिए, Audience Network को लागू करने की जांच करने के लिए गाइड देखें.

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

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

तीसरा चरण: Meta Audience Network SDK टूल और अडैप्टर इंपोर्ट करना

OpenUPM-CLI

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads Meta Audience Network मीडिएशन प्लग इन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

Unity पैकेज मैनेजर की सेटिंग खोलने के लिए, अपने Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

स्कोप वाली रजिस्ट्री टैब में, OpenUPM को स्कोप वाली रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

इसके बाद, Unity Package Manager खोलने के लिए, विंडो > पैकेज मैनेजर पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity रजिस्ट्री

Google Mobile Ads Meta Audience Network Mediation पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करना

Unity पैकेज

Changelog में दिए गए डाउनलोड लिंक से Meta Audience Network के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन का सबसे नया वर्शन डाउनलोड करें और ZIP फ़ाइल से GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage एक्सट्रैक्ट करें.

अपने Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें और वह GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage फ़ाइल ढूंढें जिसे आपने डाउनलोड किया है. पक्का करें कि सभी फ़ाइलें चुनी गई हों और इंपोर्ट करें पर क्लिक करें.

Unity से इंपोर्ट करें

इसके बाद, ऐसेट > एक्सटर्नल डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > ज़बरदस्ती रिज़ॉल्व करें चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को फिर से शुरू से हल करेगी और बताई गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

ज़बरदस्ती ठीक करें

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

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

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

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

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

कैलिफ़ोर्निया के उपयोगकर्ताओं के लिए, Meta के डेटा प्रोसेसिंग के विकल्प देखें.

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

Android

Meta Audience Network इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.

iOS

SKAdNetwork इंटिग्रेशन

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

विज्ञापन ट्रैकिंग की सुविधा चालू हो

अगर आपको iOS 14 या इसके बाद के वर्शन के लिए ऐप्लिकेशन बनाना है, तो Meta Audience Network के विज्ञापन ट्रैकिंग फ़्लैग सेट करने का तरीका जानने के लिए, Meta Audience Network के निर्देश देखें.

छठा चरण: लागू करने की जांच करना

वैकल्पिक चरण

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 मेटा ऑडियंस नेटवर्क ने 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 का दस्तावेज़ देखें.

Meta Audience Network के Unity मीडिएशन प्लग इन में हुए बदलावों का लॉग

3.13.1 वर्शन

वर्शन 3.13.0

3.12.2 वर्शन

3.12.1 वर्शन

3.12.0 वर्शन

वर्शन 3.11.0

3.10.0 वर्शन

3.9.1 वर्शन

वर्शन 3.9.0

3.8.0 वर्शन

वर्शन 3.7.0

3.6.1 वर्शन

वर्शन 3.6.0

वर्शन 3.5.0

3.4.0 वर्शन

3.3.2 वर्शन

वर्शन 3.3.1

3.3.0 वर्शन

3.2.0 वर्शन

3.1.0 वर्शन

3.0.0 वर्शन

वर्शन 2.12.0

वर्शन 2.11.1

वर्शन 2.11.0

वर्शन 2.10.0

वर्शन 2.9.2

वर्शन 2.9.1

वर्शन 2.9.0

वर्शन 2.8.1

वर्शन 2.8.0

वर्शन 2.7.1 (अब काम नहीं करता, 2.8.0 या इसके बाद के वर्शन का इस्तेमाल करें)

2.7.0 वर्शन (अब काम नहीं करता, 2.8.0 या इसके बाद के वर्शन का इस्तेमाल करें)

2.6.1 वर्शन (अब काम नहीं करता, 2.8.0 या इसके बाद के वर्शन का इस्तेमाल करें)

वर्शन 2.6.0

वर्शन 2.5.1

  • Facebook के Android अडैप्टर के 5.5.0.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 5.5.1.0 वर्शन के साथ काम करता है.

वर्शन 2.5.0

  • Facebook के Android अडैप्टर के 5.5.0.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 5.5.0.0 वर्शन के साथ काम करता है.

वर्शन 2.4.1

  • Facebook Android अडैप्टर के वर्शन 5.4.1.1 के साथ काम करता है.
  • Facebook iOS अडैप्टर के 5.4.0.0 वर्शन के साथ काम करता है.

वर्शन 2.4.0

  • यह Facebook के Android अडैप्टर के 5.4.0.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के वर्शन 5.4.0.0 पर काम करता है.

वर्शन 2.3.2

  • यह Facebook के Android अडैप्टर के 5.3.1.2 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के वर्शन 5.3.2.0 पर काम करता है.

वर्शन 2.3.1

  • यह Facebook के Android अडैप्टर के 5.3.1.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 5.3.2.0 वर्शन के साथ काम करता है.

वर्शन 2.3.0

  • यह Facebook के Android अडैप्टर के 5.3.0.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 5.3.0.0 वर्शन के साथ काम करता है.

वर्शन 2.2.0

  • नए ओपन-बीटा Rewarded API के साथ काम करने के लिए, प्लगिन को अपडेट किया गया.
  • Facebook Android अडैप्टर के वर्शन 5.2.0.1 के साथ काम करता है.
  • यह Facebook iOS अडैप्टर के 5.2.0.1 वर्शन के साथ काम करता है.

वर्शन 2.1.1

  • यह Facebook के Android अडैप्टर के 5.1.0.1 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के वर्शन 5.1.0.0 पर काम करता है.

वर्शन 2.1.0

  • यह Facebook के Android अडैप्टर के 5.1.0.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के वर्शन 5.1.0.0 पर काम करता है.

वर्शन 2.0.0

  • यह Facebook के Android अडैप्टर के 5.0.1.0 वर्शन के साथ काम करता है.
  • यह Facebook iOS अडैप्टर के 5.0.1.0 वर्शन के साथ काम करता है.

वर्शन 1.2.1

  • Facebook Android अडैप्टर के 4.99.3.0 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 4.99.3.0 वर्शन के साथ काम करता है.

वर्शन 1.2.0

  • Facebook Android अडैप्टर के 4.99.1.1 वर्शन के साथ काम करता है.
  • Facebook iOS अडैप्टर के 4.99.2.0 वर्शन के साथ काम करता है.

वर्शन 1.1.3

  • Facebook Android अडैप्टर के 4.28.2.1 वर्शन के साथ काम करता है.
  • यह Facebook के iOS अडैप्टर के 4.28.1.2 वर्शन के साथ काम करता है.

वर्शन 1.1.2

  • Unity Ads के Unity मीडिएशन प्लग इन से होने वाली संभावित समस्या को ठीक किया गया.

वर्शन 1.1.1

  • Facebook के Android अडैप्टर के 4.28.2.0 वर्शन के साथ काम करता है.
  • यह Facebook iOS अडैप्टर के 4.28.1.1 वर्शन के साथ काम करता है.

वर्शन 1.1.0

  • यह Facebook के Android SDK टूल के 4.28.1 वर्शन के साथ काम करता है.
  • Facebook iOS SDK के 4.28.1 वर्शन के साथ काम करता है.

वर्शन 1.0.0

  • पहली रिलीज़!
  • यह Facebook Android SDK टूल के 4.27.0 वर्शन के साथ काम करता है.
  • यह Facebook iOS SDK टूल के 4.27.1 वर्शन के साथ काम करता है.