开始

Google Mobile Ads SDK'sını bir uygulamaya entegre etmek, reklamları görüntülemeye ve gelir elde etmeye yönelik ilk adımdır. SDK'yı entegre ettikten sonra, bir reklam biçimi (yerel veya ödüllü video gibi) seçebilir ve bunu uygulamak için adımları izleyebilirsiniz.

Sen başlamadan önce

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

Uygulama önkoşulları

  • Android Studio 3.2 veya üstünü kullanın
  • Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:

    • Bir minSdkVersion bölgesinin 16 ya da daha yüksek
    • Bir compileSdkVersion arasında 28 ya da daha yüksek

AdMob hesabınızda uygulamanızı kurun

Aşağıdaki adımları tamamlayarak uygulamanızı bir AdMob uygulaması olarak kaydedin:

  1. İçin oturum açın ya kaydolmak AdMob hesabı.

  2. AdMob'la uygulamanızı kaydedin . Bu adım benzersiz olan bir AdMob uygulama oluşturur AdMob Uygulama Kimliği bu kılavuzun sonraki gereklidir.

Uygulamanızı yapılandırın

  1. Projeniz düzeyi olarak build.gradle dosyası içerir Google'ın Maven depo ve Maven'in merkezi depo sizin hem de buildscript ve allprojects bölümler:

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

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:20.5.0'
    }
    
  3. Senin ekleyin AdMob (uygulama kimliğini tespitAdMobUI uygulamanızın kadar) AndroidManifest.xml dosyası. Bunu yapmak için, bir ekleme <meta-data> içeren etiketi android:name="com.google.android.gms.ads.APPLICATION_ID" . İçeri uygulama kimliğinizi bulabilirsiniz AdMob UI. For android:value , kendi insert AdMob uygulama kimliği, tırnak işaretleri.

    <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 uygulamasında, gerçek kullanmak AdMob uygulama kimliğini değil, yukarıda listelenen tek. Yalnızca bir Hello World uygulamasında SDK ile deneme yapmak istiyorsanız, yukarıda gösterilen örnek uygulama kimliğini kullanabilirsiniz.

    Başarısızlık eklemek de unutmayın <meta-data> mesaj içeren bir kazada sonuçlarının yukarıda gösterildiği gibi etiket:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (İsteğe bağlı) Declare AD_ID Android S ile çalışmalarına önceki sürümleri için izin

    Uygulama Google Mobil Reklamlar SDK sürümü 20.4.0 veya üstü kullanırsa SDK otomatik beyan beri, bu adımı atlayabilirsiniz com.google.android.gms.AD_ID izni ve mevcut olduğunda ona Reklam Kimliği erişebilir.

    Google Mobil Reklamlar SDK sürümü 20.3.0 kullanın veya düşürmek ve Android S hedefleyen uygulamalar için, eklemek gerekir com.google.android.gms.AD_ID izne AndroidManifest.xml Android S hedeflemek için dosyanın:

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
            <-- For Android S devices & GMA SDK version 20.3.0 or lower -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
        </application>
    </manifest>
    

    Daha öğrenmek için com.google.android.gms.AD_ID bunu devre dışı bırakma dahil izni bildiriminde, bu başvurun Çal Konsol makalesinde .

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

Yükleme reklamlar önce, çağırarak Google Mobil Reklamlar SDK ilklendir uygulamanıza sahip MobileAds.initialize() SDK başlatır ve başlatma tamamlandı (veya 30 saniyelik bir zaman aşımı sonra) bir kez çağrıları bir tamamlama dinleyici destekliyor. Bunun yalnızca bir kez, ideal olarak uygulama başlatılırken yapılması gerekir.

Reklamlar çağrı üzerine Google Mobil Reklamlar SDK veya arabuluculuk ortağı SDK'larının önceden yüklenmiş olabilir MobileAds.initialize() . Avrupa Ekonomik Alanı (EEA) kullanıcılar rızasını almak gerekiyorsa, (gibi herhangi bir istek özgü bayrakları set tagForChildDirectedTreatment veya tag_for_under_age_of_consent ), ya da başka yükleme reklamlar önce harekete geçmek Google Mobil Reklamlar SDK başlatılıyor önce bunu sağlamak .

İşte çağırmak nasıl bir örnek initialize() Bir Faaliyet yöntem:

Ö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şleyicisinin çağrılmasını bekleyin.

Bir reklam biçimi seçin

Google Mobile Ads SDK'sı artık içe aktarılmıştır ve bir reklam uygulamaya hazırsınız.AdMob teklifler farklı reklam biçimlerinin bir dizi uygulamanızın kullanıcı deneyimi uyan en iyi Şunu seçebilmesi.

Cihaz ekranının üstünde veya altında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulamayla etkileşime girerken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz, başlamak için harika bir yerdir.

Banner reklamları uygulayın

geçiş reklamı

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

Geçiş reklamları uygulayın

Yerli

Uygulamanızın görünümüne ve tarzına uyan özelleştirilebilir reklamlar. Nasıl ve nereye yerleştirileceğine siz karar verirsiniz, böylece mizanpaj uygulamanızın tasarımıyla daha tutarlı olur.

Yerel reklamları uygulayın

Ödüllü

Kullanıcıları kısa videolar izledikleri ve oynatılabilir reklamlar ve anketlerle etkileşim kurdukları için ödüllendiren reklamlar. Oynaması ücretsiz uygulamalardan para kazanmak için kullanılır.

Ödüllü reklamları uygulayın

Ek kaynaklar

Google Mobil Reklamlar depo GitHub'dan bu API teklifler farklı reklam biçimlerini nasıl kullanılacağını göstermektedir.