Rozpocznij

Z tego przewodnika dowiesz się, jak zintegrować adapter zapośredniczenia z aplikacją na Androida.

Wymagania wstępne

Aby zintegrować zapośredniczenie dla danego formatu reklamy, musisz to zrobić najpierw format reklamy do Twojej aplikacji:

• Banery reklamowe
• Reklamy pełnoekranowe
• Reklamy natywne
• Reklamy z nagrodą
• Reklamy pełnoekranowe z nagrodą

Dopiero zaczynasz korzystać z zapośredniczenia? Odczytano Wprowadzenie do zapośredniczenia.

W przypadku określania stawek: Pakiet SDK do reklam mobilnych Google w wersji 18.3.0 lub wyższą.

Inicjowanie pakietu SDK do reklam mobilnych

Z naszego krótkiego przewodnika dowiesz się, jak zainicjować reklamy mobilne SDK. Podczas tego wywołania inicjowania również adaptery zapośredniczenia zostanie zainicjowany. Ważne jest, aby poczekać na zakończenie inicjalizacji przed musisz wczytywać reklamy, aby zapewnić pełny udział wszystkich reklam ze wszystkich sieci pierwszego żądania reklamy.

Poniższy przykładowy kod pokazuje, jak można sprawdzić inicjalizację każdego adaptera stanu przed wysłaniem żądania reklamy.

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...
      }
    }
  }
}

Sprawdzanie, która klasa adaptera sieci reklamowej wczytała reklamę

Oto przykładowy kod, który rejestruje nazwę klasy sieci reklamowej w przypadku banera reklamowego:

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

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

Zapoznaj się z dokumentacją usługi ResponseInfo dotyczącą getMediationAdapterClassName() .

Inicjalizacja obiektu reklamy za pomocą instancji Activity

W konstruktorze nowego obiektu reklamy (np. AdManagerAdView) musisz podać obiekt typu Context. Wartość Context jest przekazywana do innych sieci reklamowych podczas korzystania z zapośredniczenia. Niektóre sieci reklamowe wymagają bardziej restrykcyjnego parametru Context tego typu Activity i wyświetlanie reklam bez wystąpienia Activity może nie być możliwe. Dlatego podczas inicjowania obiektów reklam zalecamy przekazanie instancji Activity, aby zapewnić spójność w przypadku zapośredniczonych sieci reklamowych.

Korzystanie z banerów reklamowych z zastosowaniem zapośredniczenia

Pamiętaj, aby wyłączyć odświeżanie we wszystkich interfejsach zewnętrznych źródeł reklam w przypadku banerów reklamowych używanych w zapośredniczeniu. Zapobiega to podwójnemu odświeżaniu, ponieważ Ad Manager również uruchamia odświeżanie na podstawie częstotliwości odświeżania jednostki reklamowej banera.

Korzystanie z reklam natywnych z zaposobem zapośredniczenia

Poniżej znajdziesz kilka sprawdzonych metod, które warto zastosować podczas wdrażania pośrednictwa w reklamach natywnych.

Zasady dotyczące prezentacji reklam natywnych

Każda sieć reklamowa ma własne zasady. Pamiętaj, że korzystając z zapośredniczenia, musisz przestrzegać zasad sieci zapośredniczącej, która dostarczyła reklamę.

Użyj loadAd() zamiast loadAds()

Metoda loadAds() powoduje wyświetlanie tylko reklam Google. W przypadku reklam zapośredniczonych użyj wartości loadAd().

Amerykańskie przepisy stanowe o ochronie prywatności i RODO

Jeżeli konieczne jest przestrzeganie zasad w Stanach Zjednoczonych stanowa prywatność użytkowników przepisy prawne lub ogólna ochrona danych Rozporządzenie (RODO), postępuj zgodnie z kroków w amerykańskich przepisach stanowych ustawienia lub RODO , aby dodać partnerzy zapośredniczenia w usłudze Ad Manager na stronie Prywatność i wyświetlanie wiadomości Lista partnerów reklamowych ze stanów w USA lub zgodnie z RODO. Jeśli tego nie zrobisz, możemy podjąć współpracę z partnerami wyświetlanie reklam w aplikacji.