Bu sayfa, Cloud Translation API ile çevrilmiştir.

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çip uygulama adımlarını uygulayabilirsiniz.

Başlamadan önce

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

Uygulama ön koşulları

Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:
- minSdkVersion/19 veya üzeri
- compileSdkVersion/33 veya üzeri

AdMob hesabınızda uygulamanızı ayarlama

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

Bir AdMob hesabında oturum açın veya kaydolun.
Uygulamanızı AdMob'a kaydedin. Bu adım, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyacağınız benzersiz bir AdMob Uygulama Kimliği'ne sahip olan bir AdMob uygulaması oluşturur.

Uygulamanızı yapılandırma

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

buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

Google Mobile Ads SDK'sına ilişkin 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:22.5.0'
}
```
AdMob Uygulama kimliğinizi, web arayüzünde AdMob tanımlandığı şekilde 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>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
Gerçek bir uygulamada, yukarıda listelenenleri değil, gerçek AdMob uygulama kimliğinizi kullanın. Sadece bir Hello World uygulamasında SDK ile deneme yapmak istiyorsanız yukarıda gösterilen örnek uygulama kimliğini kullanabilirsiniz.

Ayrıca, <meta-data> etiketi yukarıda gösterildiği gibi eklenemediyse şu mesaja sahip bir kilitlenme ortaya çıkar:
```
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 üst bir sürümünü kullanıyorsa SDK com.google.android.gms.permission.AD_ID iznini otomatik olarak beyan ettiği ve uygun olduğunda reklam kimliğine erişebileceğ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 Reklam Kimliği'ne erişebilmek 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"/>

   
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>
```
com.google.android.gms.permission.AD_ID izin beyanı ve nasıl devre dışı bırakılacağı hakkında daha fazla bilgi edinmek için lütfen bu Play Console makalesini inceleyin.

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

Reklamları yüklemeden önce uygulamanızın Google Mobile Ads SDK'sını başlatmasını sağlayın. Bunun için MobileAds.initialize() yöntemini çağırın. Bu çağrı SDK'yı başlatır, başlatma işlemi tamamlandıktan sonra veya 30 saniyelik zaman aşımının ardından bir tamamlama işleyicisini geri çağırır. Bu işlem yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması gerekir.

Reklamlar, MobileAds.initialize() çağrısının ardından 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, tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi isteğe özel işaretler belirlemeniz ya da reklamları yüklemeden önce işlem yapmanız gerekiyorsa bu işlemi Google Mobile Ads SDK'sını başlatmadan önce yaptığınızdan emin olun.

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

Örnek MainActivity (alıntı)

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) {}
    }
}

Uyumlulaştırma kullanıyorsanız reklamları yüklemeden önce tamamlama işleyicinin çağrılana kadar bekleyin. Bu işlem, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.

Reklam biçimi seçin

Google Mobile Ads SDK'sı içe aktarıldı ve bir reklamı uygulamaya hazırsınız. AdMob Bir dizi farklı reklam biçimi sunar. Bu sayede uygulamanızın kullanıcı deneyimine en uygun olanı seçebilirsiniz.

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulamayla etkileşimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz, bu, başlamak için harika bir yerdir.

Banner reklamları uygulama

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. En iyi uygulama akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında ya da bir görev tamamlandıktan hemen sonra) kullanılır.

Geçiş reklamlarını uygulama

Yerel biçim

Uygulamanızın görünümü ve tarzıyla uyumlu olan özelleştirilebilir reklamlardır. Bu reklamların nasıl ve nereye yerleştirileceğine siz karar verirsiniz. Böylece düzen, uygulamanızın tasarımıyla daha tutarlı olur.

Yerel reklamlar uygulama

Ödül olarak verildi

Kısa videoları izleyen, ayrıca oynatılabilir reklamlar ve anketlerle etkileşimde bulunan kullanıcıları ödüllendiren reklamlar. Ücretsiz uygulamalardan para kazanmak için kullanılır.

Ödüllü reklamları 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.