Başla

Google Mobile Ads SDK'sını bir uygulamaya entegre etmek reklam gösterip gelir elde edebilirsiniz. SDK'yı entegre ettikten sonra şunları yapabilirsiniz: bir reklam biçimi (yerel veya ödüllü video gibi) seçin ve şu adımları uygulayın: uygulayacaksınız.

Başlamadan önce

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

Uygulama ön koşulları

  • Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:

    • SDK'nın minimum sürümü: 21 veya üzeri
    • Şu öğenin SDK sürümünü derle: 33 veya üzeri

Uygulamanızı yapılandırma

  1. Gradle ayarları dosyanıza Google'ın Maven deposu ve Maven merkez deposu:

    Kotlin

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include(":app")

    Modern

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. Google Mobile Ads SDK'sı için bağımlılıkları uygulama düzeyindeki derlemenize ekleyin dosya:

    Kotlin

    dependencies {
      implementation("com.google.android.gms:play-services-ads:23.3.0")
    }

    Modern

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Ad Manager Uygulama kimliğinizi, Ad Manager uygulamanızın arayüzüne AndroidManifest.xml dosya. Bunu yapmak için<meta-data> android:name="com.google.android.gms.ads.APPLICATION_ID". Daha fazla uygulama kimliğinizi Ad Manager web arayüzünde bulabilirsiniz. Örneğin, android:value, kendi uygulama Ad Manager kimliğinizi girin, tırnak işaretleri içine alın.

    <manifest>
      <application>
        <!-- Sample Ad Manager 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çek Ad Manager uygulama kimliği. Örnek kimliğini aşağıdaki durumlarda kullanabilirsiniz: bir Hello World uygulamasındaki SDK ile deneme yapıyorsunuz.

    Ayrıca, <meta-data> etiketinin tam olarak gösterilen sonuçlardaki gibi eklenemediğine dikkat edin. şu mesajla çakışıyor:

    Missing application ID.
    

    (İsteğe bağlı) Bildir Önceki sürümlerin Android'de çalışması için AD_ID izni 13.

    Uygulamanız Google Mobile Ads SDK'sı 20.4.0 sürümünü veya o kadar kolay değilse, SDK otomatik olarak com.google.android.gms.permission.AD_ID iznine sahip ve şunları yapabilir: olduğu zaman Reklam Kimliğine erişebilecektir.

    Google Mobile Ads SDK'sı 20.3.0 sürümünü veya daha düşük ve Android 13'ü hedefliyorsanız com.google.android.gms.permission.AD_ID izni Google Mobile Ads SDK'sı için AndroidManifest.xml dosyası Reklam Kimliğine erişin:

    <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ı, nasıl devre dışı bırakılacağı da dahil olmak üzere bu işlev hakkında daha fazla bilgi için Play Konsol makalesi.

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

Reklamları yüklemeden önce, şunu çağırarak Google Mobile Ads SDK'sını başlatın: MobileAds.initialize().

Bu yöntem SDK'yı başlatır ve hem Google Mobile Ads SDK'sı ve bağdaştırıcı başlatma işlemleri tamamlandıktan sonra veya 30 saniye zaman aşımı. Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.

Reklamlar, Google Mobile Ads SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir gerçekleşmesini sağlar. Avrupa'daki kullanıcılardan izin almanız gerekiyorsa Ekonomik Alanı (AEA) kullanıyorsanız, şunlar gibi isteğe özel işaretleri ayarlayın: setTagForChildDirectedTreatment() veya setTagForUnderAgeOfConsent(), veya Aksi takdirde, reklamları yüklemeden önce işlem yapın. Başlatmadan önce bunu yaptığınızdan emin olun. Google Mobile Ads SDK'sı.

Aşağıda, arka planda initialize() yönteminin nasıl çağrılacağına dair bir örnek verilmiştir bir Etkinlik içindeki ileti dizisi:

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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Reklam biçimi seçin

Google Mobile Ads SDK'sı içe aktarıldı ve reklam uygulamaya hazırsınız. Ad Manager birçok farklı reklam biçimi sunar. uygulamanızın kullanıcı deneyimine en uygun seçeneği belirleyebilirsiniz.

Banner reklam birimleri, uygulamanın bir bölümünü kaplayan dikdörtgen reklamlar kullanır. Belirli bir süre sonra otomatik olarak yenilenebilirler. Bunun anlamı şudur: Kullanıcılar, aynı reklam yayınında kalsalar bile düzenli aralıklarla yeni bir reklam görüntüler ekleyebilirsiniz. Ayrıca, uygulanması en basit reklam biçimidir.

Banner reklam uygulama

Geçiş reklamı

Geçiş reklam birimleri, uygulamanızda tam sayfa reklamlar gösterir. Doğal bir yere yerleştirin Seviye tamamlandıktan sonra olduğu gibi uygulamanızın arayüzündeki aralar ve geçişler en iyi uygulamaları paylaşacağız.

Geçiş reklamlarını uygulama

Yerel biçim

Doğal reklamlar, başlık ve resim gibi öğelerin nasıl özelleştirileceğini harekete geçirici mesajlar, uygulamalarınızda sunulur. Reklamın stilini kendiniz belirleyerek şunları yapabilirsiniz: göze çarpmayan, doğal ve göze batmayan reklam sunumları hazırlayın. sunmaktır.

Google Ad Manager yerel reklamları uygulamak için iki yol sunar: yerel stiller ve standart doğal reklamlar için özel oluşturma sunar.

Yerel stiller, yerel reklamların uygulanmasını kolaylaştırmak için tasarlanmıştır. Ayrıca formatta yeniyseniz bu iyi bir seçimdir. Özel oluşturma maksimum özgürlük için tasarlanmamıştır.

Yerel stilleri uygulama Yerel reklamları uygulama (özel oluşturma)

Ödüllü

Ödüllü reklam birimleri, kullanıcıların aşağıdaki işlemleri yapmak için oyun oynamasına, anket yanıtlamasına veya video izlemesine olanak tanır. Jeton, ekstra can veya puan gibi uygulama içi ödüller kazanabilirsiniz. Faturalandırma hesabınızdaki ücretleri takip etmek için Farklı reklam birimleri için farklı ödüller belirleyin ve ödül değerlerini ve kullanıcının aldığı öğe sayısı.

Ödüllü reklamları uygulama

Ödüllü geçiş reklamı

Ödüllü geçiş reklamı, bir teşvikle sunulan yeni bir reklam biçimidir. otomatik olarak görünen reklamlar için jeton veya ekstra can gibi ödüller sunma doğal uygulama geçişleri sırasında.

Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamı.

Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında giriş ekranında ödül duyurur ve kullanıcılara kapsam dışında kalmayı seçmeleri için ve bunu yapmak istiyorlar.

Ödüllü geçiş reklamlarını uygulama

Uygulama açılışı

Uygulama açılışı, kullanıcılar uygulamanızı açtığında veya uygulamanıza geri döndüğünde uygulamasını indirin. Reklam, yükleme ekranının üzerinde görünür.

Uygulama açılış reklamlarını uygulama

Ek kaynaklar

GitHub'daki Google Mobile Ads deposu, farklı reklam biçimlerini nasıl kullanacağınızı öğreneceksiniz.