Bu sayfa, Cloud Translation API ile çevrilmiştir.

Başlayın
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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ü 23 veya daha yüksek
- 34 veya sonraki bir sürümün SDK'sını derleyin

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:24.2.0")
}

Modern

dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.2.0'
}

Şimdi Senkronize Et'i tıklayın. Senkronizasyon hakkında ayrıntılı bilgi için Projeleri Gradle dosyalarıyla senkronize etme başlıklı makaleyi inceleyin.
AdMob web arayüzünde tanımlanan AdMob uygulama kimliğinizi uygulamanızın AndroidManifest.xml dosyasına ekleyin. Bunu yapmak için android: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>
    
    <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_ID iznini 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_ID iznini otomatik olarak beyan ettiği ve kullanılabilir 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ği'ne erişebilmesi için AndroidManifest.xml dosyasına com.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"/>

   
   <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 göz atın.

Google Mobile Ads SDK'sını ilk kullanıma hazırlayın

Reklamları yüklemeden önce MobileAds.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. Bunu 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 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.

Banner reklamları uygulama

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).

Geçiş reklamları uygulama

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.

Yerel reklamları uygulama

Ö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ü reklamları uygulama

Ö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 ü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.

Başlayın Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Başlamadan önce

Uygulama ön koşulları

AdMob hesabınızda uygulamanızı ayarlama

Uygulamanızı yapılandırma

Kotlin

Modern

Kotlin

Modern

(İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için AD_ID iznini belirtin.

Google Mobile Ads SDK'sını ilk kullanıma hazırlayın

Java

Kotlin

Reklam biçimi seçme

Banner

Geçiş reklamı

Yerel biçim

Ödüllü

Ödüllü geçiş reklamı

Uygulama açılışı

Ek kaynaklar

Başlayın
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

(İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için `AD_ID` iznini belirtin.