MobileAds

class MobileAds


Sınıf, Google Mobile Ads SDK'sı için geçerli olan mantığı bir bütün olarak içerir. Şu anda bu klasördeki tek yöntemler ilk başlatma için kullanılmaktadı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

Uyumlulaştırma bağdaştırıcısı başlatmayı devre dışı bırakmak için initialize veya ilk reklam isteği öncesinde çağırın.

java-static InitializationStatus?

SDK başlatma durumunu alır.

java-static RequestConfiguration

Küresel RequestConfiguration değerini alır.

java-static VersionInfo!

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

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

java-static Unit

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

Google Mobile Ads SDK'sı 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 CustomTabsSession içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir CustomTabsClient kaydeder.

java-static 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.

java-static Unit

Uygulamanın sesinin kapalı olup olmadığını belirtir.

java-static Unit

Uygulamanın ses düzeyini ayarlar.

java-static Unit

Uygulamanın oturumu sırasında her AdRequest için kullanılacak genel RequestConfiguration değerini belirler.

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

Bu işlev kullanımdan kaldırılmıştır.

Bunun yerine başlangıç veya başlangıç kelimelerini 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 veya ilk reklam isteği öncesinde çağırın. Bu yöntem, initialize veya ilk reklam isteği yapıldıktan sonra hiçbir işlem yapmaz.

Uyarı: Bu yöntemi çağırmak uyumlulaştırma performansınızı olumsuz etkileyebilir. Bu yöntem yalnızca uygulamanıza uyumlulaştırma bağdaştırıcısı eklediyseniz ancak bu uygulama oturumu sırasında Google uyumlulaştırmayı kullanmayı planlamıyorsanız (ör. bir A/B testi çalıştırı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

Küresel 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ına gerek yoktur.

ilk kullanıma hazırlama

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

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

Oturumdaki ilk reklam isteğinin gecikmesini azaltmak için bu yöntemi uygulama başlatıldıktan sonra olabildiğince erken çağırın.

Bu yöntem çağrılmazsa ilk reklam isteği Google Mobile Ads SDK'sını otomatik olarak ilk kullanıma hazırlar.

Parametreler
context: Context!

SDK'nın çalıştığı Context.

ilk kullanıma hazırlama

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

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

Oturumdaki ilk reklam isteğinin gecikmesini azaltmak için bu yöntemi uygulama başlatıldıktan sonra olabildiğince erken çağırın.

Bu yöntem çağrılmazsa ilk reklam isteği Google Mobile Ads SDK'sını otomatik olarak ilk kullanıma hazırlar.

Parametreler
context: Context!

SDK'nın çalıştığı Context etkinliği.

listener: OnInitializationCompleteListener!

İlk kullanıma hazırlama işlemi tamamlandığında çağrılacak geri çağırma işlevi.

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. initialize, bu işlevden önce çağrılmalıdır.

Parametreler
context: Context!

SDK'nın çalıştığı Context etkinliği.

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'sı 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ı genelinde kalır ve kimlik silinir.

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

Parametreler
enabled: Boolean

boolean Yayıncı birinci taraf kimliği etkinse doğru, aksi takdirde yanlış değerini döndürür.

İadeler
Boolean

Karar başarıyla devam ettirilirse doğru değerini döndürür. Kalıcılaştırılamazsa yanlış değerini döndürür.

registerCustomTabsSession

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

Bu CustomTabsSession içindeki reklamların uygulama içi reklam gelirini artırmak için Google Mobile Ads SDK'sına bir CustomTabsClient kaydeder. Bu işlem yalnızca bir CustomTabsSession örneği oluşturur ve bu örneğin yeniden ç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 dijital öğe bağlantısında kaynak olarak kullanılan dize.

callback: CustomTabsCallback?

isteğe bağlı CustomTabsCallback, .

İadeler
CustomTabsSession?

CustomTabsSession Özel Sekmeler sayfası açıldığında Özel Sekmeler Amaç için kullanılacak örnek.

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 kapalı olup olmadığını belirtir. Tüm reklamların ilk sessiz 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ız kullanıcıya özel bir sessize alma denetimi sağlıyorsa kullanmalısınız 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ış değerini döndürür. Varsayılan değer yanlıştı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 seviyelerini etkiler.

Uyarı: Uygulamanızın ses seviyesini 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 sağlıyorsa kullanmalısınız 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 seviyesi. Varsayılan olarak 1,0 değerine ayarlanır.

Atışlar
java.lang.IllegalArgumentException

Ses seviyesi geçerli aralığın dışındaysa

setRequestConfiguration

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

Uygulamanın oturumu sırasında her AdRequest için kullanılacak genel RequestConfiguration değerini belirler.

startPreload

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

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

Reklam ön yükleme API'leri sınırlı alfa sürümündedir. Daha fazla bilgi için lütfen hesap yöneticinize ulaşın.

Parametreler
context: Context

SDK'nın çalıştığı Context.

preloadConfigurations: (Mutable)List<PreloadConfiguration!>

Reklamları önceden yüklemek için kullanılan yapılandırmalar.

preloadCallback: PreloadCallback

Her ön yükleme yapılandırması için reklam kullanılabilirliği değiştiğinde çağrılacak geri çağırma işlevi.