Başlarken

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 (ör. yerel veya ödüllü video) seçip bu biçimi uygulamak için gerekli adımları 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 olmalıdır.
  • Derleme SDK'sı sürümü 34 veya daha yeni olmalıdır.

AdMob hesabınızda uygulamanızı oluşturma

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

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

2. Uygulamanızı AdMob'a kaydedin. Bu adımda, bu kılavuzun ilerleyen bölümlerinde gerekli olacak benzersiz bir 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ına ait bağımlılıkları uygulama düzeyindeki derleme dosyanıza ekleyin:

   Kotlin

   dependencies {
     implementation("com.google.android.gms:play-services-ads:24.4.0")
   }

   Modern

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

3. Şimdi Senkronize Et'i tıklayın. Senkronizasyonla ilgili ayrıntılar için Projeleri Gradle dosyalarıyla senkronize etme başlıklı makaleye bakın.

4. AdMob web arayüzünde gösterildiği gibi AdMob uygulama kimliğinizi uygulamanızın AndroidManifest.xml dosyasına ekleyin. Bunu yapmak için <meta-data> etiketi ekleyin android:name="com.google.android.gms.ads.APPLICATION_ID" ile. 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="SAMPLE_APP_ID"/>
     </application>
   </manifest>
   

   SAMPLE_APP_ID yerine AdMob uygulama kimliğinizi yazın. Test sırasında önceki örnekte gösterilen örnek uygulama kimliğini kullanın.

   Ayrıca, <meta-data> etiketinin tam olarak gösterildiği şekilde eklenmemesi durumunda aşağıdaki mesajla birlikte kilitlenme yaşanacağını unutmayın:

   Missing application ID.
   

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

   Uygulamanızda Google Mobile Ads SDK'sının 20.4.0 veya daha yüksek bir sürümü kullanılıyorsa SDK, com.google.android.gms.permission.AD_ID iznini otomatik olarak beyan ettiğinden ve reklam kimliğine her zaman erişebildiğinden bu adımı atlayabilirsiniz.

   Google Mobile Ads SDK'sının 20.3.0 veya daha eski 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 com.google.android.gms.permission.AD_ID iznini AndroidManifest.xml dosyasına 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ı ilk kullanıma hazırlama

Bu yöntem, hem Google Mobile Ads SDK'sı hem de bağdaştırıcı ilk kullanıma hazırlama işlemleri tamamlandıktan sonra veya 30 saniyelik bir zaman aşımının ardından SDK'yı ilk kullanıma hazırlar ve bir tamamlama işleyicisi çağırır. Bu işlemin yalnızca bir kez yapılması gerekir. İdeal olarak uygulama başlatılırken yapılmalıdır.

Reklamlar, ilk kullanıma hazırlama sırası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, isteğe özel işaretleri (ör. setTagForChildDirectedTreatment() veya setTagForUnderAgeOfConsent()) ayarlayın ya da reklamları yüklemeden önce başka bir işlem yapın. Bu işlemleri Google Mobile Ads SDK'sını başlatmadan önce yaptığınızdan emin olun.

Bir etkinlikteki arka plan iş parçacığında initialize() yönteminin nasıl çağrılacağına dair bir örneği aşağıda görebilirsiniz:

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}
MainActivity.kt

Bir reklam biçimi seçin

Google Mobile Ads SDK'sı artık 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.

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ş anlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).

Geçiş reklamlarını uygulama

Yerel biçim

Yerel reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda gösterilme şeklini özelleştirebileceğiniz reklamlardır. Reklamı kendiniz stilize ederek 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 deposunda, bu API'nin sunduğu farklı reklam biçimlerinin nasıl kullanılacağı gösterilmektedir.