Interfejsy WebView API for Ads udostępniają sygnały z aplikacji tagom w WebView, co pomaga zwiększyć przychody wydawców, którzy udostępnili treści, i chronić reklamodawców przed spamem.
Te sygnały z aplikacji, takie jak identyfikator i wersja aplikacji, pomagają aktywować przypadki użycia Raportowania i Kierowania na zasoby reklamowe przeglądarki w aplikacji, które w inny sposób są dostępne tylko w przypadku ruchu w aplikacji.
Jak to działa
Komunikacja z GMA Next-Gen SDK odbywa się tylko w odpowiedzi na zdarzenia reklamowe wywoływane przez dowolne z tych działań:
Pakiet SDK dodaje do zarejestrowanego obiektu WebView moduły obsługi wiadomości, aby nasłuchiwać tych zdarzeń związanych z reklamami. Aby lepiej zrozumieć, jak to działa, wyświetl kod źródłowy strony testowej.
Wymagania wstępne
- GMA Next-Gen SDK w wersji 0.6.0-alpha01 lub nowszej.
Przekazywanie identyfikatora aplikacji do pakietu SDK
Jeśli masz już identyfikator aplikacji Ad Managera, zainicjuj GMA Next-Gen SDK za pomocą tego identyfikatora.
Jeśli nie masz identyfikatora aplikacji Ad Managera, podczas inicjowania GMA Next-Gen SDK przekaż wartość InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID jako identyfikator aplikacji.
Kotlin
MobileAds.initialize(
this@MainActivity,
// Use this application ID to initialize the GMA Next-Gen SDK if
// you don't have an Ad Manager application ID.
InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
.build(),
) {
// Adapter initialization complete.
}
Java
MobileAds.initialize(
this,
// Use this application ID to initialize the GMA Next-Gen SDK if
// you don't have an Ad Manager application ID.
new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
Rejestrowanie widoku internetowego
Wywołaj
registerWebView()
w głównym wątku, aby nawiązać połączenie z procedurami obsługi JavaScriptu w kodzie AdSense lub tagu wydawcy Google w każdym wystąpieniu WebView. Należy to zrobić jak najszybciej, np. w metodzie onCreate() obiektu 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)
}
}
Java
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);
}
}
Testowanie integracji
Zanim zaczniesz używać własnego adresu URL, zalecamy wczytanie tego adresu URL, aby przetestować integrację:
https://google.github.io/webview-ads/test/#api-for-ads-tests
Jeśli integracja przebiegła pomyślnie, przy adresie URL testu pojawią się zielone paski stanu, pod warunkiem że:
- Urządzenie
WebViewpołączono z urządzeniem GMA Next-Gen SDK
Dalsze kroki
- Uzyskiwanie zgody użytkowników w
WebView. Interfejsy Web view API do reklam nie przekazują do tagów w widokach internetowych zgody zebranej w kontekście aplikacji mobilnej za pomocą Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 ani Zasad IAB dotyczących ochrony prywatności w Stanach Zjednoczonych. Jeśli jesteś właścicielem zarównoWebView, jak i odpowiedniej treści internetowej, na której zarabiasz, i chcesz wdrożyć jeden proces uzyskiwania zgody, współpracuj z platformą do zarządzania zgodą użytkowników, aby zbierać zgody w kontekścieWebView.