मीडिएशन की मदद से, BIGO Ads SDK को इंटिग्रेट करना

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

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

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

¹ बिडिंग इंटिग्रेशन, चुनिंदा उपयोगकर्ताओं के लिए बीटा वर्शन में उपलब्ध है. इसका ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

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

• नया वर्शनGoogle Mobile Ads SDK (Legacy)

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

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

लॉग इन करें BIGO Ads के डैशबोर्ड में.

ऐप्लिकेशन बनाना

इन्वेंट्री टैब पर जाएं. इसके बाद, ऐप्लिकेशन और साइटें टेबल में, + जोड़ें बटन को चुनें.

फ़ॉर्म में बाकी जानकारी भरें और सबमिट करें पर क्लिक करें.

ऐप्लिकेशन आईडी को नोट करें.

विज्ञापन स्लॉट बनाना

ऐप्लिकेशन की समीक्षा हो जाने के बाद, विज्ञापन स्लॉट टेबल पर जाएं और + जोड़ें बटन को चुनें.

**नीलामी के टाइप** के लिए, सर्वर बिडिंग को चुनें. इसके बाद, फ़ॉर्म में बाकी जानकारी भरें और सबमिट करें पर क्लिक करें.

स्लॉट आईडी को नोट करें

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

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

BIGO Ads SDK के लिए app-ads.txt लागू करने के लिए, डैशबोर्ड से APP-ads.txt टैब पर जाएं और टैब में दिए गए निर्देशों का पालन करें.

दूसरा चरण: AdMob के यूज़र इंटरफ़ेस (यूआई) में BIGO Ads SDK की डिमांड सेट अप करना

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

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

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

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

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

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

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

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

BIGO Ads SDK को विज्ञापन सोर्स के तौर पर जोड़ना

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

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

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

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

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

अपने ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये इंप्लीमेंटेशन डिपेंडेंसी जोड़ें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:bigo:5.10.1.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:bigo:5.10.1.0'
}

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

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

BIGO Ads SDK, जीडीपीआर के तहत दी गई सहमति को अपने-आप पढ़ लेता है. यह सहमति, सहमति मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, जीडीपीआर पर BIGO Ads SDK की इंटिग्रेशन गाइड देखें.

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

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

यहां दिए गए सैंपल कोड में, सहमति का फ़्लैग BIGO Ads SDK को पास करने का तरीका बताया गया है. Google Mobile Ads SDK (Legacy) के ज़रिए विज्ञापनों का अनुरोध करने से पहले, इस तरीके का इस्तेमाल करें.

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

ज़्यादा जानकारी के लिए, सीसीपीए पर BIGO Ads SDK की इंटिग्रेशन गाइड देखें.

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

BIGO Ads SDK इंटिग्रेशन के लिए, किसी अतिरिक्त कोड की ज़रूरत नहीं है.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

Android

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

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

वैकल्पिक चरण

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

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

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

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

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

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

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

Bigo Android मीडिएशन अडैप्टर के बदलावों का लॉग

वर्शन 5.10.1.0

• Bigo Ads SDK 5.10.1 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.4.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
• Bigo Ads SDK का वर्शन 5.10.1.

वर्शन 5.9.0.1

• AgeRestrictedTreatment को Bigo के कोपा एपीआई से मैप करता है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.4.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
• Bigo Ads SDK का वर्शन 5.9.0.

वर्शन 5.9.0.0

• Bigo Ads SDK 5.9.0 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.2.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.0.1.
• Bigo Ads SDK का वर्शन 5.9.0.

वर्शन 5.8.0.0

• GMA Next-Gen SDK डिपेंडेंसी के साथ अडैप्टर बनाने के लिए, प्रॉपर्टी जोड़ी गई.
• Bigo Ads SDK 5.8.0 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.1.0.
• Bigo Ads SDK का वर्शन 5.8.0.

वर्शन 5.7.1.0

• Bigo Ads SDK 5.7.1 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.0.0.
• Bigo Ads SDK का वर्शन 5.7.1.

वर्शन 5.7.0.0

• Google Mobile Ads SDK के tagForUnderAgeOfConsent पैरामीटर को Bigo Ads SDK पर फ़ॉरवर्ड करने की सुविधा जोड़ी गई.
• Bigo Ads SDK 5.7.0 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.9.0.
• Bigo Ads SDK का वर्शन 5.7.0.

वर्शन 5.5.2.0

• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए सहायता जोड़ी गई.
• Bigo Ads SDK 5.5.2 के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.9.0.
• Bigo Ads SDK का वर्शन 5.5.2.