Başla

Google Mobile Ads SDK'sını bir uygulamaya entegre etmek, reklam gösterme 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 uygulama adımlarını uygulayabilirsiniz.

Başlamadan önce

Uygulamanızı hazırlamak için aşağıdaki bölümlerde verilen adımları tamamlayın.

Uygulama ön koşulları

  • Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:

    • Minimum SDK sürümü 19 veya üstü
    • Şu SDK sürümünü derleyin: 33 veya üzeri

AdMob hesabınızda uygulamanızı ayarlama

Aşağıdaki adımları uygulayarak uygulamanızı AdMob uygulaması olarak kaydedin:

  1. Bir AdMob hesabında oturum açın veya kaydolun.

  2. Uygulamanızı AdMob'a kaydedin. Bu adım, bu kılavuzun sonraki bölümlerinde ihtiyaç duyacağınız benzersiz bir AdMob Uygulama Kimliği'ne sahip bir AdMob uygulaması oluşturur.

Uygulamanızı yapılandırma

  1. Proje düzeyindeki build.gradle dosyanıza, hem buildscript hem de allprojects bölümlerinize Google'ın Maven deposu ile Maven merkezi deposunu ekleyin:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Google Mobile Ads SDK'sına ait bağımlılıkları, modülünüzün uygulama düzeyindeki Gradle dosyasına (normalde app/build.gradle) ekleyin:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.0'
    }
    
  3. AdMob Uygulama kimliğinizi, web arayüzünde AdMob belirtilen şekliyle 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 AdMob web arayüzünde bulabilirsiniz. android:value alanında, tırnak işaretleri arasında kendi AdMob uygulama kimliğinizi girin.

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

    Gerçek bir uygulamada, örnek uygulama kimliğini gerçekAdMob uygulama kimliğinizle değiştirin. Bir Hello World uygulamasında SDK ile yalnızca deneniyorsanız örnek kimliği kullanabilirsiniz.

    Ayrıca, <meta-data> etiketinin tam olarak gösterildiği gibi eklenmemesi şu mesajın bulunduğu bir kilitlenmeye neden olur:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (İsteğe bağlı) Önceki sürümlerin Android 13 ile çalışması için AD_ID iznini beyan edin.

    Uygulamanız Google Mobile Ads SDK'sının 20.4.0 veya daha sonraki bir sürümünü kullanıyorsa bu adımı atlayabilirsiniz. Bunun nedeni, SDK'nın com.google.android.gms.permission.AD_ID iznini otomatik olarak beyan etmesi ve reklam kimliği kullanılabilir olduğunda reklam kimliğine erişebilmesidir.

    Google Mobile Ads SDK'sının 20.3.0 veya daha eski bir sürümünü kullanan ve Android 13'ü hedefleyen uygulamalarda Reklam Kimliği'ne erişmek için Google Mobile Ads SDK'sının 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 bakın.

Google Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce MobileAds.initialize() yöntemini çağırarak Google Mobile Ads SDK'sını başlatın.

Bu yöntem, SDK'yı başlatır ve hem Google Mobile Ads SDK'sı hem de bağdaştırıcı başlatma işlemleri tamamlandığında veya 30 saniyelik zaman aşımının ardından bir tamamlama işleyicisi çağırır. Bu işlem yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması gerekir.

Reklamlar, başlatma sonrasında 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() ya da setTagForUnderAgeOfConsent() ya da başka bir işlem yapmak üzere reklamları yüklemeden önce isteğe özel işaretler ayarlayın. Google Mobile Ads SDK'sını başlatmadan önce bunu yaptığınızdan emin olun.

Bir Etkinlikte initialize() yönteminin nasıl çağrılacağına dair bir örnek:

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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    MobileAds.initialize(this) {}
  }
}

Reklam biçimi seçin

Google Mobile Ads SDK'sı içe aktarıldı ve bir reklam uygulamaya hazırsınız. AdMob Birçok farklı reklam biçimi sunduğu için uygulamanızın kullanıcı deneyimine en uygun olan biçimi seçebilirsiniz.

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örüntüledikleri anlamına gelir. Ayrıca, bu reklamlar aynı zamanda uygulanması en basit reklam biçimidir.

Banner reklamları uygulama

Geçişli

Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bunları, uygulamanızın arayüzündeki doğal ara ve geçişlere (ör. bir oyun uygulamasında seviye tamamlandıktan sonra) yerleştirin.

Geçiş reklamlarını uygulama

Yerel biçim

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

Yerel reklamlar uygulama

Ödül olarak verildi

Ödüllü reklam birimleri, kullanıcıların oyun oynayarak, anket yaparak veya video izleyerek jeton, ek can veya puan gibi uygulama içi ödüller kazanmalarını sağlar. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının aldığı ödül değerlerini ve öğelerini 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 jeton veya ekstra can gibi ödüller sunmanıza olanak tanıyan, teşvik edilen yeni bir reklam biçimidir.

Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamını izlemeyi etkinleştirmesi gerekmez.

Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında ödülü bildiren ve kullanıcılara isterlerse devre dışı bırakma fırsatı sunan bir giriş 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österilen bir reklam biçimidir. Reklam, yükleme ekranının üzerinde yer alır.

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

Ek kaynaklar

GitHub'daki Google Mobile Ads deposu, bu API'nin sunduğu farklı reklam biçimlerinin nasıl kullanılacağını gösterir.