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

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

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

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

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

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

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

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

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

पहला चरण: 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 टैब पर जाएं और टैब में दिए गए निर्देशों का पालन करें.

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 TECHNOLOGY PTE LTD को जोड़ना

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:bigo:5.9.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")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:bigo:5.9.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'
}

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

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

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

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

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

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

Java

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

Kotlin

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

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

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

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

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

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

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

Android

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

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

वैकल्पिक चरण

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

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

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

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

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

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

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

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

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

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

वर्शन 5.10.1.0 (डेवलेपमेंट में है)

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

  • 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.