इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

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

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

Android एपीआई लेवल 21 या उसके बाद का वर्शन

Meta Audience Network अडैप्टर 5.10.0.0 या इसके बाद का वर्शन (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)

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

Business Manager के शुरुआती पेज पर साइन अप करें और लॉग इन करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Meta Audience Network जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपके पास कोई मौजूदा मीडिएशन ग्रुप है जिसमें आपको बदलाव करना है, तो उसमें बदलाव करने के लिए, मीडिएशन ग्रुप के नाम पर क्लिक करें. इसके बाद, Meta Audience Network को विज्ञापन स्रोत के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप का स्टेटस चालू है पर सेट करें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:

Meta Audience Network को विज्ञापन स्रोत के तौर पर जोड़ना

विज्ञापन स्रोत सेक्शन में, बिडिंग कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, Meta Audience Network चुनें .
पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें. इसके बाद, Meta Audience Network के साथ बिडिंग पार्टनरशिप सेट अप करें.

स्वीकार करें और सहमत हों पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

अगर आपके पास पहले से ही Meta Audience Network के लिए मैपिंग है, तो आपके पास उसे चुनने का विकल्प है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने के लिए ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Meta Audience Network SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

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

Android के लिए Meta Audience Network SDK टूल का नया वर्शन डाउनलोड करें. AudienceNetwork/bin फ़ोल्डर में जाकर, AudienceNetwork.aar को निकालें और उसे अपने प्रोजेक्ट में जोड़ें.
Google के मेवन रिपॉज़िटरी पर, Meta Audience Network अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, Meta Audience Network अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

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

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

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

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

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

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

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

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

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

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

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

यह पुष्टि करने के लिए कि आपको Meta Audience Network से टेस्ट विज्ञापन मिल रहे हैं या नहीं, Meta Audience Network (बिडिंग) विज्ञापन स्रोत का इस्तेमाल करके, Ad Inspector में विज्ञापन के किसी एक स्रोत की जांच की सुविधा चालू करें.

वैकल्पिक चरण

नेटिव विज्ञापन

Meta Audience Network के नेटिव विज्ञापन की कुछ ऐसेट, Google की नेटिव विज्ञापन ऐसेट के साथ एक-एक करके मैप नहीं होती हैं. ऐसी एसेट को NativeAd में getExtras() तरीके से, बंडल में पब्लिशर को वापस भेजा जाता है. अडैप्टर में ये ऐसेट पास की जा सकती हैं:

अनुरोध पैरामीटर और वैल्यू
`FacebookMediationAdapter.KEY_ID`	स्ट्रिंग. नेटिव विज्ञापन का यूनीक आईडी
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	स्ट्रिंग. विज्ञापन का सोशल कॉन्टेक्स्ट

यहां इन ऐसेट को निकालने का तरीका बताने वाला कोड का उदाहरण दिया गया है:

उदाहरण:

Java

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Kotlin

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
   var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
   // ...
}

MediaView के बिना Meta Audience Network के नेटिव विज्ञापनों का इस्तेमाल करना

Meta Audience Network के नेटिव विज्ञापन फ़ॉर्मैट के लिए, MediaView ऐसेट को रेंडर करना ज़रूरी है. अगर आपको उस एसेट के बिना नेटिव विज्ञापन रेंडर करने हैं, तो ज़रूर इस्तेमाल करें Meta Audience Network के नेटिव बैनर विज्ञापन फ़ॉर्मैट.

इसके बजाय, Meta Audience Network के नेटिव बैनर विज्ञापनों का इस्तेमाल करने के लिए, आपको Meta Audience Network को सेट अप करते समय Native Banner फ़ॉर्मैट चुनना होगा. ऐसा करने पर, अडैप्टर अपने-आप उससे जुड़ा नेटिव विज्ञापन फ़ॉर्मैट लोड कर देगा.

विज्ञापन रेंडर करना

ऑडियंस नेटवर्क अडैप्टर, अपने नेटिव विज्ञापनों को NativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह किसीके लिए, नेटिव विज्ञापन फ़ील्ड की जानकारी को पॉप्युलेट करता है NativeAd.

फ़ील्ड	Meta Audience Network अडैप्टर से पॉप्युलेट किया जाता है
हेडलाइन
इमेज	1
मुख्य भाग
ऐप्लिकेशन का आइकॉन
कॉल-टू-ऐक्शन
विज्ञापन देने वाले का नाम
स्टार रेटिंग
स्टोर
कीमत

¹ Meta Audience Network अडैप्टर, अपने नेटिव विज्ञापनों के लिए मुख्य इमेज एसेट का सीधा ऐक्सेस नहीं देता. इसके बजाय, अडैप्टर, MediaView को वीडियो या इमेज से पॉप्युलेट करता है.

इंप्रेशन और क्लिक ट्रैकिंग

नीचे दी गई टेबल में बताया गया है कि Google Mobile Ads SDK टूल, नेटिव विज्ञापन इंप्रेशन और क्लिक कब रिकॉर्ड करता है.

इंप्रेशन रिकॉर्डिंग	रिकॉर्डिंग पर क्लिक करें
स्क्रीन पर Meta Audience Network की नेटिव विज्ञापन एसेट का 1 पिक्सल + एसेट रेंडर करने से जुड़ी ज़रूरी शर्तें	Meta Audience Network SDK टूल का कॉलबैक

किसी इंप्रेशन को मान्य माना जा सके, इसके लिए Meta Audience Network में एसेट को रेंडर करने से जुड़ी खास ज़रूरी शर्तें हैं. ये शर्तें इस बात पर निर्भर करती हैं कि आपने Meta Audience Network को सेट अप करते समय, नेटिव या नेटिव बैनर फ़ॉर्मैट में से किसका विकल्प चुना है.

Meta Audience Network का नेटिव फ़ॉर्मैट	ज़रूरी ऐसेट	रेंडरिंग क्लास ज़रूरी है
मूल भाषा वाला	मीडिया व्यू	`MediaView`
नेटिव बैनर	ऐप्लिकेशन का आइकॉन	`ImageView`

Android 9 पर कैश मेमोरी में सेव करना

Android 9 (एपीआई लेवल 28) से, क्लियरटेक्स्ट की सुविधा डिफ़ॉल्ट रूप से बंद रहती है. इससे, Meta Audience Network SDK टूल के मीडिया कैश मेमोरी के काम करने के तरीके पर असर पड़ेगा. साथ ही, उपयोगकर्ता अनुभव और विज्ञापन से होने वाली आय पर भी असर पड़ सकता है. अपने ऐप्लिकेशन में नेटवर्क सुरक्षा कॉन्फ़िगरेशन को अपडेट करने के लिए, Meta के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

गड़बड़ी के कोड

अगर अडैप्टर को Audience Network से कोई विज्ञापन नहीं मिलता है, तो विज्ञापन के रिस्पॉन्स से जुड़ी गड़बड़ी की जांच की जा सकती है. इसके लिए, इन क्लास में ResponseInfo.getAdapterResponses() का इस्तेमाल करें:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

जब कोई विज्ञापन लोड नहीं होता, तो ऑडियंस नेटवर्क एडेप्टर से मिलने वाले कोड और मैसेज यहां दिए गए हैं:

गड़बड़ी का कोड	कारण
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 का दस्तावेज़ देखें.