Konfigurowanie zapośredniczenia

Wybierz platformę: Android Nowy Android iOS Unity Flutter

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

Dopiero zaczynasz korzystać z zapośredniczenia? Przeczytaj wprowadzenie do zapośredniczenia.

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

Inicjowanie Google Mobile Ads SDK

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

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 dotyczącej 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.

Pamiętaj, aby wyłączyć odświeżanie we wszystkich interfejsach zewnętrznych źródeł reklam w przypadku jednostek banerów reklamowych używanych w zapośredniczeniu. Zapobiega 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. Podczas korzystania z zapośredniczenia pamiętaj, że Twoja aplikacja nadal musi 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 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ć swoich partnerów zapośredniczenia na liście 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