Google Mobile Ads SDK'sını bir 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 bunu uygulama adımlarını uygulayabilirsiniz.
Başlamadan önce
Uygulamanızı hazırlamak için aşağıdaki bölümlerde açıklanan adımları tamamlayın.
Uygulamanın ön koşulları
- Android Studio 3.2 veya sonraki bir sürümü kullanma
Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:
16
veya daha yüksek birminSdkVersion
28
veya daha yüksek bircompileSdkVersion
Uygulamanızı AdMob hesabınızda ayarlama
Aşağıdaki adımları tamamlayarak 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 ilerleyen bölümlerinde gerekli olacak benzersiz bir AdMob Uygulama Kimliği ile AdMob uygulaması oluşturur.
Uygulamanızı yapılandırma
Proje düzeyindeki
build.gradle
dosyanızda, hembuildscript
hem deallprojects
bölümlerinize Google's Maven deposu ve Maven merkezi deposu ekleyin:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Google Mobile Ads SDK'sının bağımlılıklarını modül's uygulama düzeyinde Gradle dosyanıza (normalde
app/build.gradle
) ekleyin:dependencies { implementation 'com.google.android.gms:play-services-ads:20.6.0' }
Uygulama kimliğinizi (AdMob kullanıcı arayüzünde tanımlanan uygulama kimliğinizi
AndroidManifest.xml
AndroidManifest.xml
dosyanıza ekleyin. Bunu yapmak içinandroid:name="com.google.android.gms.ads.APPLICATION_ID"
öğesine sahip bir<meta-data>
etiketi ekleyin. Uygulama kimliğinizi AdMob kullanıcı arayüzünde bulabilirsiniz.android:value
için, tırnak işaretleri arasında bulunan AdMob kendi 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, yukarıda listelenen kimliği değil, gerçek AdMob uygulama kimliğinizi kullanın. Yalnızca Hello World uygulamasında SDK ile deneme yapmak istiyorsanız yukarıda gösterilen örnek uygulama kimliğini kullanabilirsiniz.
Ayrıca, yukarıda gösterildiği gibi
<meta-data>
etiketinin eklenememesi, iletiyle birlikte kilitlenmeye neden olur:The Google Mobile Ads SDK was initialized incorrectly.
(İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için
AD_ID
iznini bildirin.Uygulamanız, Google Mobile Ads SDK'sının 20.4.0 veya sonraki bir sürümünü kullanıyorsa SDK otomatik olarak
com.google.android.gms.permission.AD_ID
iznini bildirdiğinden ve mümkün olduğunda Reklam Kimliğine erişebildiğinden bu adımı atlayabilirsiniz.Google Mobile Ads SDK'sının 20.3.0 veya önceki sürümlerini kullanan ve Android 13'ü hedefleyen uygulamalarda Google Mobile Ads SDK'sının Reklam Kimliği'ne erişmesi için
AndroidManifest.xml
dosyasınacom.google.android.gms.permission.AD_ID
izni 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 lütfen bu Play Console makalesine bakın.
Google Mobile Ads SDK'sını başlatma
Reklam yüklemeden önce uygulamanızın SDK'yı başlatan MobileAds.initialize()
çağrısı yaparak Google Mobile Ads SDK'sını başlatmasını sağlayın. Ayrıca, ilk kullanıma hazırlama işlemi tamamlandıktan sonra (veya 30 saniyelik bir zaman aşımı süresi dolduktan sonra) bir tamamlanma işleyicisi geri çağrılır. Bu işlemin ideal olarak yalnızca uygulama başlatılırken yapılması gerekir.
MobileAds.initialize()
çağrısı yapıldıktan sonra reklamlar 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, isteğe özel işaretlemeler (tagForChildDirectedTreatment
veya tag_for_under_age_of_consent
gibi) ayarlamanız veya reklamları yüklemeden önce başka bir işlem yapmanız gerekiyorsa Google Mobile Ads SDK'sını başlatmadan önce bu işlemi yaptığınızdan emin olun.
Bir Etkinlikte initialize()
yönteminin nasıl çağrılacağına dair bir örneği aşağıda bulabilirsiniz:
Örnek MainActivity (alıntı)
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) {} } }
Uyumlulaştırma kullanıyorsanız tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlayacağından, reklamları yüklemeden önce tamamlama işleyicinin çağrılmasını bekleyin.
Reklam biçimi seçme
Google Mobile Ads SDK'sı artık içe aktarıldı ve reklam uygulamaya hazırsınız. AdMob Farklı reklam biçimleri sunduğu için, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilirsiniz.
Banner
Cihaz ekranının üstünde veya altında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulama ile etkileşimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılığa yeni başladıysanız başlangıç için mükemmel bir kaynaktır.
Geçiş
Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kapsayan tam ekran reklamlar. En iyi şekilde, uygulama yürütme akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında veya bir görevin tamamlanmasından hemen sonra) kullanılırlar.
Yerel
Uygulamanızın görünümüne ve tarzına uyan özelleştirilebilir reklamlar. Reklamların nasıl ve nereye yerleştirileceğine siz karar verirsiniz. Böylece düzeniniz, uygulamanızın tasarımıyla daha tutarlı olur.
Ödül olarak verildi
Kısa videolar izleyen ve oynatılabilir reklamlar ile anketlerle etkileşimde bulundukları için kullanıcıları ödüllendiren reklamlar. Ücretsiz uygulamalardan para kazanmak için kullanılır.
Ek kaynaklar
GitHub'daki Google Mobil Reklamlar deposu, bu API'nin sunduğu farklı reklam biçimlerini nasıl kullanacağınızı gösterir.