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

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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

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

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

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

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

• AdMob मीडिएशन सेट अप करें.

पहला चरण: 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 को विज्ञापन स्रोत के तौर पर जोड़ना

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, BIGO Ads SDK को चुनें .

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और BIGO Ads SDK के साथ बिडिंग पार्टनरशिप सेट अप करें.



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



अगर आपने BIGO Ads SDK को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



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

अहम जानकारी: ऐप्लिकेशन आईडी, टारगेट किए गए ऐप्लिकेशन से जुड़ा होना चाहिए, जैसा कि BIGO Ads SDK के यूज़र इंटरफ़ेस (यूआई) में होता है.

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

अहम जानकारी: पक्का करें कि आपके पास खाते के मैनेजमेंट की अनुमति हो, ताकि आप ईयू उपयोगकर्ता की सहमति और जीडीपीआर, अमेरिका के राज्यों में लागू कानूनों, और User Messaging Platform के लिए कॉन्फ़िगरेशन पूरा कर सकें. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोपीय कानूनों के तहत विज्ञापन पार्टनर की सूची में Empathy Technology Pte.Ltd. (BIGO Ads) और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में **BIGOAds** को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग

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

ध्यान दें: साथ काम करने वाले BIGO Ads SDK और Google Mobile Ads SDK के वर्शन इंटिग्रेट न होने पर, बिल्ड से जुड़ी समस्याएं आ सकती हैं.

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

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

Kotlin

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

ग्रूवी

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

चौथा चरण: BIGO Ads विज्ञापन के लिए इस्तेमाल होने वाला एसडीके टूल पर निजता सेटिंग लागू करना

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

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

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

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

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

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

Java

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

Kotlin

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

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

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

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

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

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

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

BIGO Ads, Android के लिए टेस्ट ऐप्लिकेशन आईडी और विज्ञापन स्लॉट आईडी उपलब्ध कराता है, ताकि टेस्ट और इंटिग्रेशन में मदद मिल सके.

अहम जानकारी: अपने ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और BIGO Ads SDK के लिए टेस्ट मोड बंद करें.

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

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

वैकल्पिक चरण

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

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

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

फ़ील्ड	BIGO Ads SDK अडैप्टर में हमेशा शामिल होने वाली ऐसेट
हेडलाइन
इमेज
Body
आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत
विज्ञापन देने वाला

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

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

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

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

गड़बड़ी का कोड	डोमेन	वजह
101	com.google.ads.mediation.bigo	Bigo स्लॉट आईडी मौजूद नहीं है या खाली है.
1000-1100	BIGO Ads SDK से भेजा गया	BIGO Ads SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, BIGO Ads SDK का दस्तावेज़ देखें.

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

वर्शन 6.1.0.0

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

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

• Google Mobile Ads SDK का वर्शन 25.5.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.4.0.
• Bigo Ads SDK का वर्शन 6.1.0.

वर्शन 6.0.1.0

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

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

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

वर्शन 6.0.0.1

• अडैप्टर की Kotlin डिपेंडेंसी को 1.9.0 पर पिन करें. यह Kotlin का वह सबसे पुराना वर्शन है जो SDK GMA Next-Gen के साथ काम करता है.

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

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

वर्शन 6.0.0.0

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

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

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

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

• Maps AgeRestrictedTreatment to Bigo's COPPA API.

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

• 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

• Bigo Ads SDK में tagForUnderAgeOfConsent Google Mobile 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.