Z tego przewodnika dowiesz się, jak zintegrować adapter zapośredniczenia ze swoim Aplikacja na Androida.
Wymagania wstępne
Zanim zintegrujesz mediację z danym formatem reklamy, musisz go zintegrować z aplikacją:
- Banery reklamowe
- Reklamy pełnoekranowe
- Reklamy natywne
- Reklamy z nagrodą
- Reklama pełnoekranowa z nagrodą Reklamy
Zapoznałeś się już z zaproszeniem? Odczytano Wprowadzenie do zapośredniczenia.
W przypadku ustalania stawek: Pakiet SDK do reklam mobilnych Google w wersji 18.3.0 lub wyższą.
Zainicjowanie pakietu SDK do reklam mobilnych
Z naszego krótkiego przewodnika dowiesz się, jak zainicjować reklamy mobilne SDK. W trakcie 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 przed wysłaniem żądania reklamy.
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...
}
}
}
}
Sprawdź, która klasa adaptera sieci reklamowej załadowała reklamę
Oto przykładowy kod, który rejestruje nazwę klasy sieci reklamowej w przypadku banera reklamowego:
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)
}
Zapoznaj się z dokumentacją usługi ResponseInfo
dotyczącą: getMediationAdapterClassName()
.
Inicjowanie obiektu reklamy za pomocą wystąpienia aktywności
W konstruktorze nowego obiektu reklamy (np.
AdManagerAdView
)
musisz podać obiekt typu
Context
.
Podczas korzystania z zapośredniczenia ta wartość Context
jest przekazywana do innych sieci reklamowych. 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
zalecamy przekazanie wystąpienia Activity
podczas inicjowania obiektów reklamowych
aby zapewnić spójne korzystanie z zapośredniczonych sieci reklamowych.
Używanie banerów reklamowych w zapośredniczeniu
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ójne odświeżenie, ponieważ Ad Manager też uruchamia odświeżenie na podstawie częstotliwości odświeżania jednostki z banerem reklamowym.
Używanie reklam natywnych z zapośredniczeniem
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()
zamiastloadAds()
- Metoda
loadAds()
powoduje wyświetlanie tylko reklam Google. W przypadku reklam zapośredniczonych użyj wartościloadAd()
.
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 prawa lub Ogólna ochrona danych Rozporządzenie (RODO), postępuj zgodnie z kroki 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 zgodnych z RODO. Jeśli tego nie zrobisz, możemy podjąć współpracę z partnerami niewyświetlanie reklam w Twojej aplikacji.
Dowiedz się więcej o włączaniu ograniczonego przetwarzania danych (RDP) i uzyskanie RODO zgoda na wykorzystanie danych za pomocą platformy do personalizowania wiadomości wyświetlanych użytkownikom (UMP) SDK.