הגדרת WebView

אם Android באפליקציה נעשה שימוש WebView כדי להציג תוכן מהאינטרנט, מומלץ להגדיר אותה כך שאפשר יהיה לייצר הכנסות מהתוכן באופן אופטימלי באמצעות מודעות.

במדריך הזה מוסבר איך לספק מידע על אופן ההגדרה של אובייקטWebView .

הפעלת קובצי cookie של צד שלישי

כדי לשפר את חוויית הצופה במודעה ולציית למדיניות של Chrome בנושא קובצי cookie, מומלץ להפעיל קובצי cookie של צד שלישי במכונה של WebView.

Java

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);

Kotlin

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)

הגדרות אינטרנט

הגדרות ברירת המחדל של WebView לא אופטימליות למודעות. משתמשים בממשקי ה-API של WebSettings כדי להגדיר את WebView עבור:

  • JavaScript
  • גישה לאחסון המקומי
  • הפעלה אוטומטית של הסרטון

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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
  }
}

בדיקה של תצוגת האינטרנט

במהלך פיתוח האפליקציה, מומלץ לטעון את כתובת ה-URL הבאה לבדיקה:

https://webview-api-for-ads-test.glitch.me#webview-settings-tests

כדי לוודא שלהגדרות האלה יש השפעה מכוונת על מודעות.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);

    // Load the URL for testing.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me");
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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

    // Load the URL for testing.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me")
  }
}

לכתובת ה-URL לבדיקה יש קריטריונים להצלחה של אינטגרציה מלאה, אם מתקיימים התנאים הבאים:

הגדרות של תצוגה מפורטת באינטרנט

  • קובצי cookie של צד שלישי פועלים
  • קובצי cookie מהדומיין הנוכחי פועלים
  • JavaScript מופעל
  • אחסון DOM מופעל

מודעת וידאו

  • מודעת הווידאו מופעלת ברצף ואינה נפתחת בנגן המובנה במסך מלא
  • מודעת הווידאו מופעלת באופן אוטומטי מבלי ללחוץ על לחצן ההפעלה
  • מודעת הווידאו ניתנת להפעלה מחדש

אחרי שהבדיקה מסתיימת, צריך להחליף את כתובת ה-URL לבדיקה בכתובת ה-URL שרוצים לטעון את תצוגת האינטרנט.