MobileAds

Kotlin |Java

public 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
`static final String`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Google Mobile Ads SDK'sı için varsayılan hata alanı adı.

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

Sabitler

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

Herkese açık yöntemler

disableMediationAdapterInitialization

public static void 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. 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

public static @Nullable InitializationStatus getInitializationStatus()

SDK başlatma durumunu alır.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Genel RequestConfiguration değerini alır.

getVersion

public static VersionInfo getVersion()

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)
public static void initialize(Context context)

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
`OnInitializationCompleteListener listener`	İlk kullanıma hazırlama tamamlandığında çağrılacak geri çağırma.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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.
`String adUnitId`	Uygulamanızla ilişkili tüm Ad Manager reklam birimi kimlikleri.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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
`boolean enabled`	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

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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
`@NonNull Context context`	SDK'nın çalıştığı `Context`.
`@NonNull CustomTabsClient client`	`CustomTabsSession` örneğini oluşturmak için kullanılan `CustomTabsClient`.
`@NonNull String origin`	Doğrulama için Digital Asset Link'te kaynak olarak kullanılan dize.
`@Nullable CustomTabsCallback callback`	`CustomTabsSession` tarafından geri aranmak için isteğe bağlı `CustomTabsCallback`.

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

registerWebView

public static void registerWebView(@NonNull 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.

setAppMuted

public static void setAppMuted(boolean muted)

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
`boolean muted`	Uygulama sessize alınmışsa doğru, aksi takdirde yanlış. Varsayılan olarak false değerine ayarlanır.

setAppVolume

public static void setAppVolume(float volume)

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
`float volume`	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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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
`@NonNull Context context`	SDK'nın çalıştığı `Context`.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Reklamları önceden yükleme yapılandırmaları.
`@NonNull 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.