Uyumlulaştırmayı ayarlama

Platform seçin: Android iOS Unity Flutter Android (Eski)

Bu kılavuzda, bir arabuluculuk bağdaştırıcısını Android uygulamanıza nasıl entegre edeceğiniz gösterilmektedir.

Ön koşullar

Bir reklam biçimi için arabuluculuğu entegre etmeden önce söz konusu reklam biçimini uygulamanıza entegre etmeniz gerekir:

Uyumlulaştırmayı ilk kez mi kullanıyorsunuz? Uyumlulaştırmaya giriş başlıklı makaleyi okuyun.

Teklif verme için: Google Mobile Ads SDK (Legacy) 18.3.0 veya daha yeni bir sürüm.

Başlat Google Mobile Ads SDK (Legacy)

Hızlı başlangıç kılavuzunda, Google Mobile Ads SDK (Legacy) cihazını nasıl başlatacağınız gösterilmektedir. Bu başlatma çağrısı sırasında uyumlulaştırma bağdaştırıcıları da başlatılır. İlk reklam isteğinde her reklam ağının tam katılımını doğrulamak için reklamları yüklemeden önce başlatma işleminin tamamlanmasını beklemeniz önemlidir.

Aşağıdaki örnek kodda, reklam isteğinde bulunmadan önce her bağdaştırıcının başlatma durumunu nasıl kontrol edebileceğiniz gösterilmektedir.

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

Reklamı hangi reklam ağı bağdaştırıcı sınıfının yüklediğini kontrol etme

Aşağıda, banner reklam için reklam ağı sınıf adını kaydeden örnek bir kod verilmiştir:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)

Bu yöntemle ilgili ayrıntılar için getMediationAdapterClassName() ile ilgili ResponseInfo belgelerine bakın.

Reklam nesnenizi bir Etkinlik örneğiyle başlatın

Yeni bir reklam nesnesinin oluşturucusunda (örneğin, AdManagerAdView), Context türünde bir nesne iletmeniz gerekir. Bu Context, uyumlulaştırma kullanılırken diğer reklam ağlarına iletilir. Bazı reklam ağları, Activity türünde daha kısıtlayıcı bir Context gerektirir ve Activity örneği olmadan reklam yayınlayamayabilir. Bu nedenle, uyumlulaştırılmış reklam ağlarınızda tutarlı bir deneyim sağlamak için reklam nesnelerini başlatırken bir Activity örneği iletmenizi öneririz.

Uyumlulaştırmada kullanılan banner reklam birimleri için tüm üçüncü taraf reklam kaynağı kullanıcı arayüzlerinde yenilemeyi devre dışı bıraktığınızdan emin olun. Ad Manager da banner reklam biriminizin yenileme hızına göre bir yenileme tetiklediğinden, bu işlem çift yenilemeyi önler.

Uyumlulaştırma ile doğal reklamları kullanma

Doğal uyumlulaştırmayı uygularken göz önünde bulundurmanız gereken bazı en iyi uygulamalar aşağıda verilmiştir.

Doğal reklam sunumu politikası
Her reklam ağının kendi politikaları vardır. Uyumlulaştırma kullanırken uygulamanızın, reklamı sağlayan uyumlulaştırılmış ağın politikalarına uyması gerektiğini unutmayın.
loadAds() yerine loadAd() kullanın
loadAds() yöntemi yalnızca Google reklamları yayınlar. Uyumlulaştırılmış reklamlar için loadAd() kullanın.

ABD eyalet gizlilik yasaları ve GDPR

ABD eyalet gizlilik yasalarına veya Genel Veri Koruma Yönetmeliği'ne (GDPR) uymanız gerekiyorsa Ad Manager Gizlilik ve Mesajlaşma'nın ABD eyaletleri veya GDPR reklam iş ortakları listesine aracılık iş ortaklarınızı eklemek için ABD eyalet tüzükleri ayarları ya da GDPR ayarları bölümündeki adımları uygulayın. Bunu yapmazsanız iş ortakları uygulamanızda reklam yayınlayamayabilir.

Google Kullanıcı Mesajlaşma Platformu (UMP) SDK'sı ile kısıtlanmış veri işlemeyi (KVİ) etkinleştirme ve GDPR izni alma hakkında daha fazla bilgi edinin.

Sonraki
Reklam kaynaklarını seçme