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

प्लैटफ़ॉर्म चुनें: Android नई सुविधा Android iOS Unity

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

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

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

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

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

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

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

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

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

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

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

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

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

नया ऐप्लिकेशन फ़ॉर्म

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

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 के लिए गाइड में दिया गया दूसरा चरण देखें.

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • स्कोप: com.google

OpenUPM की जानकारी

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

Unity Registries

Google Mobile Ads Bigo Mediation पैकेज चुनें और Install पर क्लिक करें.

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

Unity पैकेज

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

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

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

इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी और एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

ज़बरदस्ती हल करें

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

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

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

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

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

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

यहां दिए गए सैंपल कोड में, BIGO Ads SDK को सहमति का फ़्लैग भेजने का तरीका बताया गया है. 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.mediation.bigoadapter Bigo Slot ID मौजूद नहीं है या खाली है.
1000-1100 BIGO Ads SDK से भेजा गया BIGO Ads SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, BIGO Ads SDK के दस्तावेज़ देखें.

iOS

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

BIGO Ads SDK Unity Mediation Plugin के बदलावों की जानकारी

वर्शन 1.0.0