Başlayın

Reklam görüntülemenin ve gelir elde etmenin ilk adımı, Google Mobile Ads SDK'sını uygulamaya entegre etmektir. SDK'yı entegre ettikten sonra bir reklam biçimi (yerel veya ödüllü video gibi) seçebilir ve bunu uygulamak için ilgili adımları uygulayabilirsiniz.

Başlamadan önce

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

Uygulama ö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:

    • 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:

  1. Bir AdMob hesabında oturum açın veya kaydolun.

  2. Uygulamanızı AdMob'a kaydedin. Bu adım, bu kılavuzun ilerleyen kısımlarında ihtiyaç duyulan benzersiz AdMob Uygulama Kimliğine sahip bir AdMob uygulaması oluşturur.

Uygulamanızı yapılandırma

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

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

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.1.0'
    }
    
  3. 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 için tırnak işaretleri içine alınmış 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, 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, yukarıda gösterildiği gibi <meta-data> etiketinin eklenmemesi, mesajla birlikte 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 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 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 Reklam Kimliğine erişmek üzere Google Mobile Ads SDK'sı 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

Reklam yüklemeden önce SDK'yı başlatan 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ğıran MobileAds.initialize() çağırarak uygulamanızın Google Mobile Ads SDK'sını ilk kullanıma hazırlamasını sağlayın. Bunun yalnızca uygulama başlatma sırasında yalnızca bir kez 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şaretler (tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi) ayarlamanız veya reklam yüklemeden önce başka bir işlem yapmanız gerekiyorsa Google Mobile Ads SDK'sını başlatmadan önce bunu yapın.

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 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ı başlatılır.

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ğ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österilen 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ıkta yeniyseniz başlangıç için bu harika bir yerdir.

Banner reklamlar uygulama

Geçiş

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. Bunlar en iyi, uygulamanın yürütülme sürecindeki doğal duraklamalarda (örneğin, bir oyunun seviyeleri arasında veya bir görevin tamamlanmasından hemen sonra) kullanılır.

Geçiş reklamlarını uygulama

Yerel

Uygulamanızın görünümü ve tarzıyla uyumlu özelleştirilebilir reklamlar. Nasıl ve nereye yerleştirildiklerine siz karar verirsiniz. Böylece düzen, uygulamanızın tasarımıyla daha tutarlı olur.

Yerel reklam 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 veri havuzu, bu API'nin sunduğu farklı reklam biçimlerinin nasıl kullanılacağını gösterir.