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

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

روش کار

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

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

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

پیش‌نیازها

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

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

• برچسب <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"/>
  

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

registerWebView() را در رشته اصلی فراخوانی کنید تا با گرداننده‌های جاوا اسکریپت در کد AdSense یا Google Publisher Tag در هر نمونه WebView ارتباط برقرار شود. این کار باید در اسرع وقت انجام شود، مثلاً در روش 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 جمع‌آوری کنید. میاناهای برنامه‌سازی کاربردی نمای وب برای آگهی‌ها، رضایت جمع‌آوری‌شده در بافت برنامه تلفن همراه را بااستفاده از چارچوب‌های رعایت IAB TCF v2.3 یا IAB CCPA به برچسب‌های موجود در نماهای وب شما منتشر نمی‌کند. اگر به‌عنوان مالک WebView و محتوای وب مربوط به آن که از آن درآمدزایی می‌شود، علاقه‌مند به پیاده‌سازی یک جریان موافقت واحد هستید، با پلاتفرم مدیریت موافقت خود همکاری کنید تا موافقت را در زمینه WebView جمع‌آوری کنید.