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

Başla

Google Mobile Ads SDK'sını bir 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 bu biçimi uygulama adımlarını uygulayabilirsiniz.

Başlamadan önce

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

Uygulama ön koşulları

Android Studio 3.2 veya sonraki bir sürümü kullanma
Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:
- minSdkVersion/19 veya daha yüksek
- compileSdkVersion/28 veya daha yüksek

AdMob hesabınızda uygulamanızı ayarlama

Aşağıdaki adımları tamamlayarak 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 kısımlarında gerekli olan benzersiz bir AdMob Uygulama Kimliği ile bir AdMob uygulaması oluşturur.

Uygulamanızı yapılandırma

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

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

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

Google Mobile Ads SDK'sı için bağımlıları, modülünüzün uygulama düzeyindeki Gradle dosyasına (app/build.gradle) ekleyin:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.1.0'
}
```
Uygulama kimliğinizi (AdMobkullanıcı arayüzünde belirtilir) uygulamanızın AndroidManifest.xml dosyasına ekleyin. AdMob Bunun için android:name="com.google.android.gms.ads.APPLICATION_ID" ile bir <meta-data> etiketi ekleyin. Uygulama kimliğinizi AdMob kullanıcı arayüzünde bulabilirsiniz. android:value için, kendi AdMob uygulama kimliğinizi tırnak içine alın.
```
<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 listelenen kimliği değil, gerçek AdMob uygulama kimliğinizi kullanın. Yalnızca bir Hello World uygulamasında SDK ile deneme yapmak istiyorsanız yukarıda gösterilen örnek uygulama kimliğini kullanabilirsiniz.

Ayrıca, <meta-data> etiketinin yukarıda gösterildiği şekilde eklenememesinin, mesajla birlikte bir kilitlenmeye yol açtığını da unutmayın:
```
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 bildirin.

Uygulamanız Google Mobile Ads SDK'sının 20.4.0 veya sonraki bir sürümünü kullanıyorsa SDK, com.google.android.gms.permission.AD_ID iznini otomatik olarak açıkladığı ve mümkün olduğunda Reklam Kimliği'ne 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ği'ne erişmesi 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>
```
com.google.android.gms.permission.AD_ID izin beyanı ve nasıl devre dışı bırakılacağı hakkında daha fazla bilgi için lütfen bu Play Console makalesini inceleyin.

Google Mobile Ads SDK'sını ilk kullanıma hazırlayın

Reklamları yüklemeden önce, uygulamanızın MobileAds.initialize() çağrısı yaparak Google Mobile Ads SDK'sını başlatmasını sağlayın. Bu SDK, 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 işlemin yalnızca bir kez (ideal olarak uygulama başlatılırken) yapılması gerekir.

MobileAds.initialize() çağrıldığında reklamlar 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, isteğe özel işaretleri (tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi) ayarlamanız veya reklamları yüklemeden önce başka bir şekilde işlem yapmanız gerekiyorsa Google Mobile Ads SDK'sını başlatmadan önce bu işlemi yaptığınızdan emin olun.

Bir Etkinlikte initialize() yönteminin nasıl çağrılacağına dair bir örneği aşağıda bulabilirsiniz:

Örnek MainActivity (özet)

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şleyici çağrılana kadar bekleyin. Bu, 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 reklam uygulamaya hazırsınız. AdMob Çeşitli reklam biçimleri sunduğundan, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilirsiniz.

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulama ile etkileşimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılığa yeni başladıysanız bu yerleşimlerle başlamak iyi bir fikir olabilir.

Banner reklamları uygulama

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kapsayan tam ekran reklamlar. Bunlar en iyi şekilde, bir uygulamanın yürütme akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında veya bir görevin tamamlanmasından hemen sonra) kullanılır.

Geçiş reklamlarını uygulama

Yerel biçim

Uygulamanızın görünümü ve tarzıyla uyumlu, özelleştirilebilir reklamlar. Bu 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.

Yerel reklamları uygulama

Ödül olarak verildi

Kısa videolar izleyen, oynanabilir 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 Mobil Reklamlar deposu, bu API'nin sunduğu farklı reklam biçimlerini nasıl kullanacağınızı gösterir.