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:22.6.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 uygulamanızın Google Mobile Ads SDK'sını başlatmasını sağlayın: MobileAds.initialize() çağrısı, SDK'yı başlatır ve başlatma işlemi tamamlandıktan sonra 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, 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 ayarlamanız ya da reklamları yüklemeden önce başka bir 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) {}
    }
}

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.

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, mobil reklamlar mükemmel bir başlangıç noktasıdır.

Banner reklamları uygulama

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. Bunlar en iyi uygulama akışındaki doğal duraklamalarda, örneğin bir oyunun seviyeleri arasında veya 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üne ve tarzına uyan özelleştirilebilir reklamlar. 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

Kullanıcıları kısa videolar izlemeleri veya oynanabilir reklamlar ve anketlerle etkileşimde bulunmaları karşılığında ödüllendiren reklamlar. Ücretsiz oynanabilen 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.