Android projenizde AdMob'u kullanmaya başlama

Bu hızlı başlangıç kılavuzu, Firebase ile oluşturulmuş bir uygulamadan para kazanmak için AdMob'i kullanmak isteyen yayıncılara ve geliştiricilere yöneliktir. Uygulamanıza Firebase'i dahil etmeyi düşünmüyorsanız bunun yerine bağımsız AdMob kılavuzuna bakın.

Henüz kullanmadıysanız AdMob, Firebase ve Google Analytics'i birlikte kullanmanın tüm avantajları hakkında bilgi edinin.

Başlamadan önce

• Firebase projeniz ve Firebase uygulamanız yoksa Firebase başlangıç kılavuzundaki adımları izleyin: Firebase'i Android projenize ekleme.

• Firebase projenizde Google Analytics'ün etkinleştirildiğinden emin olun:

  • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics politikasını etkinleştirin.

  • Google Analytics'ün etkinleştirilmediği bir Firebase projeniz varsa Google Analytics'ü settings > Proje ayarları bölümündeki Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

1. adım: Uygulamanızı AdMob hesabınızda ayarlayın

1. 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 ihtiyacınız olacak benzersiz bir AdMobUygulama Kimliği içeren bir AdMob uygulaması oluşturulur.

   Mobile Ads SDK'sını uygulamanıza eklemeniz istenir. Bu işlemle ilgili ayrıntılı talimatları bu kılavuzun ilerleyen bölümlerinde bulabilirsiniz.

2. AdMob uygulamanızı Firebase uygulamanıza bağlayın.

   Bu adım isteğe bağlıdır ancak kesinlikle önerilir. Kullanıcı metriklerini etkinleştirmenin ve AdMob uygulamanızı Firebase'e bağlamanın avantajları hakkında daha fazla bilgi edinin.

   AdMob hesabınızın Uygulamalar kontrol panelinde aşağıdaki iki adımı tamamlayın:

   1. AdMob hesabınızın, seçili analiz verilerini işleyip görüntülemesine izin vermek için Kullanıcı Metrikleri'ni etkinleştirin. Ayrıca, uygulamanızı Firebase'e bağlamanız için gerekli bir ayardır.

   2. AdMob uygulamanızı mevcut Firebase projenize ve Firebase uygulamanıza bağlayın.

      Firebase uygulamanız için girdiğiniz paket adını girdiğinizden emin olun. Firebase uygulamanızın paket adını, settings > Proje ayarları bölümündeki Uygulamalarınız kartında bulabilirsiniz.

2. Adım: AdMob uygulama kimliğinizi AndroidManifest.xml dosyanıza ekleyin

<meta-data> etiketini aşağıda gösterildiği gibi ekleyerek AdMob Uygulama Kimliğinizi uygulamanızın AndroidManifest.xml dosyasına 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="ADMOB_APP_ID"/>
    </application>
</manifest>

3. Adım: Mobile Ads SDK'sını ekleyin ve başlatın

1. Google Mobile Ads SDK'sına ait bağımlılık bilgisini modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) ekleyin:

   implementation("com.google.android.gms:play-services-ads:23.5.0")
   

2. Reklamları yüklemeden önce MobileAds.initialize() yöntemini çağırın.

   Bu çağrı, SDK'yı ilk kullanıma hazırlar ve ilk kullanıma hazırlama işlemi tamamlandıktan sonra (veya 30 saniyelik zaman aşımının ardından) bir tamamlama işleyicisi çağırır. Bu yöntemi yalnızca bir kez ve mümkün olduğunca erken, ideal olarak uygulama başlatılırken çağırın.

   Aşağıda, bir Etkinlik'te initialize() yönteminin nasıl çağrılacağıyla ilgili bir örnek verilmiştir:

   Kotlin+KTX

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       // ...
       MobileAds.initialize(this)
   }
   MainActivity.kt

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // ...
       MobileAds.initialize(this);
   }
   MainActivity.java

4. adım: Kullanıcı metriklerini ve analiz verilerini görüntüleyin

Mobile Ads SDK'sı, başlatıldıktan sonra uygulamanızdan analiz etkinliklerini ve kullanıcı özelliklerini otomatik olarak kaydetmeye başlar. Bu verileri uygulamanıza ek kod eklemeden veya reklam uygulamadan görüntüleyebilirsiniz. Bu analiz verilerini şuradan görebilirsiniz:

• AdMob hesabınızın (Ana Sayfa veya Uygulamalar kontrol paneli) Kullanıcı metrikleri kartında, toplanan analiz verilerinden elde edilen ve ortalama oturum süresi, KBOG ve elde tutma gibi, seçilmiş kullanıcı metriklerini görüntüleyebilirsiniz.

• Firebase konsolunun Analytics kontrol panelinde toplu istatistikleri ve önemli metriklerin özetlerini görüntüleyebilirsiniz. Google Analytics için Firebase SDK'sını eklerseniz Firebase konsolunda reklam kampanyaları için dönüşümleri işaretleyebilir ve özel kitleler oluşturabilirsiniz.

KBOG ve ARPPU metriklerini daha iyi temsil etmek için ecommerce_purchase adlı bir Analytics özel etkinliğinden elde edilen verileri bu metriklerin gelir hesaplamasına dahil edebilirsiniz (nasıl yapılacağını öğrenin).

5. Adım: (İsteğe bağlı) Google Analytics ve Firebase'in daha fazla özelliğini kullanın

Uygulamadan para kazanma ve kullanıcı etkileşimini artırmak için daha fazla fırsat ve özellikten yararlanın:

• Google Analytics için Firebase SDK'sını ekleme ve kullanma

  • Uygulamanızda özel etkinlik günlük kaydını uygulayın.

  • Özel reklam kampanyaları için dönüşümleri işaretleyin.

  • KBOG ve ARPPU metriklerinin gelir hesaplamasına ecommerce_purchase etkinlik verilerini dahil edin.

  Daha fazla bilgi için Google Analytics ve Firebase'i AdMob uygulamalarıyla kullanma konulu kılavuzu inceleyin.

• Uygulamanızda diğer Firebase ürünlerini kullanma

  Google Analytics için Firebase SDK'sını ekledikten sonra uygulamanızdaki reklamları optimize etmek amacıyla diğer Firebase ürünlerini kullanın.

  • Remote Config, uygulama güncellemesi yayınlamadan sınırsız sayıda günlük etkin kullanıcı için ücretsiz olarak uygulamanızın davranışını ve görünümünü değiştirmenizi sağlar.

  • A/B Testing, uygulamanızın kullanıcı arayüzünde, özelliklerinde veya etkileşim kampanyalarında yaptığınız değişiklikleri geniş çaplı kullanıma sunmadan önce test etmenizi sağlar. Böylece, bu değişikliklerin temel metrikleriniz (ör. gelir ve elde tutma) üzerinde bir etkisi olup olmadığını öğrenebilirsiniz.

• Uygulamanız için reklamlardan para kazanma sürecini optimize etme

  Küçük bir kullanıcı alt kümesiyle farklı reklam biçimlerini veya yapılandırmalarını deneyin ve ardından reklamı tüm kullanıcılarınız için uygulama konusunda veriye dayalı kararlar alın. Daha fazla bilgi edinmek için aşağıdaki eğiticileri inceleyin:

  • Yeni reklam biçimi kullanımını test etme (genel bakış | uygulama).

  • Reklam sıklığını optimize edin (genel bakış | uygulama).

6. Adım: Uygulamanızda uygulanacak bir reklam biçimi seçin

AdMob, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilmeniz için çeşitli farklı reklam biçimleri sunar. AdMob dokümanlarında ayrıntılı uygulama talimatlarını görüntülemek için bir reklam biçiminin düğmesini tıklayın.

Banner

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar

Banner reklamlar, kullanıcılar uygulamayla etkileşim kurarken ekranda kalmaya devam eder ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılık konusunda yeniyseniz bu kaynaklardan yararlanabilirsiniz.

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar

Geçiş reklamları en iyi şekilde, uygulamanın akışındaki doğal duraklamalar sırasında (ör. bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra) kullanılır.

Yerel

Uygulamanızın görünümü ve tarzıyla eşleşen özelleştirilebilir reklamlar

Yerel reklamlar, bileşen tabanlı bir reklam biçimidir. Doğal reklamların nasıl ve nereye yerleştirileceğine siz karar verirsiniz. Böylece düzeniniz uygulamanızın tasarımıyla daha tutarlı olur. Yazı tiplerini, renkleri ve diğer ayrıntıları kendiniz seçerek zengin bir kullanıcı deneyimi sunabilecek doğal ve rahatsız edici olmayan reklam sunumları oluşturabilirsiniz.

Ödüllü

Kısa videoları izleyen, ayrıca oynatılabilir reklamlar ve anketlerle etkileşimde bulunan kullanıcıları ödüllendiren reklamlardır.

Ödüllü (veya "ödül tabanlı") reklamlar, ücretsiz içerik kullanıcılarından para kazanmanıza yardımcı olabilir.