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

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

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

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

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

¹ Meta Audience Network में 2021 से, सिर्फ़ बिडिंग की सुविधा उपलब्ध है.
² Meta Audience Network, ऐंकर और इनलाइन अडैप्टिव बैनर के साथ काम नहीं करता.

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

• GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो.

• मीडिएशन की प्रोसेस पूरी करने के लिए, शुरुआती निर्देश देखें.

• Android का एपीआई लेवल 24 या इसके बाद का वर्शन

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

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

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

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

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

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

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

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

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

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

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

दूसरा चरण: Ad Manager के यूआई में Meta Audience Network की डिमांड सेट अप करना

अपने Ad Manager खाते में साइन इन करें.

सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा चालू करना

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा की समीक्षा करें और इसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, Facebook खोजें. इसके बाद, ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में, एसडीके से बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

Meta बिडिंग को कॉन्फ़िगर करना

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर Meta को चुनें.

बिड करने वाले इस व्यक्ति या कंपनी के लिए एसडीके से बिडिंग की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

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

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

Meta Audience Network के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं. इसके बाद, विज्ञापन यूनिट की नई मैपिंग पर क्लिक करें.

कोई खास विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. इसके बाद, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मिला प्लेसमेंट आईडी डालें.

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

आखिर में, सेव करें पर क्लिक करें.

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

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

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

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

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

• Android के लिए Meta Audience Network SDK का नया वर्शन डाउनलोड करें. AudienceNetwork/bin फ़ोल्डर में मौजूद AudienceNetwork.aar को एक्सट्रैक्ट करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

Meta, IAB Europe की ग्लोबल वेंडर लिस्ट (जीवीएल) में रजिस्टर नहीं है. इसके बजाय, आपको अन्य सहमति वाले मोड की तकनीकी जानकारी का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, अन्य सहमति वाले मोड के कॉम्पोनेंट देखें. अन्य सहमति मोड की सुविधा, IAB Europe के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के वर्शन 2 के साथ काम करती है. इस स्पेसिफ़िकेशन की मदद से, कॉन्सेंट मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) और पार्टनर के साथ मिलकर, Google की ऐड टेक प्रोवाइडर (एटीपी) की लिस्ट में शामिल कंपनियों के लिए, सहमति के अतिरिक्त सिग्नल इकट्ठा और ट्रांसमिट किए जा सकते हैं. हालांकि, ये कंपनियां अब तक IAB यूरोप की जीवीएल में शामिल नहीं हुई हैं.

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

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

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

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

उदाहरण:

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

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String 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 फ़ॉर्मैट चुनना होगा. इसके बाद, अडैप्टर अपने-आप उससे मिलता-जुलता नेटिव विज्ञापन फ़ॉर्मैट लोड कर देगा.

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

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

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

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

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

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

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

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

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

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

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

विज्ञापन लोड न होने पर, Audience Network अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं: