Başlarken

GMA Next Gen SDK'yı 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 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ü 24 veya daha yüksek olmalıdır.
  • Derleme SDK'sı sürümü 35 veya daha yeni olmalıdır.

• Kotlin uygulamaları için minimum Kotlin sürümü 1.9'u kullanın.

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. GMA Next Gen SDK'sına ait bağımlılıkları uygulama düzeyindeki derleme dosyanıza ekleyin:

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
   }

   Modern

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
   }

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.

GMA Next Gen SDK'sını başlatın

Önemli nokta: API referans dokümanlarında açıkça belirtilmediği sürece (getVersion() bölümüne bakın) reklamları yüklemeden ve diğer MobileAds yöntemleriyle etkileşimde bulunmadan önce GMA Next Gen SDK'sını başlatmanız gerekir. Aksi takdirde UninitializedPropertyAccessException hatası oluşabilir.

GMA Next Gen SDK'yı başlatmak için MobileAds.initialize() çağrısı yapın. Bu yöntem, arka plan iş parçacığında çağrılmalıdır. Aksi takdirde "Uygulama yanıt vermiyor" (ANR) hatası oluşabilir.

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
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 GMA Next Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

Bu yöntem, hem GMA Next Gen SDK hem de bağdaştırıcı ilk kullanıma hazırlama işlemleri tamamlandıktan sonra veya 30 saniyelik 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.

Not: AdMob aracılığı kullanıyorsanız reklamları yüklemeden önce tamamlanma işleyicisinin çağrılmasını bekleyin. Bu, tüm aracılık bağdaştırıcılarının başlatılmasını sağlar.

Reklamlar, başlatma sırasında GMA Next Gen 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. RequestConfiguration.TagForChildDirectedTreatment veya RequestConfiguration.TagForUnderAgeOfConsent) ayarlayın ya da reklamları yüklemeden önce başka bir işlem yapın. Bu işlemleri GMA Next Gen SDK'sını başlatmadan önce yaptığınızdan emin olun.

Bir reklam biçimi seçin

GMA Next Gen SDK 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

Ö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