Ta strona została przetłumaczona przez Cloud Translation API.

Integracja ironSource z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z ironSource za pomocą zapośredniczenia oraz integracji kaskadowych. Dowiesz się z niego, jak dodać reklamy ironSource do konfiguracji zapośredniczenia jednostki reklamowej, jak ustawić optymalizację źródeł reklam oraz jak zintegrować pakiet SDK i adapter do reklam ironSource z aplikacją Android.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager do reklam ironSource zapewnia te funkcje:

Integracja
Ustalanie stawek	¹
Wodospad
Formaty
Baner	²
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą	²
Natywna

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie reklam ironSource

Zarejestruj się i zaloguj na konto ironSource Ads.

Aby dodać aplikację do panelu ironSource Ads, kliknij przycisk Nowa aplikacja.

Wpisz szczegóły aplikacji

Wybierz Aktywna aplikacja, wpisz Google Play URL swojej aplikacji i kliknij Importuj informacje o aplikacji.

Jeśli aplikacja nie jest dostępna, wybierz Aplikacja nie jest dostępna w sklepie z aplikacjami i podaj tymczasową nazwę aplikacji. Wybierz swoją platformę.

Wypełnij resztę formularza i kliknij Dodaj aplikację.

Zapisz nowy klucz aplikacji, który wyświetla się po dodaniu aplikacji. Będzie ona potrzebna do skonfigurowaniaAd Manager identyfikatora jednostki reklamowej. Wybierz formaty reklam obsługiwane przez Twoją aplikację. Następnie kliknij Dalej.

Utwórz instancję

Następnie skonfiguruj instancję sieci dla dodanej aplikacji.

Kliknij Reklamy > Konfiguracja > Instancje. Wybierz aplikację i kliknij Utwórz instancję.

Wpisz wymagane informacje, a potem kliknij Zapisz i zamknij.

Gdy instancja zostanie utworzona, będzie on wymieniony w polu Identyfikator instancji.

Znajdowanie klucza interfejsu API do raportowania

Oprócz klucza aplikacji i identyfikatora instancji potrzebujesz też tajnego klucza i tokena odświeżania ironSource Ads, aby skonfigurowaćAd Manager identyfikator jednostki reklamowej.

Otwórz Moje konto w panelu wydawcy ironSource Ads, a następnie kliknij kartę Interfejs API. Zapisz Tajny klucz i Token odświeżania.

Włącz tryb testowy

Wykonaj instrukcje podane w przewodniku ironSource Ads na temat testowania integracji, aby włączyć reklamy testowe w ironSource.

Krok 2. Skonfiguruj żądania reklam ironSource w Ad Manager interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w przypadku usługi IronSource , możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz IronSource , wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszSecret Key and Refresh Token uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszApp Key and Instance ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

Dodaj ironSource Mobile do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać ironSource Mobile do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK i adapter reklam ironSource

Integracja Android Studio (zalecana)

W pliku settings.gradle.kts na poziomie projektu dodaj te repozytoria:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

Następnie w pliku build.gradle.kts na poziomie aplikacji dodaj poniższe zależności i konfiguracje implementacji. Użyj najnowszych wersji pakietu SDK i adaptera ironSource Ads:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:ironsource:8.1.0.0")
}

Integracja ręczna

Pobierz najnowszą wersję ironSource Ads SDK na Androida i dodaj ją do swojego projektu.
Przejdź do artefaktów adaptera reklam ironSource w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik .aar adaptera IronSource i dodaj go do projektu.

Krok 4. Wdroż ustawienia prywatności w pakiecie SDK do reklam ironSource

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

W pakiecie SDK w wersji 6.7.9 usługa ironSource Ads dodała interfejs API do uzyskiwania zgody. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK ironSource. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w dokumentacji reklam ironSource na temat zaawansowanych ustawień dotyczących regulacji.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

W pakiecie SDK w wersji 6.14.0 firma ironSource Ads dodała interfejs API, aby obsługiwać przepisy CCPA. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK ironSource. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane do pakietu SDK ironSource.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w dokumentacji reklam ironSource na temat zaawansowanych ustawień regulacji.

Krok 5. Dodaj wymagany kod

Cykl życia aplikacji

Zastąp metody onPause() i onResume() w każdej aktywności, aby wywoływać odpowiednie metody reklam ironSource w ten sposób:

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

Reguły ProGuard

Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, reklamy ironSource wymagają dodatkowych reguł ProGuard w projekcie. Więcej informacji znajdziesz w przewodniku po integracji pakietu Android SDK w reklamach ironSource.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w IronSource interfejsie użytkownika.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witryny IronSource , włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z ironSource Ads(Waterfall) źródeł reklam.

Kody błędów

Jeśli adapter nie otrzyma reklamy z reklam ironSource, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, używając polecenia ResponseInfo.getAdapterResponses() w ramach tych klas:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter reklam ironSource, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
101	Brak parametrów serwera reklam ironSource skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102	Reklamy ironSource wymagają kontekstu aktywności do zainicjowania pakietu SDK.
103	Reklamy ironSource mogą wczytywać tylko 1 reklamę na identyfikator instancji reklam ironSource.
105	Żądany rozmiar banera reklamowego nie jest obsługiwany w reklamach ironSource.
106	Pakiet SDK do wyświetlania reklam ironSource nie został zainicjowany.
501-1056	Błędy pakietu SDK do reklam ironSource. Więcej informacji znajdziesz w dokumentacji.
101	Brakuje parametrów serwera reklam ironSource skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102	Adapter reklam ironSource nie obsługuje żądanego formatu reklamy.
103	Reklama ironSource jest już wczytana na potrzeby tej konfiguracji sieci.
104	Żądany rozmiar banera reklamowego nie jest obsługiwany w reklamach ironSource.
508-1037	Błędy pakietu SDK do reklam ironSource. Więcej informacji znajdziesz w dokumentacji.