MobileAds

Kotlin |Java

class MobileAds

Sınıf, Google Mobile Ads SDK'sına bir bütün olarak uygulanan mantığı içerir. Şu anda yalnızca başlatma için kullanılan yöntemler vardır.

Özet

Sabitler
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Google Mobile Ads SDK'sı için varsayılan hata alanı adı.

Herkese açık işlevler
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` Uyumlulaştırma bağdaştırıcısı başlatmayı devre dışı bırakmak için `initialize` öncesinde veya ilk reklam isteğinden önce çağrı yapın.
`java-static InitializationStatus?`	`getInitializationStatus()` SDK başlatma durumunu alır.
`java-static RequestConfiguration`	`getRequestConfiguration()` Genel `RequestConfiguration` değerini alır.
`java-static VersionInfo!`	`getVersion()` Google Mobile Ads SDK'sının harici sürümünü (ör. 20.6.0) alır.
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` Google Mobile Ads SDK'sını ilk kullanıma hazırlar.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Google Mobile Ads SDK'sını ilk kullanıma hazırlar.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` Reklam inceleyici kullanıcı arayüzünü açar.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` Hata ayıklama menüsünü açar.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` Google Mobile Ads SDK yayıncı birinci taraf kimliğinin (eski adıyla aynı uygulama anahtarı) etkin olup olmadığını kontrol eder.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` Bu `CustomTabsClient` içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir `CustomTabsSession` kaydeder.
`java-static Unit`	`registerWebView(webview: WebView)` Bu `WebView` içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir `WebView` kaydeder.
`java-static Unit`	`setAppMuted(muted: Boolean)` Uygulamanın sesinin kapatılıp kapatılmadığını gösterir.
`java-static Unit`	`setAppVolume(volume: Float)` Uygulamanın ses düzeyini ayarlar.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` Uygulama oturumu sırasında her `AdRequest` için kullanılacak genel `RequestConfiguration` değerini ayarlar.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` Bu işlev kullanımdan kaldırılmıştır. Bunun yerine `start` veya `start` kullanın.

Sabitler

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Google Mobile Ads SDK'sı için varsayılan hata alanı adı.

Herkese açık işlevler

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

Uyumlulaştırma bağdaştırıcısı başlatmayı devre dışı bırakmak için initialize öncesinde veya ilk reklam isteğinden önce çağrı yapın. Bu yöntem, initialize veya ilk reklam isteği yapıldıktan sonra no-op olur.

Uyarı: Bu yöntemin çağrılması, arabuluculuk performansınızı olumsuz etkileyebilir. Bu yöntem yalnızca uygulamanıza uyumlulaştırma bağdaştırıcıları eklediyseniz ancak bu uygulama oturumu sırasında Google uyumlulaştırmayı kullanmayı planlamıyorsanız (ör. A/B testi yapıyorsanız) çağrılmalıdır.

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

SDK başlatma durumunu alır.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Genel RequestConfiguration değerini alır.

getVersion

java-static fun getVersion(): VersionInfo!

Google Mobile Ads SDK'sının harici sürümünü (ör. 20.6.0) alır.

Bu işlevden önce initialize işlevinin çağrılması gerekmez.

ilk kullanıma hazırlamak

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Google Mobile Ads SDK'sını ilk kullanıma hazırlar.

Oturumun ilk reklam isteğindeki gecikmeyi azaltmak için bu yöntemi uygulama başlatıldıktan sonra mümkün olan en kısa sürede çağırın.

Bu yöntem çağrılmazsa ilk reklam isteği, Google Mobile Ads SDK'sını otomatik olarak başlatır.

Parametreler
`context: Context!`	SDK'nın çalıştığı `Context`.

ilk kullanıma hazırlamak

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Google Mobile Ads SDK'sını ilk kullanıma hazırlar.

Oturumun ilk reklam isteğindeki gecikmeyi azaltmak için bu yöntemi uygulama başlatıldıktan sonra mümkün olan en kısa sürede çağırın.

Bu yöntem çağrılmazsa ilk reklam isteği, Google Mobile Ads SDK'sını otomatik olarak başlatır.

Parametreler
`context: Context!`	SDK'nın `Context` çalıştığı etkinlik.
`listener: OnInitializationCompleteListener!`	İlk kullanıma hazırlama tamamlandığında çağrılacak geri çağırma.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

Reklam inceleyici kullanıcı arayüzünü açar.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

Hata ayıklama menüsünü açar. Bu işlevden önce initialize çağrılmalıdır.

Parametreler
`context: Context!`	SDK'nın `Context` çalıştığı etkinlik.
`adUnitId: String!`	Uygulamanızla ilişkili tüm Ad Manager reklam birimi kimlikleri.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

Google Mobile Ads SDK yayıncı birinci taraf kimliğinin (eski adıyla aynı uygulama anahtarı) etkin olup olmadığını kontrol eder.

Kimlik varsayılan olarak etkindir. Devre dışı bırakıldığında ayar, uygulama oturumları arasında kalıcı olur ve kimlik temizlenir.

Bu işlevden önce initialize çağrılmalıdır.

Parametreler
`enabled: Boolean`	Yayıncı birinci taraf kimliği etkinse doğru, aksi takdirde yanlış değerini döndüren boole.

İadeler
`Boolean`	Karar başarıyla kalıcı hale getirilirse doğru (true) olur. Kalıcı hale getirilemezse yanlış değerini alır.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

Bu CustomTabsClient içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir CustomTabsSession kaydeder. Bu işlem yalnızca bir CustomTabsSession örneği oluşturur ve bu komutun tekrar çalıştırılması mevcut oturumu geçersiz kılar.

Parametreler
`context: Context`	SDK'nın çalıştığı `Context`.
`client: CustomTabsClient`	`CustomTabsSession` örneğini oluşturmak için kullanılan `CustomTabsClient`.
`origin: String`	Doğrulama için Digital Asset Link'te kaynak olarak kullanılan dize.
`callback: CustomTabsCallback?`	`CustomTabsSession` tarafından geri aranmak için isteğe bağlı `CustomTabsCallback`.

İadeler
`CustomTabsSession?`	Özel Sekmeler sayfası açılırken Özel Sekmeler Amacı için kullanılacak `CustomTabsSession` örneği.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

Bu WebView içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir WebView kaydeder.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

Uygulamanın sesinin kapatılıp kapatılmadığını gösterir. Tüm reklamların ilk sessize alma durumunu etkiler.

Uyarı: Uygulamanızın sesini kapatmak, video reklam uygunluğunu azaltır ve uygulamanızın reklam gelirini düşürebilir. Bu API'yi yalnızca uygulamanızda kullanıcıya özel bir sessize alma denetimi sunuluyorsa kullanmalı ve kullanıcının sessize alma kararını bu API'ye yansıtmalısınız.

Parametreler
`muted: Boolean`	Uygulama sessize alınmışsa doğru, aksi takdirde yanlış. Varsayılan olarak false değerine ayarlanır.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

Uygulamanın ses düzeyini ayarlar. Diğer ses çıkışlarına kıyasla tüm reklamların ses düzeylerini etkiler.

Uyarı: Uygulamanızın ses düzeyini düşürmek, video reklam uygunluğunu azaltır ve uygulamanızın reklam gelirini düşürebilir. Bu API'yi yalnızca uygulamanız kullanıcıya özel ses düzeyi denetimleri sunuyorsa kullanmalı ve kullanıcının ses düzeyi seçimini bu API'ye yansıtmalısınız.

Parametreler
`volume: Float`	0 (sessiz) ile 1,0 (tam medya ses düzeyi) arasında değişen kayan nokta olarak ses düzeyi. Varsayılan olarak 1,0 değerine ayarlanır.

Verdiği hatalar
`java.lang.IllegalArgumentException`	Hacim geçerli aralığın dışındaysa

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

Uygulama oturumu sırasında her AdRequest için kullanılacak genel RequestConfiguration değerini ayarlar.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

Belirli yapılandırmalar için reklamları önceden yüklemeye başlar.

Reklam önceden yükleme API'leri sınırlı alfa sürümündedir. Daha fazla bilgi için lütfen hesap yöneticinizle iletişime geçin.

Parametreler
`context: Context`	SDK'nın çalıştığı `Context`.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	Reklamları önceden yükleme yapılandırmaları.
`preloadCallback: PreloadCallback`	Her önceden yükleme yapılandırması için reklam kullanılabilirliği değiştiğinde çağrılacak bir geri çağırma.