Google Mobile Ads SDK'sını uygulamaya entegre etmek, reklam göstermenin ve gelir elde etmenin ilk adımıdır. SDK'yı entegre ettikten sonra bir reklam biçimi (yerel veya ödüllü video gibi) seçebilir ve ilgili adımları uygulayarak bu reklam biçimini uygulayabilirsiniz.
Başlamadan önce
Uygulamanızı hazırlamak için aşağıdaki bölümlerdeki adımları tamamlayın.
Uygulama ön koşulları
Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:
- Minimum SDK sürümü
23
veya sonraki sürümler 34
veya sonraki bir SDK sürümünü derleyin
- Minimum SDK sürümü
AdMob hesabınızda uygulamanızı ayarlayın
Aşağıdaki adımları tamamlayarak uygulamanızı bir AdMob uygulaması olarak kaydedin:
AdMob hesabına oturum açın veya kaydolun.
Uygulamanızı AdMob'a kaydedin. Bu adımda, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyulan benzersiz AdMob uygulama kimliğine sahip bir AdMob uygulaması oluşturulur.
Uygulamanızı yapılandırma
Gradle ayarları dosyanıza Google'ın Maven deposunu ve Maven merkezi deposunu ekleyin:
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üzeyinde derleme dosyanıza ekleyin:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:24.2.0") }
Modern
dependencies { implementation 'com.google.android.gms:play-services-ads:24.2.0' }
Şimdi Senkronize Et'i tıklayın. Senkronizasyonla ilgili ayrıntılar için Projeleri Gradle dosyalarıyla senkronize etme bölümüne göz atın.
AdMob uygulama kimliğinizi, AdMob web arayüzünde tanımlandığı şekilde, uygulamanızın
AndroidManifest.xml
dosyasına ekleyin. Bunu yapmak içinandroid:name="com.google.android.gms.ads.APPLICATION_ID"
ile bir<meta-data>
etiketi ekleyin. Uygulama kimliğinizi AdMob web arayüzünde bulabilirsiniz.android:value
için, tırnak işaretleri arasında kendi AdMob uygulama kimliğinizi ekleyin.<manifest> <application> <!-- Sample AdMob 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 AdMob uygulama kimliğinizle değiştirin. Hello World uygulamasında SDK ile yalnızca deneme yapıyorsanız örnek kimliği kullanabilirsiniz.
Ayrıca,
<meta-data>
etiketinin tam olarak gösterildiği gibi eklenmemesi durumunda mesajla birlikte bir kilitlenme yaşanır:Missing application ID.
(İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için
AD_ID
iznini beyan edin.Uygulamanız Google Mobile Ads SDK'sının 20.4.0 veya daha yeni bir sürümünü kullanıyorsa SDK,
com.google.android.gms.permission.AD_ID
iznini otomatik olarak tanımladığından ve kullanılabilir olduğunda reklam kimliğine erişebileceğinden bu adımı atlayabilirsiniz.Google Mobile Ads SDK'sı 20.3.0 veya daha eski bir sürümü kullanan ve Android 13'ü hedefleyen uygulamalarda reklam kimliğine erişmek üzere Google Mobile Ads SDK'sının
AndroidManifest.xml
dosyasınacom.google.android.gms.permission.AD_ID
iznini eklemeniz gerekir:<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_ID
izin beyanı ve nasıl devre dışı bırakılacağı hakkında daha fazla bilgi edinmek için bu Play Console makalesini inceleyin.
Google Mobile Ads SDK'sını başlatma
Reklamları yüklemeden önce,MobileAds.initialize()
çağrısı yaparak Google Mobile Ads SDK'sını başlatın.
Bu yöntem, SDK'yı başlatır ve hem Google Mobile Ads SDK'sı hem de bağdaştırıcı başlatma işlemleri tamamlandıktan sonra veya 30 saniyelik zaman aşımından sonra bir tamamlama işleyicisi çağırır. Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.
Reklamlar, ilk kullanıma sunulduktan sonra Google Mobile Ads SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılardan izin almanız gerekiyorsa
setTagForChildDirectedTreatment()
veya
setTagForUnderAgeOfConsent()
gibi isteğe özel işaretleri ayarlayın ya da
reklamları yüklemeden önce işlem yapın. Google Mobile Ads SDK'sını başlatmadan önce bu işlemi yaptığınızdan emin olun.
Aşağıda, bir Etkinlik içindeki arka plan ileti dizisinde initialize()
yönteminin nasıl çağrılacağına dair bir örnek verilmiştir:
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çme
Google Mobile Ads SDK'sı içe aktarıldı ve reklam uygulamaya hazırsınız. AdMob bir dizi farklı reklam biçimi sunar. Böylece uygulamanızın kullanıcı deneyimine en uygun olanı seçebilirsiniz.
Banner
Banner reklam birimleri, uygulama düzeninin bir kısmını kaplayan dikdörtgen reklamlar gösterir. Belirli bir süre sonra otomatik olarak yenilenebilirler. Bu, uygulamanızda aynı ekranda kalsalar bile kullanıcıların düzenli aralıklarla yeni bir reklam görecekleri anlamına gelir. Ayrıca, uygulanması en basit reklam biçimidir.
Geçiş reklamı
Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bu reklam birimlerini uygulamanızın arayüzündeki doğal bekleme ve geçiş alanlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).
Yerel biçim
Yerel reklamlar, başlık ve harekete geçirici mesaj gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklamı kendiniz tasarlayarak zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.
Ödüllü
Ödüllü reklam birimlerinde kullanıcılar jeton, ek can veya puan toplamak için oyun oynayabilir, anket yapabilir veya video izleyebilir. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının alacağı ödül değerlerini ve öğeleri belirtebilirsiniz.
Ödüllü geçiş reklamı
Ödüllü geçiş reklamı, doğal uygulama geçişleri sırasında otomatik olarak görünen reklamlar için para veya ek can gibi ödüller sunmanızı sağlayan yeni ve teşvik edici bir reklam biçimidir.
Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamı görüntülemeyi etkinleştirmesi gerekmez.
Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında ödülü bildiren ve kullanıcılara dilediklerinde bu seçeneği devre dışı bırakma şansı sunan bir tanıtım ekranı gerekir.
Ö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 görünen bir reklam biçimidir. Reklam, yükleme ekranının üzerindedir.
Uygulama açılış reklamlarını uygulama
Ek kaynaklar
GitHub'daki Google Mobile Ads deposu, bu API'nin sunduğu farklı reklam biçimlerinin nasıl kullanılacağını gösterir.