Başla

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 bu biçimi uygulama adımlarını uygulayabilirsiniz.

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ı

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

    • minSdkVersion/19 veya üzeri
    • compileSdkVersion/28 veya üzeri

Uygulamanızı yapılandırma

  1. Proje düzeyindeki build.gradle dosyanıza Google Maven deposunu ve 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ıları, modülünüzün uygulama düzeyindeki Gradle dosyasına (app/build.gradle) ekleyin:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:22.4.0'
    }
    
  3. Ad Managerweb arayüzünde tanımlandığı gibi Ad Manager uygulamanızın kimliğini uygulamanızın AndroidManifest.xml dosyasına ekleyin. Bunun için android:name="com.google.android.gms.ads.APPLICATION_ID" ile bir <meta-data> etiketi ekleyin. Uygulama kimliğinizi Ad Manager web arayüzünde bulabilirsiniz. android:value için, kendi Ad Manager uygulama kimliğinizi tırnak 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, yukarıda listelenen kimliği değil, gerçek Ad Manager 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, <meta-data> etiketinin yukarıda gösterildiği şekilde eklenememesinin, mesajla birlikte bir kilitlenmeye yol açtığını da unutmayın:

    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, com.google.android.gms.permission.AD_ID iznini otomatik olarak açıkladığı ve mümkün olduğunda Reklam Kimliği'ne erişebildiği için 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, 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 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

Reklamları yüklemeden önce, uygulamanızın MobileAds.initialize() çağrısı yaparak Google Mobile Ads SDK'sını başlatmasını sağlayın. Bu API, SDK'yı başlatır ve ilk kullanıma hazırlama tamamlandıktan sonra veya 30 saniyelik zaman aşımının ardından bir tamamlama dinleyicisini geri çağırır. Bu işlemin yalnızca bir kez (ideal olarak uygulama başlatılırken) 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, tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi isteğe özel işaretler ayarlamanız veya reklamları yüklemeden önce başka bir şekilde 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 (özet)

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şleyici çağrılana kadar bekleyin. Bu, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.

Reklam biçimi seçin

Google Mobile Ads SDK'sı içe aktarıldı ve reklam uygulamaya hazırsınız. Ad Manager Çeşitli reklam biçimleri sunduğundan, uygulamanızın kullanıcı deneyimine en uygun 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 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 bu yerleşimlerle başlamak iyi bir fikir olabilir.

Banner reklamları uygulama

Geçişli

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

Geçiş reklamlarını uygulama

Yerel biçim

Uygulamanızın görünümü ve tarzıyla uyumlu, özelleştirilebilir reklamlar. Bu 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.

Google Ad Manager, yerel reklamları uygulamak için iki yol sunar: Yerel Stiller ve Özel Oluşturma.

Yerel Stiller, yerel reklamların uygulanmasını mümkün olduğunca kolaylaştırmak için tasarlanmıştır ve biçim konusunda yeniyseniz bu sizin için ideal olacaktır. Özel Oluşturma, sunularınızı oluşturma özgürlüğünüzü en üst düzeye çıkaracak şekilde tasarlanmıştır.

Yerel reklamları uygulama Yerel stilleri uygulama

Ödül olarak verildi

Kısa videolar izleyen, oynanabilir reklamlar ve 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 Mobil Reklamlar deposu, bu API'nin sunduğu farklı reklam biçimlerini nasıl kullanacağınızı gösterir.