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

Uyumlulaştırmayı bir reklam biçimi için entegre etmeden önce, entegre etmeniz gerekir. reklam biçimini uygulamanıza entegre edebilirsiniz:

Uyumlulaştırmada yeni misiniz? Okunanlar Uyumlulaştırmaya giriş.

Teklifli sistem için: Google Mobile Ads SDK'sı 18.3.0 veya daha yüksek olabilir.

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 ilk kullanıma hazırlanmasını isteyin. İ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 kod, her bağdaştırıcının başlatma işlemini nasıl kontrol edebileceğinizi gösterir durumu hakkında daha fazla bilgi edinin.

Java

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

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) { 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ı yükleyen reklam ağı bağdaştırıcısı sınıfını kontrol etme

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

Java

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

Kotlin

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

getMediationAdapterClassName() adresindeki ResponseInfo belgelerine bakın bu yöntemle ilgili ayrıntılara göz atın.

Reklam nesnenizi bir etkinlik örneğiyle başlatma

Yeni bir reklam nesnesinin kurucusuna (örneğin, AdManagerAdView), Context türüne ait bir nesne göndermeniz gerekir. Uyumlulaştırma kullanılırken bu Context, diğer reklam ağlarına aktarılır. Biraz reklam ağları, aynı türde daha kısıtlayıcı bir Context gerektirir Activity ve Activity örneği olmadan reklam yayınlayamayabilir. Dolayısıyla, reklam nesnelerini başlatırken bir Activity örneği iletmenizi öneririz uyumlulaştırılmış reklam ağlarınızda tutarlı bir deneyim sağlayın.

Uyumlulaş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. Bu, bir Ad Manager da yenilemeyi tetiklediği için çift yenileme yenilenme hızına göre değiştirebilirsiniz.

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

Aşağıda, yerel reklamları uygularken göz önünde bulundurulması gereken en iyi uygulamalardan bazıları verilmiştir uyumlulaştırma.

Yerel reklam sunumu politikası
Her reklam ağının kendi politikaları vardır. Uyumlulaştırmadan yararlanırken en önemli nokta Uygulamanızın hâlâ uyumlulaştırılmış reklamı sağlayan ağ.
loadAds() yerine loadAd() kullanın
loadAds() yöntemi yalnızca Google reklamlarını yayınlar. Uyumlulaştırılmış reklamlar için Bunun yerine loadAd().

ABD eyalet gizlilik yasaları ve GDPR

ABD eyalet gizliliği yasalar veya Genel Veri Koruma Yasal düzenlemelere tabi (GDPR) ABD eyalet yönetmeliklerindeki adımlar ayarlar veya GDPR ayarlarınızı Ad Manager'da uyumlulaştırma iş ortakları Gizlilik ve mesajlaşma'nın ABD eyaletleri veya GDPR reklam iş ortakları listesi. Aksi takdirde, iş ortaklarının uygulamanızda reklam yayınlayamıyorsanız.

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