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

‫Web view 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.
          });

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

Call registerWebView() on the main thread to establish a connection with the JavaScript handlers in the AdSense code or Google Publisher Tag within each WebView instance. این کار باید در اسرع وقت انجام شود، مثلاً در روش 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 رضایت جمع‌آوری کنید. میاناهای برنامه‌سازی کاربردی نمای وب برای آگهی‌ها، رضایت جمع‌آوری‌شده در بافت برنامه تلفن همراه را بااستفاده از چارچوب‌های رعایت IAB TCF v2.3 یا IAB CCPA به برچسب‌های موجود در نماهای وب شما منتقل نمی‌کند. اگر به‌عنوان مالک WebView و محتوای وب مربوط به آن که از آن درآمدزایی می‌شود، علاقه‌مند به پیاده‌سازی یک جریان موافقت واحد هستید، با پلاتفرم مدیریت موافقت خود همکاری کنید تا موافقت را در زمینه WebView جمع‌آوری کنید.