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

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

    Modern

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

  3. Ad Manager web arayüzünde tanımlanan Ad Manager 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 Ad Manager web arayüzünde bulabilirsiniz. android:value için tırnak işaretleri arasında kendi Ad Manager uygulama kimliğinizi ekleyin.

    <manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    Gerçek bir uygulamada örnek uygulama kimliğini gerçek Ad Manager 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ğine 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"/>

   <!-- 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 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. Bu işlemi 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. Ad Manager, 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 tasarlayarak zengin bir kullanıcı deneyimine katkıda bulunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.

Google Ad Manager, yerel reklamları uygulamanın iki yolunu sunar: yerel stiller ve özel oluşturma aracılığıyla standart yerel reklamlar.

Yerel stiller, yerel reklamların uygulanmasını basitleştirmek için tasarlanmıştır ve bu biçime yeni başladıysanız mükemmel bir seçimdir. Özel oluşturma, sunularınızı oluştururken sahip olduğunuz özgürlüğü en üst düzeye çıkarmak için tasarlanmıştır.

Yerel stilleri uygulama Yerel reklamları uygulama (özel oluşturma)

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