@google/mobile-ads modülü, Google Mobile Ads'i React Native uygulamalarına entegre etmek için temel TypeScript arayüzlerini, sınıflarını ve üst düzey işlevlerini sağlar.
Genel Bakış
-
SDK yaşam döngüsü ve başlatma: SDK'yı başlatmak için
initializeileInitializationConfig'ü kullanın ve bağdaştırıcı başlatma durumlarınıgetInitializationStatusileInitializationStatuskullanarak inceleyin. -
Kullanıcı Mesajlaşma Platformu (UMP): Kullanıcı rızasını
requestConsentInfoUpdate,loadAndShowConsentFormIfRequiredveshowPrivacyOptionsFormile yönetin,getConsentStatusvecanRequestAdsile rıza durumunu inceleyin. -
İstek Yapılandırması:
setRequestConfigurationveRequestConfigurationile genel hedefleme ve politika ayarlarını tanımlayın.AgeRestrictedTreatment,MaxAdContentRatingvePublisherPrivacyPersonalizationStategibi seçenekleri yapılandırın. -
Reklam Biçimleri:
AppOpenAd,InterstitialAd,RewardedAdveRewardedInterstitialAdgibi biçim sınıflarını kullanarak reklamları yükleyin ve sunun. -
Geliştirici Araçları:
openAdInspectorveyaopenDebugMenukullanarak reklam yayını, bağdaştırıcı durumu ve SDK yapılandırmalarını anında inceleyin.
| Tür Takma Adları | |
|---|---|
Adapter
|
Bir arabuluculuk bağdaştırıcısının olası başlatma durumlarını gösterir.
|
Ad
|
Reklam görünümünde Reklam Seçenekleri simgesinin konumları. |
Ad
|
İstenen reklamın biçimi. |
Ad
|
Reklam inceleyicinin neden başarısız olduğuna dair hata bilgileri.
|
Ad
|
Reklam inceleyicinin açılmasını veya çalışmasını etkileyen hatalar.
|
Ad
|
Satır içi uyarlanabilir ve büyük sabit uyarlanabilir banner reklamlar için yön seçenekleri.
|
Ad
|
Bir reklamın boyutlarını gösterir. |
Age
|
Reklam istekleri için yaş kısıtlamalı değerlendirme seçeneklerini tanımlar.
|
Consent
|
İzin durumu değerleri. |
Debug
|
Coğrafi bölgeyi test etmek için hata ayıklama değerleri. |
Form
|
Kullanıcı Mesajlaşma Platformu (UMP) formu işlem hatalarıyla ilgili hata kodlarını gösterir.
|
Full
|
|
Load
|
Reklam yükleme işlemi hatalarıyla ilgili hata kodlarını gösterir.
|
Max
|
Uygulamanın maksimum reklam içeriği derecelendirmesini tanımlar ve gösterilebilecek reklam türlerini sınıflandırır.
|
Native
|
Standart doğal reklam öğelerini tanımlamak için kullanılan adlar.
|
Native
|
Yüklenen bir doğal reklamın biçimini tanımlar. |
Native
|
Döndürülen doğal reklam medyalarının en boy oranıyla ilgili tercihler.
|
On
|
Reklam inceleyici kullanıcı arayüzü kapandığında çağrılacak bir geri çağırma için arayüz tanımı.
|
Precision
|
Bildirilen reklam değerinin hassasiyeti. |
Privacy
|
Gizlilik seçenekleri şart durumu. |
Publisher
|
Yayıncı gizlilik değerlendirmesi kişiselleştirme durumlarını gösterir.
|
Resize
|
NativeAdMediaView'da resim içeriğinin yeniden boyutlandırma modunu özelleştirme seçenekleri.
|
Resolved
|
Bir reklam yüklendikten sonra reklam boyutunun nihai çözümlenmiş durumunu gösterir.
|
Swipe
|
Özel tıklama kaydırma hareketleriyle ilgili talimatlar. |
| Değişkenler | |
|---|---|
Ad
|
Önceden tanımlanmış reklam boyutları ve uyarlanabilir ve özel boyutlar oluşturmaya yardımcı yöntemler.
|
| İşlevler | |
|---|---|
can
|
Mevcut izin durumunun reklam isteğinde bulunmanıza izin verip vermediğini kontrol eder.
|
get
|
Kullanıcının mevcut izin durumunu alır. |
get
|
SDK başlatma durumunu alır. |
get
|
Uygulamanız için gizlilik seçenekleri giriş noktası gerekip gerekmediğini kontrol eder.
|
get
|
Genel istek yapılandırmasını alır. |
initialize
|
Google Mobile Ads SDK'sını başlatır. |
is
|
İzin formunun olup olmadığını kontrol eder. |
load
|
Mevcut izin durumu gerektiriyorsa (ör. durum REQUIRED ise) bir izin formu yükler ve kullanıcıya gösterir.
|
open
|
Google Mobile Ads SDK'sı Reklam İnceleyici yer paylaşımını açar.
|
open
|
Hata ayıklama menüsünü açar. |
parse
|
Reklam yükleme sırasında oluşan yerel hatayı ayrıştırır ve LoadAdError ile sarmalar.
|
request
|
İzin bilgisi güncelleme isteğinde bulunur. |
reset
|
Kalıcı depolama alanındaki tüm izin durumunu temizler.
|
set
|
Yayıncı birinci taraf kimliğinin etkinleştirilip etkinleştirilmediğini kontrol eder.
|
set
|
Uygunluk ve hedefleme için genel istek yapılandırmasını ayarlar.
|
set
|
Kullanıcı tarafından kontrol edilen uygulamanın ses seviyesini ayarlar.
|
set
|
Uygulamanın sesinin kapatılıp kapatılmayacağını belirler. |
show
|
Gizlilik seçenekleri formunu gösterir. |
Tür Takma Adları
AdapterState
AdapterState: typeof AdapterState[keyof typeof AdapterState]
AdChoicesPlacement
AdChoicesPlacement:
typeof AdChoicesPlacement[keyof typeof AdChoicesPlacement]
| Özellikler | |
|---|---|
BOTTOM_
|
Reklamın sol alt köşesi. |
BOTTOM_
|
Reklamın sağ alt köşesi. |
TOP_
|
Reklamın sol üst köşesi. |
TOP_
|
Reklamın sağ üst köşesi. |
AdFormat
AdInspectorError
AdInspectorError:
BaseError<AdInspectorErrorCode>
AdInspectorErrorCode
AdInspectorErrorCode:
typeof AdInspectorErrorCode[keyof typeof AdInspectorErrorCode]
AdOrientation
AdOrientation: typeof AdOrientation[keyof typeof AdOrientation]
| Özellikler | |
|---|---|
CURRENT
|
|
LANDSCAPE
|
|
PORTRAIT
|
|
AdSize
Bir reklamın boyutlarını gösterir.
Boyutlar, önceden tanımlanmış bir boyut kümesinden (ör. AdSize.LARGE_BANNER) veya uyarlanabilir bir boyuttan biri olabilir.
Boyutlar, önceden tanımlanmış bir boyut kümesinden (ör. AdSize.LARGE_BANNER) veya uyarlanabilir bir boyuttan biri olabilir.
AgeRestrictedTreatment
AgeRestrictedTreatment:
typeof AgeRestrictedTreatment[keyof typeof AgeRestrictedTreatment]
ConsentStatus
ConsentStatus: typeof ConsentStatus[keyof typeof ConsentStatus]
DebugGeography
DebugGeography: typeof DebugGeography[keyof typeof DebugGeography]
FormErrorCode
FormErrorCode: typeof FormErrorCode[keyof typeof FormErrorCode]
FullScreenContentErrorCode
FullScreenContentErrorCode:
typeof FullScreenContentErrorCode[keyof typeof FullScreenContentErrorCode]
| Özellikler | |
|---|---|
AD_
|
Reklam zaten gösterilmiş. |
AD_
|
Reklam gösterilmeye hazır değil. |
AD_
|
Reklam, sahne için çok büyük (yalnızca iOS). |
APP_
|
Uygulama ön planda değilse |
INTERNAL_
|
Dahili olarak bir sorun oluştu. Örneğin, reklam içeriği gösterilmeye hazırlanırken bir istisna oluştu.
|
MEDIATION_
|
Aracılık bağdaştırıcısı reklamı gösteremedi. Temel nedeni öğrenmek için
FullScreenContentError.mediationAdError
başlıklı makaleyi inceleyin.
|
UNKNOWN
|
Hata kodu, bilinen bir hata koduyla eşlenemedi.
|
LoadAdErrorCode
LoadAdErrorCode: typeof LoadAdErrorCode[keyof typeof LoadAdErrorCode]
MaxAdContentRating
MaxAdContentRating:
typeof MaxAdContentRating[keyof typeof MaxAdContentRating]
NativeAdAssetNames
NativeAdAssetNames:
typeof NativeAdAssetNames[keyof typeof NativeAdAssetNames]
NativeAdType
NativeAdType: typeof NativeAdType[keyof typeof NativeAdType]
| Özellikler | |
|---|---|
BANNER
|
Banner reklam. |
CUSTOM_
|
Özel doğal biçimli reklam. |
NATIVE
|
Doğal reklam. |
NativeMediaAspectRatio
NativeMediaAspectRatio:
typeof NativeMediaAspectRatio[keyof typeof NativeMediaAspectRatio]
OnAdInspectorClosedListener
OnAdInspectorClosedListener:
((error?) => void)
PrecisionType
PrecisionType: typeof PrecisionType[keyof typeof PrecisionType]
PrivacyOptionsRequirementStatus
PrivacyOptionsRequirementStatus:
typeof PrivacyOptionsRequirementStatus[keyof typeof PrivacyOptionsRequirementStatus]
| Özellikler | |
|---|---|
NOT_
|
Gizlilik seçenekleri giriş noktası gerekli değildir.
|
REQUIRED
|
Gizlilik seçenekleri giriş noktası gereklidir. |
UNKNOWN
|
Gizlilik seçenekleri şartının durumu bilinmiyor.
|
PublisherPrivacyPersonalizationState
PublisherPrivacyPersonalizationState: typeof PublisherPrivacyPersonalizationState[keyof typeof PublisherPrivacyPersonalizationState]
ResizeMode
ResizeMode: typeof ResizeMode[keyof typeof ResizeMode]
ResolvedAdSize
ResolvedAdSize:
FixedAdSize | FluidAdSize
Çoğu reklam için bu, tam
width ve height boyutlarına sahip bir FixedAdSize olarak çözümlenir.
Dinamik olarak boyutlandırılmış banner reklamlar için bu, boyutların görünüm hiyerarşisi tarafından yönetildiği bir FluidAdSize olarak çözümlenir.
SwipeGestureDirection
SwipeGestureDirection:
typeof SwipeGestureDirection[keyof typeof SwipeGestureDirection]
| Özellikler | |
|---|---|
DOWN
|
Ekranı aşağı kaydırın. |
LEFT
|
Sola kaydırın. |
RIGHT
|
Sağa kaydırın. |
UP
|
Yukarı kaydırın. |
Değişkenler
AdSize
AdSize: {
BANNER: FixedAdSize;
custom: ((width,
height) => FixedAdSize);
FLUID: FluidAdSize;
FULL_BANNER: FixedAdSize;
getCurrentOrientationInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
getInlineAdaptiveBannerAdSize: ((width,
maxHeight) => InlineAdaptiveAdSize);
getLandscapeInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
getLargeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
getLargeLandscapeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
getLargePortraitAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
getPortraitInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
LARGE_BANNER: FixedAdSize;
LEADERBOARD: FixedAdSize;
MEDIUM_RECTANGLE: FixedAdSize;
}
İşlevler
canRequestAds
canRequestAds(): boolean
Mevcut izin durumunun reklam isteğinde bulunmanıza izin verip vermediğini kontrol eder.
| İadeler | |
|---|---|
boolean
|
true Reklam isteğinde bulunabiliyorsanız,
false aksi takdirde.
|
getConsentStatus
getConsentStatus(): ConsentStatus
Kullanıcının mevcut izin durumunu alır.
| İadeler | |
|---|---|
ConsentStatus
|
Mevcut izin durumu. |
getInitializationStatus
getInitializationStatus(): InitializationStatus
SDK başlatma durumunu alır.
Bu yöntemi, SDK'nın başlatma işlemini tamamlayıp tamamlamadığını kontrol etmek ve tek tek uyumlulaştırma bağdaştırıcılarının durumunu incelemek için kullanın.
Bu yöntemi, SDK'nın başlatma işlemini tamamlayıp tamamlamadığını kontrol etmek ve tek tek uyumlulaştırma bağdaştırıcılarının durumunu incelemek için kullanın.
| İadeler | |
|---|---|
InitializationStatus
|
Mevcut başlatma durumu. |
getPrivacyOptionsRequirementStatus
getPrivacyOptionsRequirementStatus(): PrivacyOptionsRequirementStatus
Uygulamanız için gizlilik seçenekleri giriş noktası gerekip gerekmediğini kontrol eder.
Giriş noktası gerekiyorsa gizlilik seçenekleri formunu göstermek için showPrivacyOptionsForm işlevini çağıran, görünür ve etkileşimli bir kullanıcı arayüzü öğesini uygulamanıza ekleyin. Bir giriş noktası gerekmiyorsa kullanıcı arayüzü öğenizi görünür ve etkileşimli olmayacak şekilde yapılandırın.
Giriş noktası gerekiyorsa gizlilik seçenekleri formunu göstermek için showPrivacyOptionsForm işlevini çağıran, görünür ve etkileşimli bir kullanıcı arayüzü öğesini uygulamanıza ekleyin. Bir giriş noktası gerekmiyorsa kullanıcı arayüzü öğenizi görünür ve etkileşimli olmayacak şekilde yapılandırın.
| İadeler | |
|---|---|
PrivacyOptionsRequirementStatus
|
Gizlilik seçenekleri şart durumu. |
getRequestConfiguration
getRequestConfiguration(): RequestConfiguration
Genel istek yapılandırmasını alır.
Bu yöntemi, genel olarak uygulanmış olan mevcut istek yapılandırmasını almak için kullanın.
Bu yöntemi, genel olarak uygulanmış olan mevcut istek yapılandırmasını almak için kullanın.
| İadeler | |
|---|---|
RequestConfiguration
|
Mevcut genel istek yapılandırması. |
initialize
initialize(config,
onInitializationComplete?): void
Google Mobile Ads SDK'sını başlatır.
Bu yöntemi bir reklamı yüklemeden ve Google Mobile Ads SDK'sının geri kalanıyla etkileşimde bulunmadan önce çağırın.
Bu yöntemi bir reklamı yüklemeden ve Google Mobile Ads SDK'sının geri kalanıyla etkileşimde bulunmadan önce çağırın.
| Parametreler | |
|---|---|
config:
InitializationConfig
|
SDK başlatmayı kontrol etme seçenekleri. |
|
SDK başlatmayı tamamladığında çalıştırılacak bir geri çağırma işlevi. |
isConsentFormAvailable
isConsentFormAvailable(): boolean
İzin formunun olup olmadığını kontrol eder.
| İadeler | |
|---|---|
boolean
|
İzin formu varsa true,
aksi takdirde false.
|
loadAndShowConsentFormIfRequired
loadAndShowConsentFormIfRequired(onDismissed?): void
Mevcut izin durumu gerektiriyorsa (ör. durum REQUIRED ise) bir izin formu yükler ve kullanıcıya gösterir.
| Parametreler | |
|---|---|
|
Form kapatıldığında veya form gerekmiyorsa çağrılan geri çağırma işlevi. Sunum başarısız olursa isteğe bağlı FormError ile birlikte çağrılır. |
openAdInspector
openAdInspector(_listener): void
Google Mobile Ads SDK'sı reklam inceleyici yer paylaşımını açar.
Uyumlulaştırma ayarlarında ve reklam kaynaklarında hata ayıklamak için bu yöntemi kullanın.
Uyumlulaştırma ayarlarında ve reklam kaynaklarında hata ayıklamak için bu yöntemi kullanın.
| Parametreler | |
|---|---|
_listener:
OnAdInspectorClosedListener
|
|
openDebugMenu
openDebugMenu(adUnitId): void
Hata ayıklama menüsünü açar.
Test ve sorun giderme işlemlerinde yardımcı olması için bu yöntemi kullanarak belirli bir reklam biriminin hata ayıklama menüsünü açın.
Test ve sorun giderme işlemlerinde yardımcı olması için bu yöntemi kullanarak belirli bir reklam biriminin hata ayıklama menüsünü açın.
| Parametreler | |
|---|---|
adUnitId: string
|
Hata ayıklama menüsünün açılacağı reklam birimi kimliği. |
parseLoadAdError
parseLoadAdError(error): LoadAdError
Reklam yükleme sırasında oluşan yerel bir hatayı ayrıştırır ve LoadAdError içine sarar.
| Parametreler | |
|---|---|
error: unknown
|
Yerel modül tarafından oluşturulan hata nesnesi. |
| İadeler | |
|---|---|
LoadAdError
|
Ayrıştırılmış bir LoadAdError nesnesi. |
requestConsentInfoUpdate
requestConsentInfoUpdate(params?, onComplete?): void
İzin bilgilerinin güncellenmesini ister.
Bu API, getConsentStatus çağrılmadan önce her uygulama oturumunda çağrılmalıdır.
Bu API çağrıldıktan sonra getConsentStatus dönüş değeri, önceki uygulama oturumundan izin durumunu (varsa) tutmak için eşzamanlı olarak güncellenir.
getConsentStatus,
Bu API, getConsentStatus çağrılmadan önce her uygulama oturumunda çağrılmalıdır.
Bu API çağrıldıktan sonra getConsentStatus dönüş değeri, önceki uygulama oturumundan izin durumunu (varsa) tutmak için eşzamanlı olarak güncellenir.
getConsentStatus,
onComplete geri çağırma işlevi çağrıldıktan sonra güncel duruma tekrar güncellenebilir.
| Parametreler | |
|---|---|
|
Hata ayıklama ve hedefleme için isteğe bağlı yapılandırmalar. |
|
İzin bilgileri güncelleme işlemi tamamlandığında çağrılan geri çağırma işlevi. İsteğin başarısız olması durumunda isteğe bağlı FormError ile birlikte çağrılır. |
reset
reset(): void
Kalıcı depolama alanındaki tüm izin durumunu temizler.
Yalnızca hata ayıklama amacıyla kullanın.
Yalnızca hata ayıklama amacıyla kullanın.
setPublisherFirstPartyIdEnabled
setPublisherFirstPartyIdEnabled(enabled): void
Yayıncı birinci taraf kimliğinin etkin olup olmadığını kontrol eder.
Eski adıyla aynı uygulama anahtarı olarak bilinen Google Mobil Reklam SDK'sı yayıncı birinci taraf kimliğini etkinleştirir veya devre dışı bırakır.
Eski adıyla aynı uygulama anahtarı olarak bilinen Google Mobil Reklam SDK'sı yayıncı birinci taraf kimliğini etkinleştirir veya devre dışı bırakır.
- Aşağıdaki kaynakları da incelemenizi öneririz:
| Parametreler | |
|---|---|
enabled: boolean
|
Yayıncı birinci taraf kimliğini etkinleştirmek için doğru, devre dışı bırakmak için yanlış. Varsayılan olarak true değerine ayarlanır.
|
setRequestConfiguration
setRequestConfiguration(_config): void
Uygunluk ve hedefleme için genel istek yapılandırmasını ayarlar.
Hedefleme ayrıntılarını (ör. maksimum reklam içeriği derecelendirmesi), uygunluk ayarlarını (ör. yaş değerlendirmesi etiketi) ve test cihazı kimliklerini belirtmek için bu yöntemi kullanın.
| Parametreler | |
|---|---|
_config:
RequestConfiguration
|
|
setUserControlledAppVolume
setUserControlledAppVolume(volume): void
Kullanıcı tarafından kontrol edilen uygulamanın ses düzeyini ayarlar.
Bu yöntemi, cihazdaki diğer ses çıkışlarına göre tüm reklamların ses düzeyini ayarlamak için kullanın.
Bu yöntemi, cihazdaki diğer ses çıkışlarına göre tüm reklamların ses düzeyini ayarlamak için kullanın.
| Parametreler | |
|---|---|
volume: number
|
Ses seviyesi, 0,0 (sessiz) ile 1,0 (maksimum) arasında. Bu aralıktaki herhangi bir kayan nokta değeri geçerlidir (örneğin, 0,001 veya 0,33333). Değer, 0,1 gibi belirli adım boyutu artışlarıyla sınırlı değildir. |
setUserMutedApp
setUserMutedApp(muted): void
Uygulamanın sessize alınıp alınmayacağını ayarlar.
Bu yöntemi kullanarak sonraki reklamların ilk ses kapatma durumunu kontrol edin.
Bu yöntemi kullanarak sonraki reklamların ilk ses kapatma durumunu kontrol edin.
| Parametreler | |
|---|---|
muted: boolean
|
Uygulama sesinin kapatılıp kapatılmayacağı. Varsayılan olarak false değerine ayarlanır.
|
showPrivacyOptionsForm
showPrivacyOptionsForm(onDismissed?): void
Gizlilik seçenekleri formunu gösterir.
getPrivacyOptionsRequirementStatus
Bu yöntem yalnızca gizlilik seçenekleri formunun gösterilmesini isteyen kullanıcı girişine yanıt olarak çağrılmalıdır.
Gizlilik seçenekleri formu, bir form kullanıma sunulduğunda SDK tarafından otomatik olarak önceden yüklenir. Önceden yüklenmiş bir form yoksa SDK, eşzamansız olarak bir form yüklemeye çalışır.
Kullanıcıya form sunulduktan, bir seçenek belirlendikten ve form kapatıldıktan sonra
getPrivacyOptionsRequirementStatus
REQUIRED ise gizlilik seçenekleri formunu gösterir.Bu yöntem yalnızca gizlilik seçenekleri formunun gösterilmesini isteyen kullanıcı girişine yanıt olarak çağrılmalıdır.
Gizlilik seçenekleri formu, bir form kullanıma sunulduğunda SDK tarafından otomatik olarak önceden yüklenir. Önceden yüklenmiş bir form yoksa SDK, eşzamansız olarak bir form yüklemeye çalışır.
Kullanıcıya form sunulduktan, bir seçenek belirlendikten ve form kapatıldıktan sonra
onDismissed geri çağırma işlemi çağrılır. Ayrıca, aşağıdaki durumlarda FormError ile de döndürülebilir:
- Form kullanılamıyor.
- Form gösterilemiyor.
- Form hâlâ önceden yükleniyor.
| Parametreler | |
|---|---|
|
Form kapatıldığında çağrılan geri çağırma işlevi. Sunum başarısız olursa isteğe bağlı bir FormError ile birlikte çağrılır. |