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 biçimi uygulama adımlarını 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ında aşağıdaki değerlerin kullanıldığından emin olun:
- Minimum SDK sürümü
21veya daha yüksek 34veya sonraki bir sürümün SDK'sını derleyin
- Minimum SDK sürümü
AdMob hesabınızda uygulamanızı ayarlama
Aşağıdaki adımları uygulayarak uygulamanızı AdMob uygulaması olarak kaydedin:
AdMob hesabında oturum açın veya kaydolun.
Uygulamanızı AdMob'a kaydedin. Bu adım, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyacağınız benzersiz bir AdMob uygulaması kimliği içeren bir AdMob uygulaması oluşturur.
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ına ait bağımlılıkları uygulama düzeyindeki derleme dosyanıza ekleyin:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.6.0") }
Modern
dependencies { implementation 'com.google.android.gms:play-services-ads:23.6.0' }
AdMob web arayüzünde tanımlanan AdMob uygulama kimliğinizi uygulamanızın
AndroidManifest.xmldosyası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:valueiç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. SDK'yı yalnızca Merhaba Dünya uygulamasında denemek istiyorsanız örnek kimliği kullanabilirsiniz.
Ayrıca,
<meta-data>etiketinin tam olarak gösterildiği şekilde eklenmemesi durumunda kilitlenmeyle birlikte şu mesajın gösterildiğini unutmayın:Missing application ID.(İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için
AD_IDiznini belirtin.Uygulamanız 20.4.0 veya sonraki bir Google Mobile Ads SDK sürümünü kullanıyorsa SDK,
com.google.android.gms.permission.AD_IDiznini otomatik olarak beyan ettiği ve mevcut olduğunda reklam kimliğine erişebildiği için bu adımı atlayabilirsiniz.Google Mobile Ads SDK'sının 20.3.0 veya önceki bir sürümünü kullanan ve Android 13'ü hedefleyen uygulamalarda, Google Mobile Ads SDK'sının reklam kimliğine erişebilmesi için
AndroidManifest.xmldosyasınacom.google.android.gms.permission.AD_IDiznini 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>
Nasıl devre dışı bırakılacağı da dahil olmak üzere
com.google.android.gms.permission.AD_IDizin beyanı hakkında daha fazla bilgi edinmek için bu Play Console makalesine göz atın.
Google Mobile Ads SDK'sını ilk kullanıma hazırlayın
Reklamları yüklemeden önceMobileAds.initialize() çağrısını yaparak Google Mobile Ads SDK'sını ilk kullanıma hazırlayın.
Bu yöntem, SDK'yı ilk kullanıma hazırlar ve hem Google Mobile Ads SDK'sı hem de bağdaştırıcının ilk kullanıma hazırlanması tamamlandıktan sonra veya 30 saniyelik zaman aşımının ardından bir tamamlama işleyicisi çağırır. Bu işlemin ideal olarak uygulamanın lansmanında bir kez yapılması gerekir.
Reklamlar, ilk kullanıma hazırlandıktan 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şaretler ayarlayın ya da reklamları yüklemeden önce başka bir işlem yapın. Bu işlemi Google Mobile Ads SDK'sını başlatmadan önce yaptığınızdan emin olun.
Aşağıda, bir etkinlik içindeki arka plan iş parçacığında initialize() yönteminin nasıl çağrılacağıyla ilgili 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, uygulamanızın kullanıcı deneyimine en uygun olanı seçebilmeniz için çeşitli reklam biçimleri sunar.
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 biçimlendirerek 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 aldığı ö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ı 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 üzerinde çıkar.
Uygulama açılış reklamlarını uygulama
Ek kaynaklar
GitHub'daki Google Mobil Reklamlar deposu, bu API'nin sunduğu farklı reklam biçimlerinin nasıl kullanılacağını gösterir.