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

Başlayın

Reklamları göstermenin ve gelir elde etmenin ilk adımı Google Mobile Ads SDK'sını bir uygulamaya entegre etmektir. 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 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, daha sonra bu rehberde olması gereken 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'ın Maven deposunu ve Maven merkezi deposunu hem buildscript hem de allprojects bölümlerine 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 (normalde app/build.gradle) ekleyin:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.5.0'
}
```
AdMob Uygulama kimliğinizi (kullanıcı arayüzündeAdMob tanımlanır) 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 kullanıcı arayüzünde bulabilirsiniz. android:value alanına, tırnak işaretleri içinde yazılan AdMob uygulama kimliğinizi ekleyin.
```
<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. Bir Hello World uygulamasında SDK ile deneme yapmak istiyorsanız yukarıda gösterilen örnek uygulama kimliğini kullanabilirsiniz.

Ayrıca, yukarıda gösterildiği gibi <meta-data> etiketini eklememenin mesajda bir kilitlenmeye neden olduğunu 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 izni beyan edin.

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 beyan ettiğinden ve kullanılabilir olduğunda reklam kimliğine erişebildiğinden 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 makalesine bakın.

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

Reklamları yüklemeden önce, uygulamanızın Google Mobile Ads SDK'sını ilk kullanıma hazırlamasını sağlayın. MobileAds.initialize() yöntemini çağırarak 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ırsınız. Bu işlemin ideal olarak uygulama başlatma aşamasında yapılması yeterlidir.

MobileAds.initialize() çağrılınca 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 yapın.

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

Örnek Ana Etkinlik (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ılmasını bekleyin. Böylece tüm uyumlulaştırma bağdaştırıcılarının başlatılması sağlanır.

Reklam biçimi seçin

Google Mobile Ads SDK'sı artık içe aktarıldı ve reklam uygulamaya hazırsınız. AdMob Çeşitli reklam biçimleri sunduğu için, 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 uygulamayla etkileşim kurarken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılığa yeni başladıysanız başlangıç için mükemmel bir seçenektir.

Banner reklamları uygulama

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kapsayan tam ekran reklamlar. Bunlar, uygulama yürütme akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra) en iyi şekilde 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 ve oynatılabilir reklamlar ile 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çimlerini nasıl kullanacağınızı gösterir.