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 kullanmak isteyen yayıncılar ve geliştiriciler için hazırlanmıştır. Uygulamanıza Firebase'i dahil etmeyi planlamıyorsanız bağımsız AdMob kılavuzunu inceleyin.

Henüz yapmadıysanız AdMob, Firebase ve Google Analytics'yi 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 özelliğinin etkinleştirildiğinden emin olun:

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

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

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

  1. Uygulamanızı AdMob uygulaması olarak kaydedin.

    1. AdMob hesabınızda oturum açın veya kaydolun.

    2. Uygulamanızı AdMob ile kaydetme. Bu adımda, benzersiz bir AdMob Uygulama Kimliği'ne sahip bir AdMob uygulaması oluşturulur. Bu kimliğe kılavuzun ilerleyen bölümlerinde ihtiyacınız olacaktır.

    Mobile Ads SDK'sını uygulamanıza eklemeniz istenir. Bu görevle 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 uygulamasının, AdMob hesabınızda seçilmiş analiz verilerini işlemesine ve göstermesine izin vermek için Kullanıcı Metrikleri'ni etkinleştirin. Ayrıca, AdMob uygulamanızı Firebase'e bağlamak için de bu ayarı etkinleştirmeniz gerekir.

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

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

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

AdMob uygulama kimliğinizi, <meta-data> etiketini aşağıda gösterildiği gibi ekleyerek 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ığı modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) ekleyin:

    implementation("com.google.android.gms:play-services-ads:25.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 etkinlikte initialize() yönteminin nasıl çağrılacağına dair bir örnek verilmiştir:

    Kotlin 

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

    Java 

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

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

Başlatıldıktan sonra Mobile Ads SDK'sı, uygulamanızdan analiz etkinliklerini ve kullanıcı özelliklerini otomatik olarak günlüğe kaydetmeye başlar. Uygulamanıza ek kod eklemeden veya reklam uygulamadan bu verileri görüntüleyebilirsiniz. Bu analiz verilerini görebileceğiniz yerler:

ARPU ve ARPPU metriklerini daha iyi temsil etmek için bu metriklerin gelir hesaplamasına ecommerce_purchase adlı analiz özel etkinliğinden elde edilen verileri dahil etmek isteyebileceğinizi unutmayın (nasıl yapacağınızı öğrenin).

5. adım: (İsteğe bağlı) Google Analytics ve Firebase'in diğer özelliklerini 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

    Daha fazla bilgi edinmek için AdMob uygulamalarında Google Analytics ve Firebase'i kullanma kılavuzunu inceleyin.

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

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

    • Remote Config, uygulama güncellemesi yayınlamadan uygulamanızın davranışını ve görünümünü değiştirmenize olanak tanır.

    • A/B Testing, uygulamanızın kullanıcı arayüzünde, özelliklerinde veya etkileşim kampanyalarında yaptığınız değişiklikleri test etmenize olanak tanır. Böylece, değişiklikleri geniş çapta kullanıma sunmadan önce önemli metrikleriniz (ör. gelir ve elde tutma) üzerinde bir etki yaratıp yaratmadıklarını öğrenebilirsiniz.

  • Uygulamanız için reklamdan para kazanmayı 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ıza sunma konusunda veriye dayalı kararlar alın. Daha fazla bilgi edinmek için aşağıdaki eğitimlere göz atın:

6. adım: Uygulamanızda kullanacağınız reklam biçimini seçin

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

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ıkta yeniyseniz bu reklamlar başlamak için idealdir.

Banner reklamları uygulama

Geçişli

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

Geçiş reklamları, uygulamanın yürütme akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra) kullanıldığında en iyi sonucu verir.

Geçiş reklamları uygulama

Yerel

Uygulamanızın görünümü ve genel havasıyla eşleşecek şekilde özelleştirilebilen reklamlar

Doğal reklamlar, bileşen tabanlı bir reklam biçimidir. Doğal reklamların nasıl ve nereye yerleştirileceğine siz karar verirsiniz. Böylece kullanılan düzen, 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 göze batmayan reklam sunumları oluşturabilirsiniz.

Doğal Gelişmiş Reklamları uygulama

Ödüllü

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

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

Ödüllü reklamları uygulama Ödüllü reklamları uygulama (yeni API'ler)