Konfigurowanie zapośredniczenia

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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

Wymagania wstępne

Zanim zintegrujesz zapośredniczenie w przypadku formatu reklamy, musisz zintegrować ten format reklamy z aplikacją:

Zaczynasz korzystać z zapośredniczenia? Przeczytaj wprowadzenie do zapośredniczenia.

W przypadku określania stawek: Google Mobile Ads SDK (Legacy) 18.3.0 lub nowszej.

Inicjowanie Google Mobile Ads SDK (Legacy)

Z tego krótkiego przewodnika dowiesz się, jak zainicjować Google Mobile Ads SDK (Legacy). Podczas tego wywołania inicjowania inicjowane są też adaptery zapośredniczenia. Aby sprawdzić pełny udział każdej sieci reklamowej w pierwszym żądaniu reklamy, przed wczytaniem reklam musisz poczekać na zakończenie inicjowania.

Poniższy przykładowy kod pokazuje, jak sprawdzić stan inicjowania każdego adaptera przed wysłaniem żądania reklamy.

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",
    )
  }
}

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

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

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)

Więcej informacji o tej metodzie znajdziesz w dokumentacji ResponseInfo na stronie getMediationAdapterClassName().

Inicjowanie obiektu reklamy za pomocą instancji Activity.

W konstruktorze nowego obiektu reklamy (np. AdManagerAdView) musisz przekazać obiekt typu Context. Ten Context jest przekazywany do innych sieci reklamowych podczas korzystania z zapośredniczenia. Niektóre sieci reklamowe wymagają bardziej restrykcyjnego typu Context, czyli Activity i mogą nie wyświetlać reklam bez instancji Activity. Dlatego podczas inicjowania obiektów reklam zalecamy przekazywanie instancji Activity, aby zapewnić spójne działanie zapośredniczonych sieci reklamowych.

W przypadku jednostek banerów reklamowych używanych w zapośredniczeniu wyłącz odświeżanie we wszystkich interfejsach źródeł reklam zewnętrznych. Zapobiegnie to podwójnemu odświeżaniu, ponieważ Ad Manager też wywołuje odświeżanie na podstawie częstotliwości odświeżania jednostki baneru reklamowego.

Korzystanie z reklam natywnych z zapośredniczeniem

Oto kilka sprawdzonych metod, które warto wziąć pod uwagę podczas wdrażania zapośredniczenia reklam natywnych.

Zasady dotyczące prezentowania reklam natywnych
Każda sieć reklamowa ma własne zasady. Pamiętaj, że podczas korzystania z zapośredniczenia Twoja aplikacja musi nadal przestrzegać zasad sieci zapośredniczonej, która wyświetliła reklamę.
Używaj loadAd() zamiast loadAds()
Metoda loadAds() wyświetla tylko reklamy Google. W przypadku reklam zapośredniczonych używaj zamiast niej metody loadAd().

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

Jeśli musisz przestrzegać amerykańskich przepisów stanowych o ochronie prywatności lub Ogólnego rozporządzenia o ochronie danych (RODO), wykonaj czynności opisane w sekcji Ustawienia dotyczące przepisów stanowych USA lub Ustawienia RODO, aby dodać partnerów zapośredniczenia do listy partnerów reklamowych w USA lub RODO w narzędziu Prywatność i wyświetlanie wiadomości w Ad Managerze. Jeśli tego nie zrobisz, partnerzy mogą nie wyświetlać reklam w Twojej aplikacji.

Dowiedz się więcej o włączaniu ograniczonego przetwarzania danych (RDP) i uzyskiwaniu zgody na wykorzystanie danych zgodnie z RODO za pomocą pakietu SDK User Messaging Platform (UMP) od Google.

Dalej
Wybieranie źródeł reklam