Google Mobile Ads SDK'sını bir uygulamaya entegre etmek, reklam gösterme 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 uygulama adımlarını uygulayabilirsiniz.
Başlamadan önce
Uygulamanızı hazırlamak için aşağıdaki bölümlerde verilen 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ü
19
veya üstü - Şu SDK sürümünü derleyin:
33
veya üzeri
- Minimum SDK sürümü
AdMob hesabınızda uygulamanızı ayarlama
Aşağıdaki adımları uygulayarak uygulamanızı AdMob uygulaması olarak kaydedin:
Bir AdMob hesabında oturum açın veya kaydolun.
Uygulamanızı AdMob'a kaydedin. Bu adım, bu kılavuzun sonraki bölümlerinde ihtiyaç duyacağınız benzersiz bir AdMob Uygulama Kimliği'ne sahip bir AdMob uygulaması oluşturur.
Uygulamanızı yapılandırma
Proje düzeyindeki
build.gradle
dosyanıza, hembuildscript
hem deallprojects
bölümlerinize Google'ın Maven deposu ile Maven merkezi deposunu ekleyin:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Google Mobile Ads SDK'sına ait bağımlılıkları, modülünüzün uygulama düzeyindeki Gradle dosyasına (normalde
app/build.gradle
) ekleyin:dependencies { implementation 'com.google.android.gms:play-services-ads:23.0.0' }
AdMob Uygulama kimliğinizi, web arayüzünde AdMob belirtilen şekliyle 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
alanında, tırnak işaretleri arasında kendi AdMob uygulama kimliğinizi girin.<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çekAdMob uygulama kimliğinizle değiştirin. Bir Hello World uygulamasında SDK ile yalnızca deneniyorsanız örnek kimliği kullanabilirsiniz.
Ayrıca,
<meta-data>
etiketinin tam olarak gösterildiği gibi eklenmemesi şu mesajın bulunduğu bir kilitlenmeye neden olur: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 sonraki bir sürümünü kullanıyorsa bu adımı atlayabilirsiniz. Bunun nedeni, SDK'nın
com.google.android.gms.permission.AD_ID
iznini otomatik olarak beyan etmesi ve reklam kimliği kullanılabilir olduğunda reklam kimliğine erişebilmesidir.Google Mobile Ads SDK'sının 20.3.0 veya daha eski bir sürümünü kullanan ve Android 13'ü hedefleyen uygulamalarda Reklam Kimliği'ne erişmek için 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>
Nasıl devre dışı bırakılacağı da dahil olmak üzere
com.google.android.gms.permission.AD_ID
izin beyanı hakkında daha fazla bilgi edinmek için bu Play Console makalesine bakın.
Google Mobile Ads SDK'sını başlatma
Reklamları yüklemeden önceMobileAds.initialize()
yöntemini çağırarak 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ığında veya 30 saniyelik zaman aşımının ardından bir tamamlama işleyicisi çağırır. Bu işlem yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması gerekir.
Reklamlar, başlatma sonrasında 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()
ya da
setTagForUnderAgeOfConsent()
ya da
başka bir işlem yapmak üzere reklamları yüklemeden önce isteğe özel işaretler ayarlayın. Google Mobile Ads SDK'sını başlatmadan önce bunu yaptığınızdan emin olun.
Bir Etkinlikte initialize()
yönteminin nasıl çağrılacağına dair bir örnek:
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);
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
}
});
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
MobileAds.initialize(this) {}
}
}
Reklam biçimi seçin
Google Mobile Ads SDK'sı içe aktarıldı ve bir reklam uygulamaya hazırsınız. AdMob Birçok farklı reklam biçimi sunduğu için uygulamanızın kullanıcı deneyimine en uygun olan biçimi 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örüntüledikleri anlamına gelir. Ayrıca, bu reklamlar aynı zamanda uygulanması en basit reklam biçimidir.
Geçişli
Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bunları, uygulamanızın arayüzündeki doğal ara ve geçişlere (ör. bir oyun uygulamasında seviye tamamlandıktan sonra) yerleştirin.
Yerel biçim
Yerel reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklam stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek, doğal ve göze batmayan bir reklam sunusu oluşturabilirsiniz.
Ödül olarak verildi
Ödüllü reklam birimleri, kullanıcıların oyun oynayarak, anket yaparak veya video izleyerek jeton, ek can veya puan gibi uygulama içi ödüller kazanmalarını sağlar. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının aldığı ödül değerlerini ve öğelerini 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 jeton veya ekstra can gibi ödüller sunmanıza olanak tanıyan, teşvik edilen yeni bir reklam biçimidir.
Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamını izlemeyi etkinleştirmesi gerekmez.
Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında ödülü bildiren ve kullanıcılara isterlerse devre dışı bırakma fırsatı sunan bir giriş 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österilen bir reklam biçimidir. Reklam, yükleme ekranının üzerinde yer alır.
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.