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

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

روش کار

ارتباط با Google Mobile Ads SDK (Legacy) فقط در پاسخ به رویدادهای آگهی اتفاق می‌افتد که توسط هریک از موارد زیر راه‌اندازی می‌شوند:

• کد AdSense
• برچسب ناشر Google
• IMA برای HTML5

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

پیش‌نیازها

• Google Mobile Ads SDK (Legacy) نسخه 20.6.0 یا بالاتر.

• سطح میانای برنامه‌سازی کاربردی Android 21 یا بالاتر.

• برچسب <meta-data> زیر را در فایل AndroidManifest.xml اضافه کنید تا از بررسی APPLICATION_ID رد شوید. اگر این مرحله را ازدست بدهید و برچسب <meta-data> را ارائه نکنید، Google Mobile Ads SDK (Legacy) در شروع برنامه 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"/>
  

ثبت نمای وب

برای ایجاد اتصال با مدیریت‌کننده‌های JavaScript در کد AdSense یا «برچسب ناشر Google» در هر نمونه WebView، در رشته اصلی registerWebView() تماس بگیرید. این کار باید در اسرع وقت انجام شود، مثلاً در روش 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);
  }
}

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

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

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

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

• ‫WebView به Google Mobile Ads SDK (Legacy) متصل شد

مراحل بعدی

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