इस पेज का अनुवाद Cloud Translation API से किया गया है.

AppLovin को मीडिएशन के साथ इंटिग्रेट करना

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

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

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

इंटिग्रेशन
बिडिंग
झरना
फ़ॉर्मैट
बैनर	¹
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

¹ बैनर विज्ञापन (एमआरईसी बैनर को छोड़कर) सिर्फ़ मीडिएशन में काम करते हैं. बिडिंग की सुविधा, किसी भी तरह के बैनर विज्ञापनों के साथ काम नहीं करती.

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

iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
[बिडिंग के लिए]: AppLovin अडैप्टर 6.3.0.0 या इसके बाद का वर्शन (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

अपने AppLovin खाते में साइन अप करें या लॉग इन करें.

Ad Manager विज्ञापन यूनिट सेट अप करने के लिए, आपको AppLovin SDK पासकोड और रिपोर्ट पासकोड की ज़रूरत होगी. दोनों वैल्यू देखने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) > खाता > कुंजियां पर जाएं.

अगर आपको सिर्फ़ बिडिंग को इंटिग्रेट करना है, तो मीडिएशन सेटिंग कॉन्फ़िगर करें.

मीडिएशन के लिए ऐप्लिकेशन चुनना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

झरना

रजिस्टर किए गए ऐप्लिकेशन देखने के लिए, AppLovin के यूज़र इंटरफ़ेस (यूआई) में, कमाई करना सेक्शन में जाकर ऐप्लिकेशन चुनें. उपलब्ध ऐप्लिकेशन की सूची से, वह ऐप्लिकेशन चुनें जिसका आपको मीडिएशन के साथ इस्तेमाल करना है.

एक क्षेत्र बनाएं

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

झरना

रजिस्टर किए गए ज़ोन आईडी देखने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) पर, कमाई करना सेक्शन में जाकर ज़ोन चुनें. अगर आपने अपने ऐप्लिकेशन के लिए ज़रूरी ज़ोन पहले ही बना लिए हैं, तो सीधे दूसरे चरण पर जाएं. नया ज़ोन आईडी बनाने के लिए, ज़ोन बनाएं पर क्लिक करें.

ज़ोन आईडी का नाम डालें. इसके बाद, प्लैटफ़ॉर्म के तौर पर Android चुनें और विज्ञापन टाइप चुनें.

सीपीएम या AppLovin की ओर से ऑप्टिमाइज़ की गई में से किसी एक को चुनकर, ज़ोन के लिए कीमत कॉन्फ़िगर करें. फ़्लैट सीपीएम विकल्प के लिए, सीपीएम को हर देश के हिसाब से कॉन्फ़िगर किया जा सकता है. इसके बाद, सेव करें पर क्लिक करें.

ज़ोन बन जाने के बाद, ज़ोन आईडी कॉलम में ज़ोन आईडी देखा जा सकता है.

टेस्ट मोड चालू करना

AppLovin के टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में जानने के लिए, AppLovin के MAX टेस्ट मोड की गाइड में दिए गए निर्देशों का पालन करें.

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

अपने Ad Manager खाते में साइन इन करें.

AppLovin को कंपनियों में जोड़ना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

झरना

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

विज्ञापन नेटवर्क के तौर पर AppLovin चुनें, कोई यूनीक नाम डालें, और मीडिएशन चालू करें. डेटा अपने-आप इकट्ठा होने की सुविधा को चालू करें. साथ ही, पिछले सेक्शन में मिली Report Key डालें.

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. जब आपका काम हो जाए, तो सेव करें पर क्लिक करें.

सुरक्षित सिग्नल शेयर करने की सुविधा चालू करना

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित सिग्नल शेयर करने की सुविधा की समीक्षा करें और उसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

AppLovin बिडिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, नया बिडर पर क्लिक करें.

बिड लगाने वाले के तौर पर AppLovin को चुनें.

बिड करने वाले की सिग्नल लाइब्रेरी को, अनुमति वाले सिग्नल की सूची में जोड़ें और बिड करने वाले के साथ सिग्नल शेयर करने की अनुमति दें को टॉगल करें. इसके बाद, जारी रखें पर क्लिक करें.

जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

विज्ञापन यूनिट मैपिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, कंपनी को चुनें.AppLovin

विज्ञापन यूनिट मैपिंग टैब पर जाएं और नई विज्ञापन यूनिट मैपिंग पर क्लिक करें.

कोई विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. साथ ही, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन मेंSDK Key उपलब्ध कराई गई वैल्यू डालें. आखिर में, सेव करें पर क्लिक करें.

झरना

डिलीवरी > नतीजे के ग्रुप पर जाएं और नया नतीजा ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और नतीजों से जुड़े विज्ञापन दिखाने वाले पार्टनर जोड़ें पर क्लिक करें.

पिछले सेक्शन में, AppLovinके लिए बनाई गई कंपनी को चुनें. इंटिग्रेशन टाइप के तौर पर Mobile SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्टेटस के तौर पर चालू है चुनें.

पिछले सेक्शन में मिली Bundle ID of your app along with the SDK Key and the Zone ID वैल्यू और डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.

ध्यान दें: अपने-आप डेटा इकट्ठा करने की सुविधा को डेटा इकट्ठा करने में कुछ दिन लगते हैं. इसके बाद ही, यह किसी मीडिएशन नेटवर्क के लिए डाइनैमिक सीपीएम वैल्यू का सटीक हिसाब लगा पाती है. eCPM का हिसाब लगाने के बाद, यह आपकी ओर से अपने-आप अपडेट हो जाता है.

जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में AppLovin Corp. जोड़ें

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

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

CocoaPods का इस्तेमाल करना (सुझाया गया)

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationAppLovin'
```
कमांड लाइन से चलाएं:
```
pod install --repo-update
```

मैन्युअल इंटिग्रेशन

AppLovin iOS SDK टूल का नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में ApplovinSDK.framework को लिंक करें.
अपने प्रोजेक्ट में, बदलावों की जानकारी में मौजूद डाउनलोड लिंक और लिंकApplovinAdapter.framework से, AppLovin अडैप्टर का नया वर्शन डाउनलोड करें.
अपने प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

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

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

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

SDK टूल के 12.0.0 वर्शन से, AppLovin UserDefaults से सहमति स्ट्रिंग को पढ़ने और उसके हिसाब से सहमति की स्थिति सेट करने की सुविधा देता है.

अगर AppLovin SDK टूल के 12.0.0 या इसके बाद के वर्शन का इस्तेमाल नहीं किया जा रहा है या ऐसे सीएमपी का इस्तेमाल नहीं किया जा रहा है जो UserDefaults में सहमति वाली स्ट्रिंग लिखता है, तो setHasUserContent तरीके का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में, सहमति की जानकारी को AppLovin SDK टूल को भेजा गया है. Google Mobile Ads SDK टूल को शुरू करने से पहले, आपको ये विकल्प सेट करने होंगे. इससे यह पक्का किया जा सकेगा कि ये विकल्प, AppLovin SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

ज़्यादा जानकारी के लिए, AppLovin की निजता सेटिंग देखें.

नाबालिग उपयोगकर्ताओं की जानकारी देना

AppLovin SDK 13.0.0 से, AppLovin अब उम्र से जुड़ी पाबंदी वाले उपयोगकर्ता फ़्लैग के साथ काम नहीं करता. साथ ही, लागू कानूनों के तहत "बच्चे" के तौर पर बताए गए व्यक्ति के लिए, AppLovin SDK को शुरू या इस्तेमाल नहीं किया जा सकता. ज़्यादा जानकारी के लिए, AppLovin के दस्तावेज़ देखें. इनमें, बच्चों के डेटा को इकट्ठा करने या बच्चों के लिए बनी सेवाओं या ऐप्लिकेशन का इस्तेमाल करने पर पाबंदी के बारे में बताया गया है.

AppLovin अडैप्टर का 13.0.0.1 या इसके बाद का वर्शन, उन ऐप्लिकेशन के लिए AppLovin मीडिएशन को अपने-आप बंद कर देता है जो Google Mobile Ads SDK के साथ इनमें से किसी एक सेटिंग का एलान करते हैं:

अगर AppLovin अडैप्टर के 12.6.1.0 या उससे पहले के वर्शन का इस्तेमाल किया जा रहा है, तो AppLovin SDK टूल की मदद से, उम्र से जुड़ी पाबंदी वाले उपयोगकर्ता फ़्लैग को सेट करने के लिए, AppLovin का दस्तावेज़ देखें.

अमेरिका के निजता कानून

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

AppLovin SDK टूल में setDoNotSell तरीका शामिल है. इसकी मदद से, पब्लिशर अपनी निजी जानकारी बेचने से ऑप्ट आउट कर सकते हैं.

नीचे दिए गए उदाहरण में, सहमति की यह जानकारी AppLovin SDK टूल को भेजी गई है. Google Mobile Ads SDK टूल को शुरू करने से पहले, आपको ये विकल्प सेट करने होंगे. इससे यह पक्का किया जा सकेगा कि ये विकल्प, AppLovin SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

ज़्यादा जानकारी के लिए, AppLovin की निजता से जुड़ा दस्तावेज़ देखें.

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

SKAdNetwork इंटिग्रेशन

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

छठा चरण: लागू करने की जांच करना

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Applovin यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

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

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

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

AppLovin अडैप्टर, muteAudio के साथ काम करता है. यह एक वैकल्पिक सुविधा है, जिसकी मदद से वीडियो विज्ञापनों में ऑडियो बंद किया जा सकता है. इस पैरामीटर को अडैप्टर को पास करने के लिए, GADMAdapterAppLovinExtras क्लास का इस्तेमाल किया जा सकता है. साथ ही, आपको इसे हर विज्ञापन अनुरोध पर सेट करना होगा. इसे सेट करने का तरीका यहां बताया गया है:

Swift

let request = GAMRequest()
let extras = GADMAdapterAppLovinExtras()
extras.muteAudio = false
request.register(extras)

Objective-C

GAMRequest *request = [GAMRequest request];
GADMAdapterAppLovinExtras * extras = [[GADMAdapterAppLovinExtras alloc] init];
extras.muteAudio = NO;
[request registerAdNetworkExtras:extras];

अनुकूलन

ऐप्लिकेशन लॉन्च होने के साथ ही, AppLovin SDK टूल को शुरू करने से, ऐप्लिकेशन शुरू होने के साथ ही, AppLovin को इवेंट ट्रैक करने की सुविधा मिलती है.

Swift

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Objective-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

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

अगर अडैप्टर को AppLovin से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास के तहत, GADResponseInfo.adNetworkInfoArray इन क्लास के तहत:

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

जब कोई विज्ञापन लोड नहीं होता है, तो AppLovin अडैप्टर से ये कोड और मैसेज मिलते हैं:

गड़बड़ी का कोड	कारण
-1,009 से -1, 204	AppLovin SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, AppLovin का दस्तावेज़ देखें.
101	अनुरोध किया गया विज्ञापन साइज़, AppLovin के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता.
102	Ad Manager यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए AppLovin सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
103	AppLovin का विज्ञापन नहीं दिखाया जा सका.
104	एक ही ज़ोन के लिए कई विज्ञापनों का अनुरोध किया गया है. AppLovin, हर ज़ोन में एक बार में सिर्फ़ एक विज्ञापन लोड कर सकता है.
105	AppLovin SDK टूल की कुंजी नहीं मिली.
107	बिड टोकन खाली है.
108	AppLovin अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
110	AppLovin ने लोड होने का कॉलबैक भेजा, लेकिन कोई विज्ञापन लोड नहीं हुआ.
111	AppLovin SDK टूल का इंस्टेंस नहीं मिला.
112	उपयोगकर्ता बच्चा है.