GMA Yeni Nesil SDK'yı ayarlama

Platform seçin: Android iOS Unity Flutter Android (Eski)

GMA Next-Gen SDK'ı bir uygulamaya entegre etmek, görüntülü reklam göstermenin ve gelir elde etmenin ilk adımıdır. SDK'yı entegre ettikten sonra bir reklam biçimi (ör. doğal veya ödüllü video) seçebilir ve bu biçimi uygulamak için gereken adımları takip edebilirsiniz.

Başlamadan önce

Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan 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.
  • 35 veya daha yeni bir SDK sürümüyle derleyin

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

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 bağımlılıklarını uygulama düzeyindeki derleme dosyanıza ekleyin:

   Kotlin

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

   Modern

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

3. Ş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.

GMA Next-Gen SDK ilk kullanıma hazırlama

Ö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şim kurmadan önce GMA Next-Gen SDK'yi ilk kullanıma hazırlamanız gerekir. Aksi takdirde UninitializedPropertyAccessException hatası oluşabilir.

GMA Next-Gen SDK öğesini başlatmak için MobileAds.initialize() öğesini çağırın. Bu, bir 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 Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

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 Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

Bu yöntem, SDK'yı başlatır ve hem GMA Next-Gen SDK hem de bağdaştırıcı başlatma işlemleri tamamlandıktan sonra veya 30 saniyelik bir zaman aşımından sonra bir tamamlama işleyicisi çağırır. Bu işlemin yalnızca bir kez, ideal olarak uygulama başlatılırken yapılması gerekir.

Uyumlulaştırma kullanıyorsanız reklamları yüklemeden önce tamamlama işleyicisinin çağrılmasını bekleyin. Böylece tüm uyumlulaştırma bağdaştırıcıları başlatılır.

Not: Google Kullanıcı Mesajlaşma Platformu (UMP) SDK'sı, uygulamanızın AndroidManifest.xml dosyasında uygulama kimliğinin bulunmasını gerektirir. Ayrıntılar için Uygulama kimliğini ekleme başlıklı makaleyi inceleyin.

Reklamlar, ilk kullanıma hazırlama sırasında GMA Next-Gen SDK veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı (AEA), Birleşik Krallık veya İsviçre'deki 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 başlatılmadan ö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. Ad Manager, 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ş alanlarına yerleştirin (ör. bir oyun uygulamasında seviye atlanmasından sonra).

Geçiş reklamlarını uygulama

Yerel biçim

Doğal reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklamın stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal, göze batmayan reklam sunumları oluşturabilirsiniz.

Google Ad Manager, doğal reklamları uygulamak için iki yöntem sunar: doğal reklam stilleri ve özel oluşturma aracılığıyla standart doğal reklamlar.

Doğal reklam stilleri, doğal reklamların uygulanmasını basitleştirmek için tasarlanmıştır ve bu biçimi yeni kullanmaya başladıysanız mükemmel bir seçenektir. Özel oluşturma, sunularınızı oluştururken size en yüksek düzeyde özgürlük sunacak şekilde tasarlanmıştır.

Doğal reklam stillerini uygulama Doğal reklamları uygulama (özel oluşturma)

Ödüllü

Ödüllü reklam birimleri, kullanıcıların jeton, ekstra can veya puan gibi uygulama içi ödüller kazanmak için oyun oynamasına, anketlere katılmasına ya da video izlemesine olanak tanır. 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ı 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ıyla yer paylaşımlı olarak gösterilir.

Uygulama açılış reklamlarını uygulama

Pencere içinde pencere (beta)

Pencere içinde pencere (PiP) reklamlar, ekrandaki içeriğin üzerinde kalan kayan bir pencerede reklam gösterir. Bu biçim, reklam görünür durumdayken kullanıcılarınızın uygulamanızla etkileşim kurmasına olanak tanır.

Pencere içinde pencere reklamları uygulama