Başlarken

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

AdMob hesabınızda uygulamanızı ayarlayın

Aşağıdaki adımları tamamlayarak uygulamanızı bir AdMob uygulaması olarak kaydedin:

  1. AdMob hesabına oturum açın veya kaydolun.

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

  1. 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'
  2. 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'
    }
  3. Ş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.

  4. AdMob uygulama kimliğinizi, AdMob web arayüzünde tanımlandığı şekilde, 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>
        <!-- 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ı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"/>
    
       <!-- 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 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 tasarlayarak 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 alacağı ö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 ü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.