ادغام کردن «میانای برنامه‌سازی کاربردی وب‌نما برای تبلیغات»

انتخاب پلاتفرم: Android iOS Android (قدیمی)

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

روش کار

ارتباط با GMA Next-Gen SDK فقط در پاسخ به رویدادهای آگهی اتفاق می‌افتد که توسط هریک از موارد زیر راه‌اندازی می‌شوند:

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

پیش‌نیازها

شناسه برنامه را به کیت توسعه نرم‌افزار ارسال کنید

اگر ازقبل شناسه برنامه AdMob دارید، GMA Next-Gen SDK را با شناسه برنامه موجودتان مقداردهی اولیه کنید.

اگر شناسه برنامه AdMob ندارید، InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID را به‌عنوان شناسه برنامه وقتی GMA Next-Gen SDK را مقداردهی اولیه می‌کنید بگذرانید.

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

جاوا

MobileAds.initialize(
    this,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

ثبت نمای وب

برای ایجاد اتصال با مدیریت‌کننده‌های JavaScript در کد AdSense یا «برچسب ناشر Google» در هر نمونه WebView، در رشته اصلی registerWebView() تماس بگیرید. این کار باید در اسرع وقت انجام شود، مثلاً در روش onCreate() در MainActivity شما.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.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.libraries.ads.mobile.sdk.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);
  }
}

آزمایش کردن یکپارچه‌سازی

پیش‌از استفاده از نشانی وب خودتان، توصیه می‌کنیم نشانی وب زیر را برای آزمایش ادغام بار کنید:

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

اگر شرایط زیر برقرار باشد، نشانی وب آزمایش نوارهای وضعیت سبز را برای یکپارچه‌سازی موفق نشان می‌دهد:

  • ‫WebView به GMA Next-Gen SDK متصل شد

مراحل بعدی

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