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

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

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

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

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

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

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

आगे बढ़ने से पहले, यह पक्का करें कि:

  • सबसे नया Google Mobile Ads Unity Plugin वर्शन.
  • Unity Editor का वर्शन 2019.4 या इसके बाद का वर्शन इंस्टॉल हो.
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 24 या इसके बाद का वर्शन इंस्टॉल हो.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन हो.
  • Google Mobile Ads Unity प्लगिनGoogle Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट हो जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन सेट अप हो.

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

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

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

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

ऐप्लिकेशन जोड़ें

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

New App Form

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

Android

Android ऐप्लिकेशन आईडी

iOS

iOS ऐप्लिकेशन आईडी

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

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

विज्ञापन स्लॉट जोड़ें

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

विज्ञापन स्लॉट के लिए नया फ़ॉर्म

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

Android

Android विज्ञापन स्लॉट आईडी

iOS

iOS विज्ञापन स्लॉट आईडी

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

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

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

App-ads.txt

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

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

Android

निर्देशों के लिए, Android के लिए बनी गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS के लिए बनी गाइड में दूसरा चरण देखें.

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

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

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

OpenUPM-CLI

अगर OpenUPM-CLI इंस्टॉल है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Google Mobile Ads BIGO Ads SDK मीडिएशन प्लगिन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.bigo

OpenUPM

Unity प्रोजेक्ट एडिटर में, बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर को चुनकर, Unity Package Manager की सेटिंग खोलें.

स्कोप वाली रजिस्ट्री टैब में, OpenUPM को स्कोप वाली रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

  • नाम: OpenUPM
  • यूआरएल: https://package.openupm.com
  • स्कोप: com.google

OpenUPM की जानकारी

इसके बाद, विंडो > पैकेज मैनेजर पर जाएं ताकि Unity Package Manager खुल जाए और ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री को चुनें.

Unity Registries

Google Mobile Ads Bigo Mediation पैकेज को चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करना

Unity पैकेज

बदलावों के इतिहास में दिए गए डाउनलोड लिंक से, BIGO Ads SDK के लिए Google Mobile Ads मीडिएशन प्लगिन का सबसे नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsBigoMediation.unitypackage को एक्सट्रैक्ट करें.

Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsBigoMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

Unity से इंपोर्ट करना

इसके बाद, ऐसेट > एक्सटर्नल डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व को चुनें. एक्सटर्नल डिपेंडेंसी मैनेजर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन की प्रोसेस को शुरू से करेगी. साथ ही, बताई गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

समस्या को ज़बरदस्ती हल करना

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

BIGO Ads SDK के लिए निजता सेटिंग लागू करने और निजता से जुड़े कानूनों का पालन करने के लिए, यह सेक्शन पढ़ें.

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

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

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

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

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

using GoogleMobileAds.Mediation.Bigo.Api;
// ...

Bigo.SetCcpaConsent(true);

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, BIGO Ads SDK के दस्तावेज़ पढ़ें.

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

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

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

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

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

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

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

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

Android

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

iOS

GADMediationAdapterBigo

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

Android

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

iOS

गड़बड़ी का कोड डोमेन वजह
101 com.google.mediation.bigoadapter सर्वर कॉन्फ़िगरेशन में, ज़रूरी ऐप्लिकेशन आईडी मौजूद नहीं है.
102 com.google.mediation.bigoadapter विज्ञापन का कॉन्फ़िगरेशन अमान्य है.
103 com.google.mediation.bigoadapter विज्ञापन नहीं दिखाया जा सका.
104 com.google.mediation.bigoadapter बैनर का साइज़, ज़रूरी शर्तों के मुताबिक नहीं है.
105 com.google.mediation.bigoadapter Bigo ने बैनर विज्ञापन को लोड कर लिया है, लेकिन विज्ञापन व्यू मौजूद नहीं है.
1000-1100 BIGO Ads SDK से भेजा गया BIGO Ads SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, BIGO Ads SDK के दस्तावेज़ देखें.

BIGO Ads SDK Unity मीडिएशन प्लगिन का बदलाव इतिहास

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

वर्शन 3.0.0

वर्शन 2.0.0

वर्शन 1.1.0

वर्शन 1.0.0