Google Mobile Ads SDK'sını bir uygulamaya entegre etmek reklam gösterip gelir elde edebilirsiniz. SDK'yı entegre ettikten sonra şunları yapabilirsiniz: bir reklam biçimi (yerel veya ödüllü video gibi) seçin ve şu adımları uygulayın: uygulayacaksınız.
Başlamadan önce
Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan adımları tamamlayın.
Uygulama ön koşulları
Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:
- SDK'nın minimum sürümü:
21veya üzeri - Şu öğenin SDK sürümünü derle:
33veya üzeri
- SDK'nın minimum sürümü:
Uygulamanızı yapılandırma
Gradle ayarları dosyanıza Google'ın Maven deposu ve Maven merkez deposu:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Modern
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
Google Mobile Ads SDK'sı için bağımlılıkları uygulama düzeyindeki derlemenize ekleyin dosya:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
Modern
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
Ad Manager Uygulama kimliğinizi, Ad Manager uygulamanızın arayüzüne
AndroidManifest.xmldosya. Bunu yapmak için<meta-data>android:name="com.google.android.gms.ads.APPLICATION_ID". Daha fazla uygulama kimliğinizi Ad Manager web arayüzünde bulabilirsiniz. Örneğin,android:value, kendi uygulama Ad Manager kimliğinizi girin, tırnak işaretleri içine alın.<manifest> <application> <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>Gerçek bir uygulamada, örnek uygulama kimliğini gerçek Ad Manager uygulama kimliği. Örnek kimliğini aşağıdaki durumlarda kullanabilirsiniz: bir Hello World uygulamasındaki SDK ile deneme yapıyorsunuz.
Ayrıca,
<meta-data>etiketinin tam olarak gösterilen sonuçlardaki gibi eklenemediğine dikkat edin. şu mesajla çakışıyor:Missing application ID.(İsteğe bağlı) Bildir Önceki sürümlerin Android'de çalışması için
AD_IDizni 13.Uygulamanız Google Mobile Ads SDK'sı 20.4.0 sürümünü veya o kadar kolay değilse, SDK otomatik olarak
com.google.android.gms.permission.AD_IDiznine sahip ve şunları yapabilir: olduğu zaman Reklam Kimliğine erişebilecektir.Google Mobile Ads SDK'sı 20.3.0 sürümünü veya daha düşük ve Android 13'ü hedefliyorsanız
com.google.android.gms.permission.AD_IDizni Google Mobile Ads SDK'sı içinAndroidManifest.xmldosyası Reklam Kimliğine erişin:<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
com.google.android.gms.permission.AD_IDizin beyanı, nasıl devre dışı bırakılacağı da dahil olmak üzere bu işlev hakkında daha fazla bilgi için Play Konsol makalesi.
Google Mobile Ads SDK'sını başlatma
Reklamları yüklemeden önce, şunu çağırarak Google Mobile Ads SDK'sını başlatın:MobileAds.initialize().
Bu yöntem SDK'yı başlatır ve hem Google Mobile Ads SDK'sı ve bağdaştırıcı başlatma işlemleri tamamlandıktan sonra veya 30 saniye zaman aşımı. Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.
Reklamlar, Google Mobile Ads SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir
gerçekleşmesini sağlar. Avrupa'daki kullanıcılardan izin almanız gerekiyorsa
Ekonomik Alanı (AEA) kullanıyorsanız, şunlar gibi isteğe özel işaretleri ayarlayın:
setTagForChildDirectedTreatment()
veya
setTagForUnderAgeOfConsent(),
veya
Aksi takdirde, reklamları yüklemeden önce işlem yapın. Başlatmadan önce bunu yaptığınızdan emin olun.
Google Mobile Ads SDK'sı.
Aşağıda, arka planda initialize() yönteminin nasıl çağrılacağına dair bir örnek verilmiştir
bir Etkinlik içindeki ileti dizisi:
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
Reklam biçimi seçin
Google Mobile Ads SDK'sı içe aktarıldı ve reklam uygulamaya hazırsınız. Ad Manager birçok farklı reklam biçimi sunar. uygulamanızın kullanıcı deneyimine en uygun seçeneği belirleyebilirsiniz.
Banner
Banner reklam birimleri, uygulamanın bir bölümünü kaplayan dikdörtgen reklamlar kullanır. Belirli bir süre sonra otomatik olarak yenilenebilirler. Bunun anlamı şudur: Kullanıcılar, aynı reklam yayınında kalsalar bile düzenli aralıklarla yeni bir reklam görüntüler ekleyebilirsiniz. Ayrıca, uygulanması en basit reklam biçimidir.
Geçiş reklamı
Geçiş reklam birimleri, uygulamanızda tam sayfa reklamlar gösterir. Doğal bir yere yerleştirin Seviye tamamlandıktan sonra olduğu gibi uygulamanızın arayüzündeki aralar ve geçişler en iyi uygulamaları paylaşacağız.
Yerel biçim
Doğal reklamlar, başlık ve resim gibi öğelerin nasıl özelleştirileceğini harekete geçirici mesajlar, uygulamalarınızda sunulur. Reklamın stilini kendiniz belirleyerek şunları yapabilirsiniz: göze çarpmayan, doğal ve göze batmayan reklam sunumları hazırlayın. sunmaktır.
Google Ad Manager yerel reklamları uygulamak için iki yol sunar: yerel stiller ve standart doğal reklamlar için özel oluşturma sunar.
Yerel stiller, yerel reklamların uygulanmasını kolaylaştırmak için tasarlanmıştır. Ayrıca formatta yeniyseniz bu iyi bir seçimdir. Özel oluşturma maksimum özgürlük için tasarlanmamıştır.
Yerel stilleri uygulama Yerel reklamları uygulama (özel oluşturma)
Ödüllü
Ödüllü reklam birimleri, kullanıcıların aşağıdaki işlemleri yapmak için oyun oynamasına, anket yanıtlamasına veya video izlemesine olanak tanır. Jeton, ekstra can veya puan gibi uygulama içi ödüller kazanabilirsiniz. Faturalandırma hesabınızdaki ücretleri takip etmek için Farklı reklam birimleri için farklı ödüller belirleyin ve ödül değerlerini ve kullanıcının aldığı öğe sayısı.
Ödüllü geçiş reklamı
Ödüllü geçiş reklamı, bir teşvikle sunulan yeni bir reklam biçimidir. otomatik olarak görünen reklamlar için jeton veya ekstra can gibi ödüller sunma doğal uygulama geçişleri sırasında.
Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamı.
Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında giriş ekranında ödül duyurur ve kullanıcılara kapsam dışında kalmayı seçmeleri için ve bunu yapmak istiyorlar.
Ödüllü geçiş reklamlarını uygulama
Uygulama açılışı
Uygulama açılışı, kullanıcılar uygulamanızı açtığında veya uygulamanıza geri döndüğünde uygulamasını indirin. Reklam, yükleme ekranının üzerinde görünür.
Uygulama açılış reklamlarını uygulama
Ek kaynaklar
GitHub'daki Google Mobile Ads deposu, farklı reklam biçimlerini nasıl kullanacağınızı öğreneceksiniz.