MobileAds

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

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.
static @Nullable InitializationStatus

SDK başlatma durumunu alır.
static @NonNull RequestConfiguration

Küresel RequestConfiguration değerini alır.
static VersionInfo

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

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

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

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

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 kapalı olup olmadığını belirtir.
static void
setAppVolume(float volume)

Uygulamanın ses düzeyini ayarlar.
static void
setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Uygulamanın oturumu sırasında her AdRequest için kullanılacak genel RequestConfiguration değerini belirler.
static void
startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

Bu yöntemin desteği sonlandırılmıştır.

Bunun yerine başlangıç veya başlangıç kelimelerini 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 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

public static @Nullable InitializationStatus getInitializationStatus()

SDK başlatma durumunu alır.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

ilk kullanıma hazırlama

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
OnInitializationCompleteListener listener

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

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

Parametreler
Context context

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

Uygulamanızla ilişkili tüm Ad Manager reklam birimi kimlikleri.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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
@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 dijital öğe bağlantısında kaynak olarak kullanılan dize.
@Nullable CustomTabsCallback callback

isteğe bağlı CustomTabsCallback, .
İadeler
@Nullable CustomTabsSession

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

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 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
boolean muted

Uygulama sessize alınmışsa doğru, aksi takdirde yanlış değerini döndürür. Varsayılan değer yanlıştı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 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
float volume

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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

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
@NonNull Context context

SDK'nın çalıştığı Context.
@NonNull List<PreloadConfiguration> preloadConfigurations

Reklamları önceden yüklemek için kullanılan yapılandırmalar.
@NonNull 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.