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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

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

1 Meta Audience Network ने 2021 में, सिर्फ़ बिडिंग की सुविधा शुरू की थी.

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

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

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

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

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

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

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

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

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

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

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

    Android

    iOS

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

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

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

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

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

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

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

    Meta Audience Network के लिए app-ads.txt लागू करने के लिए, app-ads.txt की मदद से, अनुमति वाले सेलर की पहचान करना लेख पढ़ें.

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

    Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में Edit > Project Settings > Package Manager चुनें.

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

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries को चुनें.

    Unity Registries

    Google Mobile Ads MetaAudienceNetwork Mediation पैकेज चुनें और Install पर क्लिक करें.

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

    Unity पैकेज

    बदलाव की जानकारी में दिए गए डाउनलोड करने के लिंक से, Meta Audience Network के लिए Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage को निकालें.

    अपने Unity प्रोजेक्ट एडिटर में, Assets > Import Package > Custom Package को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage फ़ाइल को ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

    Android

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

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

    Meta Audience Network Unity Mediation Plugin का चेंजलॉग

    वर्शन 3.20.1

    वर्शन 3.20.0

    वर्शन 3.19.0

    वर्शन 3.18.7

    वर्शन 3.18.6

    वर्शन 3.18.5

    वर्शन 3.18.4

    वर्शन 3.18.3

    वर्शन 3.18.2

    वर्शन 3.18.1

    वर्शन 3.18.0

    वर्शन 3.17.3

    वर्शन 3.17.2

    वर्शन 3.17.1

    वर्शन 3.17.0

    वर्शन 3.16.0

    वर्शन 3.15.0

    वर्शन 3.14.0

    वर्शन 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

    • प्लग इन को अपडेट किया गया है, ताकि यह इनाम वाले विज्ञापन के लिए सबके लिए उपलब्ध बीटा वर्शन वाले नए एपीआई के साथ काम कर सके.
    • यह 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 वर्शन के साथ काम करता है.