WebView API برای تبلیغات را ادغام کنید

APIهای نمای وب برای تبلیغات، سیگنال‌های برنامه را در دسترس تگ‌های موجود در WebView شما قرار می‌دهند و به بهبود کسب درآمد برای ناشرانی که محتوا را ارائه داده‌اند و محافظت از تبلیغ‌کنندگان در برابر هرزنامه کمک می‌کنند. این سیگنال‌های برنامه، مانند شناسه برنامه و نسخه برنامه، به فعال‌سازی موارد استفاده از گزارش‌دهی و هدف‌گیری موجودی مرورگر درون برنامه‌ای کمک می‌کنند که در غیر این صورت فقط در ترافیک برنامه در دسترس هستند.

چگونه کار می‌کند؟

ارتباط با SDK تبلیغات موبایلی گوگل فقط در پاسخ به رویدادهای تبلیغاتی ناشی از هر یک از موارد زیر اتفاق می‌افتد:

• کد ادسنس
• برچسب ناشر گوگل
• IMA برای HTML5

SDK، کنترل‌کننده‌های پیام را به WebView ثبت‌شده اضافه می‌کند تا به این رویدادهای تبلیغاتی گوش دهد. برای درک بهتر نحوه‌ی کار، کد منبع صفحه‌ی آزمایشی را مشاهده کنید.

پیش‌نیازها

• نسخه ۲۰.۶.۰ یا بالاتر از SDK تبلیغات موبایلی گوگل .

• اندروید API سطح ۲۱ یا بالاتر.

• تگ <meta-data> زیر را در فایل AndroidManifest.xml خود اضافه کنید تا از بررسی APPLICATION_ID عبور کنید. اگر این مرحله را از دست بدهید و تگ <meta-data> را ارائه ندهید، SDK تبلیغات موبایل گوگل در هنگام شروع برنامه، خطای IllegalStateException را صادر می‌کند.

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

نمای وب را ثبت کنید

برای برقراری ارتباط با کنترل‌کننده‌های جاوا اسکریپت در کد AdSense یا تگ Google Publisher در هر نمونه WebView ، تابع registerWebView() را در thread اصلی فراخوانی کنید. این کار باید در اسرع وقت، مثلاً در متد onCreate() در MainActivity شما، انجام شود.

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
  lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    webView = findViewById(R.id.webview)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false

    // Register the web view.
    MobileAds.registerWebView(webView)
  }
}

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.gms.ads.MobileAds;

public class MainActivity extends AppCompatActivity {
  private WebView webView;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    webView = findViewById(R.id.webview);

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
    // Let the web view use JavaScript.
    webView.getSettings().setJavaScriptEnabled(true);
    // Let the web view access local storage.
    webView.getSettings().setDomStorageEnabled(true);
    // Let HTML videos play automatically.
    webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

    // Register the web view.
    MobileAds.registerWebView(webView);
  }
}

ادغام خود را آزمایش کنید

قبل از استفاده از URL خودتان، توصیه می‌کنیم URL زیر را برای آزمایش ادغام بارگذاری کنید:

https://google.github.io/webview-ads/test/#api-for-ads-tests

در صورت وجود شرایط زیر، URL آزمایشی نوارهای وضعیت سبز را برای ادغام موفقیت‌آمیز نشان می‌دهد:

• WebView به SDK تبلیغات موبایلی گوگل متصل است

مراحل بعدی

• جمع‌آوری رضایت در WebView . رابط‌های برنامه‌نویسی کاربردی (API) نمای وب برای تبلیغات، رضایت جمع‌آوری‌شده در زمینه برنامه تلفن همراه با استفاده از چارچوب‌های انطباق IAB TCF v2.0 یا IAB CCPA را به برچسب‌های موجود در نماهای وب شما منتقل نمی‌کند. اگر به پیاده‌سازی یک جریان رضایت واحد به عنوان مالک WebView و محتوای وب مربوطه که از آن درآمدزایی می‌شود علاقه‌مند هستید، با پلتفرم مدیریت رضایت خود برای جمع‌آوری رضایت در زمینه WebView همکاری کنید.