Başlama

Bu kılavuzda, bir uyumlulaştırma bağdaştırıcısını Android uygulaması.

Ö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:

• Banner reklamlar
• Geçiş Reklamları
• Doğal reklamlar
• Ödüllü reklamlar
• Ödüllü Geçiş Reklamı Reklamlar

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ı başlatma

Hızlı başlangıç kılavuzu, Mobil Reklamları nasıl başlatacağınızı SDK. 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. İşlem tamamlanmadan önce başlatma işleminin tamamlanmasını beklemek Görüntülü Reklam Ağı'ndaki her reklam ağından tam katılımı sağlamak için reklamları ilk reklam isteğidir.

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.

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ı 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:

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

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 oluşturucusunda (örneğin, AdManagerAdView), Context. 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

Banner reklam için tüm üçüncü taraf reklam kaynağı kullanıcı arayüzlerinde yenilemeyi devre dışı bıraktığınızdan emin olun. uyumlulaştırmada kullanılan birimlerdir. Bu durum, 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ı kontrol edin. 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.