Başlama

Bu kılavuzda, uyumlulaştırma bağdaştırıcının Android uygulamanıza nasıl entegre edileceği gösterilmektedir.

Ön koşullar

Bir reklam biçimi için arabuluculuğu entegre edebilmek üzere önce bu reklam biçimini uygulamanıza entegre etmeniz gerekir:

• Banner Reklamlar
• Geçiş reklamları
• Yerel Reklamlar
• Ödüllü Reklamlar
• Ödüllü Geçiş Reklamları

Uyumlulaştırma konusunda yeni misiniz? Uyumlulaştırmayla ilgili giriş bölümünü okuyun.

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

Mobile Ads SDK'sını ilk kullanıma hazırlayın

Hızlı başlangıç kılavuzunda, Mobile Ads SDK'sını nasıl ilk kullanıma hazırlayacağınız gösterilmektedir. Bu ilk kullanıma hazırlama ç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ı sağlamak için reklamları yüklemeden önce ilklendirmenin tamamlanmasını beklemek önemlidir.

Aşağıdaki örnek kodda, reklam isteği göndermeden önce her adaptörün başlatma durumunu nasıl kontrol edebileceğiniz gösterilmektedir.

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
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 -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

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) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

Reklamı hangi reklam ağı adaptör sınıfının yüklediğini kontrol etme

Aşağıda, banner reklamın reklam ağı sınıf adını günlüğe kaydeden örnek bir kod verilmiştir:

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

Bu yöntemle ilgili ayrıntılar için getMediationAdapterClassName() adresindeki ResponseInfo belgelerini inceleyin.

Reklam nesnenizi bir etkinlik örneğiyle başlatma

Yeni bir reklam nesnesi (ör. AdManagerAdView) için oluşturucuda Context türündeki bir nesne göndermeniz gerekir. Bu Context, uyumlulaştırma kullanılırken diğer reklam ağlarına iletilir. Bazı reklam ağları, Activity türündeki 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ızla tutarlı bir deneyim sağlamak için reklam nesnelerini başlatırken bir Activity örneği iletmenizi öneririz.

Uyumlaştırma ile banner reklamları kullanma

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, banner reklam biriminizin yenileme hızına göre de yenileme tetikler. Bu nedenle, bu işlem iki kez yenilemeyi önler.

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

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

Yerel reklam sunumu politikası

Her reklam ağının kendi politikaları vardır. Uyumlulaştırma kullanılırken uygulamanızın, reklamı sağlayan uyumlulaştırılmış ağın politikalarına uymaya devam etmesi gerektiğini unutmayın.

loadAds() yerine loadAd() kullanın

loadAds() yöntemi yalnızca Google reklamları yayınlar. Aracılıklı reklamlar için bunun yerine loadAd() değerini 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 uyumlulaştırma iş ortaklarınızı eklemek için ABD eyalet yönetmelikleri ayarlarındaki veya GDPR ayarlarındaki adımları uygulayın. Aksi takdirde iş ortaklarınız uygulamanızda reklam yayınlayamayabilir.