Android के लिए AFS नेटिव को लागू करना

Google Mobile Ads SDK, कस्टम सर्च स्टाइल के साथ भी काम करता है. अगर आपका ऐप्लिकेशन पहले से Google Mobile Ads SDK का इस्तेमाल कर रहा है, तो हमारा सुझाव है कि आप AFSMA SDK टूल का वर्शन आज़माएं.

अगर आपको 18.1.0 या इससे पहले के वर्शन 19.0.0 या इसके बाद के वर्शन पर अपग्रेड करना हो, तो कृपया यह देखें डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.

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

इस गाइड में यह माना गया है कि आपको इनके बारे में जानकारी है:

AFS नेटिव SDK टूल इंपोर्ट करें

SDK टूल जोड़ें

अपने ऐप्लिकेशन में AFS नेटिव SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:

अपनी ऐप्लिकेशन मॉड्यूल डायरेक्ट्री में build.gradle फ़ाइल खोलें. SDK के नए वर्शन के लिए dependencies में एक नया बिल्ड नियम जोड़ें:

dependencies {
  implementation 'com.google.android.gms:play-services-afs-native:19.1.0'
}

पक्का करें कि आपके टॉप-लेवल build.gradle में google() का रेफ़रंस हो रेपो या maven { url "https://maven.google.com" } पर भेजें.

इन निर्देशों का पालन करें का इस्तेमाल करें. इस प्लग इन को लागू करने से ग्रेडल बिल्ड की गड़बड़ी होती है. ऐसा तब होता है, जब AFS नेटिव SDK की अनुमति के बजाय Google Play सेवाओं के असंगत वर्शन के साथ उपयोग किया जाता है जिसकी वजह से रनटाइम बंद हो सकता है. या लागू करें failOnVersionConflict() ResolutionStrategy आपके प्रोजेक्ट के लिए बनाया गया है, ताकि Google Play के असंगत वर्शन होने पर बिल्ड में गड़बड़ी हो आपके प्रोजेक्ट में सेवाओं का इस्तेमाल किया जाता है. बदलावों को सेव करें और Gradle फ़ाइलों के साथ प्रोजेक्ट सिंक करें पर क्लिक करें क्लिक करें.

Android सहायता लाइब्रेरी के बजाय AndroidX का इस्तेमाल करें

SDK टूल के वर्शन 17.0.0 और उसके बाद के वर्शन में, आपके ऐप्लिकेशन को Jetpack (AndroidX) का इस्तेमाल करना होगा Android सहायता लाइब्रेरी के बजाय लाइब्रेरी. साथ काम करने के लिए ज़रूरी शर्तें:

  • com.android.tools.build:gradle को v3.2.1 या इसके बाद के वर्शन पर सेट करें.
  • compileSdkVersion को 28 या उसके बाद के समय पर सेट करें.
  • Jetpack (AndroidX) इस्तेमाल करने के लिए अपने ऐप्लिकेशन को अपडेट करें; में दिए गए निर्देशों का पालन करें AndroidX पर माइग्रेट करना.

क्लास

अपने ऐप्लिकेशन में AFS नेटिव विज्ञापन दिखाने के लिए, ये क्लास लागू करें:

SearchAdController

  • यह क्लास एसिंक्रोनस रूप से विज्ञापनों का अनुरोध करने, कैश मेमोरी में सेव होने और विज्ञापनों को फिर से हासिल करना और विज्ञापनों को रेंडर करना.
  • हर विज्ञापन संदर्भ के लिए एक अलग SearchAdController की ज़रूरत होती है; उदाहरण के लिए, अगर इसमें एक स्क्रीन होती है, जो खोज परिणामों की सूची के साथ-साथ विज्ञापन दिखाती है और किसी प्रॉडक्ट की जानकारी के साथ विज्ञापन दिखाने वाली एक स्क्रीन है, तो आपको SearchAdController के दो अलग-अलग इंस्टेंस बनाएं, यानी हर मामले के लिए एक अलग.
  • कंस्ट्रक्टर को आपका वेब प्रॉपर्टी कोड (पब्लिशर आईडी) देना होगा, style आईडी लागू करें लौटाए गए विज्ञापन और SearchAdOptions. कंस्ट्रक्टर में दिया गया Context यह Activity होना चाहिए, जिसमें SearchAdController शामिल है और जहां आपके पास विज्ञापन को View दिखाएगा.
  • नए उपयोगकर्ता की खोज के बारे में बताने और एसिंक्रोनस विज्ञापन शुरू करने के लिए, loadAds को कॉल करें अनुरोध. पिछले कॉल से loadAds पर लोड किए गए सभी विज्ञापन यहां से हटा दिए जाते हैं नया कॉल करने पर विज्ञापन की कैश मेमोरी में सेव किया जाता है.
  • विज्ञापन के क्रिएटिव दिखाने के लिए, createAdView के साथ View बनाएं.
  • विज्ञापन लोड होने के बाद, पहले जनरेट किए गए View के साथ populateAdView को कॉल करें createAdView के साथ कैश मेमोरी में सेव किए गए विज्ञापन को View में रेंडर करने के लिए किया जा सकता है. इसके अलावा भरी जाने वाली View की जानकारी के लिए, adKey खास तरीके से विज्ञापन को पहचानने में मदद करता है. यह यहां से लौटाए गए खास विज्ञापन क्रिएटिव को जोड़ता है उस adKey के साथ कैश मेमोरी में सेव किया जाता है, ताकि जब आगे के कॉल में वही adKey पास किया जाए populateAdView को वही विज्ञापन दिखाया जाएगा. उदाहरण के लिए, अगर populateAdView को adKey="keyA" के साथ पहली बार कॉल किया गया और हाइकिंग बूट के लिए विज्ञापन, इसके साथ populateAdView को हर एक कॉल adKey="keyA", हाइकिंग बूट के लिए यही विज्ञापन दिखाएगा. ( loadAds, कैश मेमोरी में सेव किए गए सभी विज्ञापन और उनसे जुड़ी विज्ञापन कुंजियां हटा देता है.)

SearchAdOptions

  • विज्ञापनों को पसंद के मुताबिक बनाने के लिए, इस ऑब्जेक्ट को SearchAdController कंस्ट्रक्टर को पास करें का अनुरोध किया जाता है और उन्हें दिखाया जाता है. इसके लिए, SearchAdOptions.Builder पर build() को कॉल करें कोई SearchAdOptions ऑब्जेक्ट बनाएं.

View

  • इस पर createAdView() को कॉल करके, विज्ञापन होल्ड करने के लिए View ऑब्जेक्ट बनाएं SearchAdController. एक बार में ज़्यादा से ज़्यादा एक विज्ञापन दिखाता है, लेकिन सिर्फ़ View ही विज्ञापन दिखा सकता है जिसे समय के साथ अलग-अलग विज्ञापनों को दिखाने के लिए रीसाइकल किया जा सकता है.

SearchAdRequest

  • SearchAdRequest का इस्तेमाल करके, SearchAdController पर loadAds तरीके को कॉल करें एसिंक्रोनस विज्ञापन अनुरोध शुरू करने के लिए. build() को इस नंबर पर कॉल करें: SearchAdRequest ऑब्जेक्ट बनाने के लिए SearchAdRequest.Builder.

AdListener

  • इस इंटरफ़ेस को लागू करें और इसे SearchAdController कंस्ट्रक्टर को पास करें का इस्तेमाल करें.
  • ध्यान दें: रद्द किए गए अनुरोध (कॉल) पर AdListener कॉलबैक को कॉल नहीं किया जाएगा loadAds को कॉल किया गया. इसे loadAds पर किए गए कॉल से, पहले कॉल का समाधान हुआ).

लागू करने का उदाहरण

नीचे दिए गए उदाहरण में, सैंपल में SearchAdController बनाने का तरीका बताया गया है Activity.

//  MainActivity.java implementation
//  (MainActivity is a subclass of Activity)

SearchAdController adController;
// adContainer where we will place our ads in this example.
ViewGroup adContainer;

protected void onCreate(Bundle bundle){
  super.onCreate(bundle);
  adContainer = (ViewGroup) findViewById(...);
  // Specify ad options (not required).
  SearchAdOptions.Builder adOptionsBuilder = new SearchAdOptions.Builder();
  adOptionsBuilder.setAdType(SearchAdOptions.AD_TYPE_TEXT);
  adOptionsBuilder.setPrefetch(true);
  adOptionsBuilder.setNumAdsRequested(3);
  // Provide a callback to trigger when ads are loaded.
  AdListener adListener = new AdListener() {
    public void onAdLoaded() {
      createAndShowAd();
    }
  };
  // Instantiate the SearchAdController.
  adController = new SearchAdController(this, "your-client-id", "your-style-id",
                                        adOptionsBuilder.build(), adListener);
}

जब उपयोगकर्ता क्वेरी शुरू करे, तो SearchAdRequest बनाएं और loadAds को कॉल करें SearchAdController पर एसिंक्रोनस विज्ञापन अनुरोध शुरू करने के लिए.

// Create the request.
SearchAdRequest.Builder requestBuilder = new SearchAdRequest.Builder();
requestBuilder.setQuery("user query here");
// Load the ads.
adController.loadAds(requestBuilder.build());

लोड किए गए विज्ञापन को किसी विज्ञापन व्यू में दिखाने के लिए, onAdLoaded कॉलबैक लागू करें.

private void createAndShowAd() {
  // Create a new view that will contain the ad.
  View adView = adController.createAdView();
  // Attach the new view to the view hierarchy.
  adContainer.addView(adView);
  // Display the ad inside the adView. We need to provide an adKey to
  // indicate which ad is to be displayed in the adView. In this example, 
  // since we only have one ad, we can provide any constant string. However, 
  // if you intend to display multiple ads, each ad you wish to display
  // should be given a unique adKey of your choosing.
  adController.populateAdView(adView, "demoAd");
}

दी गई क्वेरी से संबंधित विज्ञापन अब adView में दिखेगा.

गड़बड़ियों की जांच करना

SearchAdController के लिए, onAdLoaded() वाले AdListener ऑब्जेक्ट की ज़रूरत है का इस्तेमाल करके आपको यह सूचना देनी होगी कि विज्ञापन दिखाने के लिए तैयार हैं. आपको यह भी करना चाहिए onAdFailedToLoad() तरीका लागू करें, ताकि आप गड़बड़ियों का पता लगाकर उन्हें ठीक कर सकें. उदाहरण के लिए, अपनेAdListener लागू करना:

AdListener adListener = new AdListener() {
    public void onAdLoaded() {
        // Called when an ad is loaded.
        Toast.makeText(MainActivity.this, "Ad Loaded",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Loaded");
    }

    public void onAdLeftApplication() {
        // Called when an ad leaves the application
        // (to go to the browser for example).
        Toast.makeText(MainActivity.this, "Ad Left Application",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Left Application");
    }

    @Override
    public void onAdFailedToLoad(int errorCode) {
        // Called when an ad request failed.
        Toast.makeText(MainActivity.this, "Ad Failed to Load: " + errorCode,
                Toast.LENGTH_SHORT).show();
        Log.e(MainActivity.class.getSimpleName(), "Ad Failed to Load: " +
                errorCode);
    }
};

onAdFailedToLoad() कॉलबैक तरीके में इस्तेमाल किए गए कॉन्स्टेंट AdListener में बताई गई हैं.