বিজ্ঞাপনের জন্য WebView API ব্যবহার করা

বিজ্ঞাপনের জন্য WebView API, WebViewController ব্যবহার করে অ্যাপ-মধ্যস্থ বিজ্ঞাপন মনিটাইজেশনের সুবিধা দেয়। আপনি যদি WebViewController-এর মাধ্যমে আপনার অ্যাপে AdSense কোড বা Google Publisher Tag ব্যবহার করে বিজ্ঞাপন দেখানো ওয়েব কন্টেন্ট প্রদর্শন করেন, তাহলে বিজ্ঞাপন মনিটাইজেশন চালু করতে আপনার এই API ব্যবহার করা উচিত। আরও জানতে, AdSense এবং Ad Manager নীতি দেখুন।

1. Google Mobile Ads Flutter Plugin-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করে মনিটাইজ করুন

   আপনি মোবাইল অ্যাপের জন্য বিজ্ঞাপন ফর্ম্যাট প্রয়োগ করে Google Mobile Ads Flutter Plugin-এর সাথে Ad Manager-এ বিজ্ঞাপনের অনুরোধ করে আপনার অ্যাপ মনিটাইজ করতে পারবেন।

   আরও জানুন।

2. বিজ্ঞাপনের জন্য WebView API ব্যবহার করে মনিটাইজ করা

   আপনার অ্যাপ যদি WebViewController ব্যবহার করে ওয়েব কন্টেন্ট দেখায়, যা Ad Manager বা AdSense থেকে বিজ্ঞাপন দেখায়, তাহলে Google Mobile Ads Flutter Plugin-এর সাথে WebViewController অবজেক্ট রেজিস্টার করতে বিজ্ঞাপনের জন্য WebView API ব্যবহার করুন। AdSense কোড বা Google Publisher Tag-এ থাকা জাভাস্ক্রিপ্ট বিজ্ঞাপনের অনুরোধ তৈরি করে পাঠায়, তাই আপনাকে SDK-এর মাধ্যমে বিজ্ঞাপনের কোনও অনুরোধ করতে হয় না। মনে রাখবেন, এই API ব্যবহার করে শুধুমাত্র মোবাইল ওয়েব ও ডেস্কটপ ওয়েব ইনভেনটরি ফর্ম্যাট উপলভ্য।

   WebViewController-এ ওয়েব কন্টেন্টের মালিক আপনি না হলেও, বিজ্ঞাপনদাতাদের স্প্যাম থেকে রক্ষা করতে এবং কন্টেন্ট প্রদানকারী ওয়েব প্রকাশকদের জন্য মনিটাইজেশন উন্নত করতে আপনাকে এই API ব্যবহার করার জন্য উৎসাহিত করা হচ্ছে।

মনে রাখবেন, আপনি একই অ্যাপে যেকোনও একটি বিকল্প বা দুটিই বেছে নিতে পারেন।

এই নির্দেশিকাটি আপনার iOS অ্যাপে বিজ্ঞাপনের জন্য WebView API ইন্টিগ্রেট করতে সাহায্য করার জন্য তৈরি করা হয়েছে।

শুরু করার আগে

বিজ্ঞাপনের জন্য WebView API ব্যবহার করা শুরু করার আগে, নিম্নলিখিত কাজগুলি করেছেন কিনা তা নিশ্চিত করুন:

• আপনার অ্যাপে 3.0.0 বা তার পরবর্তী যেকোনও ভার্সনের সাথে Flutter প্লাগ-ইনের জন্য Google Mobile Ads Flutter Plugin ব্যবহার করুন।
• আপনার pubspec.yaml ফাইলে webview_flutter ডিপেন্ডেন্সি হিসেবে যোগ করুন।
• আপনার অ্যাপে 3.7.0 বা তার পরবর্তী ভার্সনের সাথে webview_flutter_android যোগ করুন।

অ্যাপ্লিকেশন শনাক্তকারীর জন্য চেক বাইপাস করুন

Android

APPLICATION_ID-এর জন্য চেক বাইপাস করতে আপনার AndroidManifest.xml ফাইলে নিম্নলিখিত <meta-data> ট্যাগ যোগ করুন। আপনি এই ধাপটি মিস করলে, Google Mobile Ads Flutter Plugin অ্যাপ চালু করার সময় IllegalStateException দেখাতে পারে।

<!-- Bypass APPLICATION_ID check for WebView API for Ads -->
<meta-data
    android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
    android:value="webview"/>

iOS

GADApplicationIdentifier-এর জন্য চেক বাইপাস করতে, নিচে দেওয়া কী ও স্ট্রিং ভ্যালু সহ Runner/Info.plist ফাইল আপডেট করুন। আপনি এই ধাপটি মিস করলে, অ্যাপ চালু করার সময় Google Mobile Ads Flutter Plugin GADInvalidInitializationException দেখাতে পারে।

<!-- Bypass GADApplicationIdentifier check for WebView API for Ads -->
<key>GADIntegrationManager</key>
<string>webview</string>

WebViewController রেজিস্টার করুন

AdSense কোড বা Google প্রকাশক ট্যাগ ব্যবহার করে এমন WebViewController-এর মধ্যে ইন-অ্যাপ বিজ্ঞাপন মনিটাইজেশন উন্নত করতে, নিচে তালিকাভুক্ত ধাপগুলি অনুসরণ করুন:

1. WebViewController-এ জাভাস্ক্রিপ্ট চালু করুন। এটি না করলে বিজ্ঞাপন লোড নাও হতে পারে।

2. আপনার ব্যবহারকারীদের বিজ্ঞাপনের অভিজ্ঞতা উন্নত করতে এবং Chrome-এর কুকি নীতি মেনে চলতে, আপনার AndroidWebViewController ইনস্ট্যান্সে থার্ড-পার্টি কুকি চালু করুন।

3. Google Mobile Ads Flutter Plugin-এর প্রদান করা registerWebView() মেথড কল করে WebViewController ইনস্ট্যান্স রেজিস্টার করুন।

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);
  }
}

URL লোড করুন

আপনি এখন WebViewController-এর মাধ্যমে URL লোড করতে এবং আপনার ওয়েব কন্টেন্ট দেখাতে পারবেন। আমরা সাজেস্ট করি যে আপনি এই টেস্ট URL লোড করুন: https://google.github.io/webview-ads/test/ যাতে নিজের URL ব্যবহার করার আগে ইন্টিগ্রেশন টেস্ট করতে পারেন। জাভাস্ক্রিপ্ট চালু করা না থাকলে, ওয়েব পেজে একটি সমস্যা দেখানো হবে।

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);

    // 4. Load the URL.
    await controller.loadRequest(Uri.parse('https://google.github.io/webview-ads/test/'));
  }

নিম্নলিখিত শর্ত প্রযোজ্য হলে, টেস্ট URL সফল ইন্টিগ্রেশনের জন্য সবুজ রঙের স্ট্যাটাস বার দেখায়:

• WebView, Google Mobile Ads Flutter Plugin-এ কানেক্টেড
• জাভাস্ক্রিপ্ট চালু করা আছে
• থার্ড-পার্টি কুকি কাজ করে (iOS ডিভাইসে প্রত্যাশিত নয়)
• ফার্স্ট-পার্টি কুকি কাজ করে

আমাদের টেস্ট URL-এর সোর্স কোড দেখুন। তারপর আপনি টেস্ট URL-এর জায়গায় আপনার URL ব্যবহার করতে পারবেন। এছাড়াও, আপনি Charles-এর মতো প্রক্সি টুল ব্যবহার করে আপনার অ্যাপের HTTPS ট্রাফিক ক্যাপচার করতে এবং &scar= প্যারামিটারের জন্য বিজ্ঞাপনের অনুরোধ পরীক্ষা করতে পারেন।