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

प्लैटफ़ॉर्म चुनें: Android Android iOS Unity

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

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

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

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

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

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

• iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए

• Google Mobile Ads SDK पर अपलोड हुआ नया वीडियो

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

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

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

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

CocoaPods

• अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

  pod 'GoogleMobileAdsMediationBigo'
  

• कमांड लाइन से यह निर्देश चलाएं:

  pod install --repo-update

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

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

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

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

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

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

Swift

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

Objective-C

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

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

SKAdNetwork लागू करना

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

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

GADMediationAdapterBigo

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

गड़बड़ी का कोड	डोमेन	वजह
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 iOS Mediation Adapter के बदलावों की जानकारी

वर्शन 5.2.1.0

• BIGO Ads SDK के 5.2.1 वर्शन के साथ काम करने की पुष्टि की गई है.
• निजता से जुड़े नए एपीआई का इस्तेमाल करने के लिए, Google Mobile Ads SDK की कम से कम ज़रूरी डिपेंडेंसी को 13.3.0 पर अपडेट करें.

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

• Google Mobile Ads SDK का वर्शन 13.4.0.
• BIGO Ads SDK का वर्शन 5.2.1.

वर्शन 5.2.0.0

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

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

• Google Mobile Ads SDK का वर्शन 13.4.0.
• BIGO Ads SDK का वर्शन 5.2.0.

वर्शन 5.1.2.1

• अब अडैप्टर, ageRestrictedTreatment Google Mobile Ads SDK फ़्लैग को BIGO Ads SDK के COPPA API को फ़ॉरवर्ड करता है.

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

• Google Mobile Ads SDK का वर्शन 13.3.0.
• BIGO Ads SDK का वर्शन 5.1.2.

वर्शन 5.1.2.0

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

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

• Google Mobile Ads SDK का वर्शन 13.2.0.
• BIGO Ads SDK का वर्शन 5.1.2.

वर्शन 5.1.1.0

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

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

• Google Mobile Ads SDK का वर्शन 13.2.0.
• BIGO Ads SDK का वर्शन 5.1.1.

वर्शन 5.1.0.1

• हमने अडैप्टर को अपडेट किया है, ताकि बैनर विज्ञापन को ऐसे साइज़ में लोड करने पर विज्ञापन दिखाने का अनुरोध पूरा न हो जो काम नहीं करता.

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

• Google Mobile Ads SDK का वर्शन 13.1.0.
• BIGO Ads SDK का वर्शन 5.1.0.

वर्शन 5.1.0.0

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

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

• Google Mobile Ads SDK का वर्शन 13.1.0.
• BIGO Ads SDK का वर्शन 5.1.0.

वर्शन 5.0.6.2

• Google Mobile Ads SDK की डिपेंडेंसी को 13.0.0 वर्शन पर अपडेट किया गया है.

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

• Google Mobile Ads SDK का वर्शन 13.0.0.
• BIGO Ads SDK का वर्शन 5.0.6.

वर्शन 5.0.6.1

• CocoaPods के लिए, iOS के कम से कम वर्शन को 13.0 पर अपडेट किया गया है.

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

• Google Mobile Ads SDK का वर्शन 13.0.0.
• BIGO Ads SDK का वर्शन 5.0.6.

वर्शन 5.0.6.0

• शुरुआती रिलीज़!
• ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन, बैनर विज्ञापन (इसमें एमआरईसी शामिल है), इंटरस्टीशियल विज्ञापन, इनाम वाले विज्ञापन, और नेटिव विज्ञापन के फ़ॉर्मैट के लिए बिडिंग की सुविधा जोड़ी गई.
• BIGO Ads SDK के 5.0.6 वर्शन के साथ काम करने की पुष्टि की गई है.

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

• Google Mobile Ads SDK का वर्शन 12.14.0.
• BIGO Ads SDK का वर्शन 5.0.6.