Başlayın

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 bunu 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.

Uygulamanın ön koşulları

  • Android Studio 3.2 veya sonraki bir sürümü kullanma
  • Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:

    • 16 veya daha yüksek bir minSdkVersion
    • 28 veya daha yüksek bir compileSdkVersion

Uygulamanızı AdMob hesabınızda ayarlama

Aşağıdaki adımları tamamlayarak 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 ilerleyen bölümlerinde gerekli olacak benzersiz bir AdMob Uygulama Kimliği ile AdMob uygulaması oluşturur.

Uygulamanızı yapılandırma

  1. Proje düzeyindeki build.gradle dosyanızda, hem buildscript hem de allprojects bölümlerinize Google's Maven deposu ve Maven merkezi deposu ekleyin:

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

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:20.6.0'
    }
    
  3. Uygulama kimliğinizi (AdMob kullanıcı arayüzünde tanımlanan uygulama kimliğinizi AndroidManifest.xmlAndroidManifest.xml dosyanıza ekleyin. Bunu yapmak için android:name="com.google.android.gms.ads.APPLICATION_ID" öğesine sahip bir <meta-data> etiketi ekleyin. Uygulama kimliğinizi AdMob kullanıcı arayüzünde bulabilirsiniz. android:value için, tırnak işaretleri arasında bulunan AdMob kendi 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, yukarıda listelenen kimliği değil, gerçek AdMob uygulama kimliğinizi kullanın. Yalnızca 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> etiketinin eklenememesi, iletiyle birlikte 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 bildirin.

    Uygulamanız, Google Mobile Ads SDK'sının 20.4.0 veya sonraki bir sürümünü kullanıyorsa SDK otomatik olarak com.google.android.gms.permission.AD_ID iznini bildirdiğinden ve mümkün olduğunda Reklam Kimliğine erişebildiğinden bu adımı atlayabilirsiniz.

    Google Mobile Ads SDK'sının 20.3.0 veya önceki sürümlerini 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 izni 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 lütfen bu Play Console makalesine bakın.

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

Reklam yüklemeden önce uygulamanızın SDK'yı başlatan MobileAds.initialize() çağrısı yaparak Google Mobile Ads SDK'sını başlatmasını sağlayın. Ayrıca, ilk kullanıma hazırlama işlemi tamamlandıktan sonra (veya 30 saniyelik bir zaman aşımı süresi dolduktan sonra) bir tamamlanma işleyicisi geri çağrılır. Bu işlemin ideal olarak yalnızca uygulama başlatılırken yapılması gerekir.

MobileAds.initialize() çağrısı yapıldıktan sonra 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şaretlemeler (tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi) ayarlamanız veya reklamları yüklemeden önce başka bir 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 (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 tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlayacağından, reklamları yüklemeden önce tamamlama işleyicinin çağrılmasını bekleyin.

Reklam biçimi seçme

Google Mobile Ads SDK'sı artık içe aktarıldı ve reklam uygulamaya hazırsınız. AdMob Farklı reklam biçimleri sunduğu için, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilirsiniz.

Cihaz ekranının üstünde veya altı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 başlangıç için mükemmel bir kaynaktır.

Banner reklamlar uygulama

Geçiş

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

Geçiş reklamlarını uygulama

Yerel

Uygulamanızın görünümüne ve tarzına uyan özelleştirilebilir reklamlar. 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 bulundukları için 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.