Bu kılavuz, Google Mobile Ads Android SDK'sının erken erişim derlemesini Android uygulamalarına entegre eden yayıncılar için hazırlanmıştır. Erken erişim derlemeleri, Google Play hizmetlerinin bir sonraki sürümünü beklemeden yeni Google Mobile Ads SDK'sı özelliklerinden yararlanma fırsatı sunar ve aşağıdaki avantajları sunar:
Erken erişim özelliği APK'da kullanıma sunulduğunda, otomatik olarak Google Play Hizmetleri APK'sının yeni Google Mobile Ads SDK'sı uygulamasını kullanmaya başlarlar.
Bunlar tamamen test edilmiş olup Google'ın Maven deposunda veya SDK Yöneticisi'nde bulunan herkese açık derlemelerle aynı yayınlama ölçütlerini karşılar.
Bunlar, Google Mobile Ads SDK'sının tam sürümleridir. Lite SDK'dan daha büyük olan bu sürümler, Lite SDK'sı sınırlamalarına tabi değildir.
Bu reklamlar yalnızca Google Play aracılığıyla dağıtılan uygulamalarda değil, tüm dünyada kullanılabilir.
Erken erişim Google Mobile Ads SDK'sı ile yerel bir Maven deposu oluşturmak ve Android uygulamanızda bunu bağımlılık olarak referans göstermek için bu sayfadaki adımları uygulayın.
Ön koşullar
- Android Studio 3.0 veya sonraki bir sürümü kullanma
- Android API düzeyi 16 veya üstünü hedefle
- Hesap Yöneticisi tarafından sağlanan erken erişim Google Mobile Ads SDK'sı zip dosyası
Özel Maven deposu yapılandırma
Erken erişim Google Mobile Ads SDK'sı zip dosyasını indirin. Projenizin en üst düzey dizininde bir gma_sdk_repo klasörü oluşturun ve zip dosyasının tüm içeriğini bu klasöre yerleştirin. Dizin yapınız <project_root_dir>/gma_sdk_repo/com/google/... şeklinde olmalıdır.
Uygulamanızın proje düzeyindeki build.gradle dosyasını açın.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
Kalın harflerle yazılmış satırı allprojects/repositories bölümüne ekleyin. Bu işlem, Gradle'a bağımlılıkları çözümlerken yeni oluşturduğunuz gma_sdk_repo klasöründe bir Maven deposu araması talimatı verir.
Derleme bağımlılığı ekleyin
Projenizde Google Mobile Ads SDK'sının erken erişim derlemesini kullanmak için uygulama düzeyindeki build.gradle dosyanızda bunu bağımlılık olarak belirtmeniz gerekir: Uygulama düzeyindeki build.gradle dosyasını açın ve kalın yazılmış satırı snippet'teki dependencies bölümüne ekleyin.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
Önceki snippet'te x.y.z tarafından gösterilen bağımlılık sürümü, Early Access Google Mobile Ads Android SDK'sı zip dosyasının arşivlenmemiş içeriklerindeki com/google/android/gms/play-services-ads/ dizini altında bulunan en son sürüm bulunarak belirlenebilir.
Firebase çakışmalarını çözün
Mobile Ads SDK'sıyla birlikte bir Firebase kitaplığı kullanıyorsanız projenize hem com.google.android.gms:play-services-measurement-api hem de com.google.android.gms:play-services-measurement-sdk-api bağımlılıklarını dahil edebilirsiniz. Bu iki bağımlılığın sürümleri eşleşmelidir ancak Mobile Ads SDK'nızın erken erişim derlemesinin ve mevcut Firebase sürümünüzün bu iki bağımlılık için farklı sürümler aldığını görebilirsiniz.
Geçici bir çözüm olarak, uygulamanızın build.gradle dosyasında play-services-measurement-sdk-api kitaplığının belirli bir sürümüne bağımlılığı aşağıdaki şekilde zorlayabilirsiniz:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
x.y.z sürümü, Firebase sürümünüze bağlıdır. Son Firebase sürümleri için doğru sürümler şunlardır:
firebase-core sürüm
|
play-services-measurement-sdk-api sürüm
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
Diğer Firebase sürümleri için doğru sürümü bulmak amacıyla uygulamanızda gradle androidDependencies komutunu çalıştırın ve com.google.android.gms:play-services-measurement-api bağımlılığı için yazdırılan sürümü kullanın.
Android uygulamanız artık Google Mobile Ads Android SDK'sının erken erişim derlemesiyle kullanıma hazır.