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

Integracja ironSource z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z ironSource Ads przy użyciu mediacji, obejmującej integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu ironSource Ads do konfiguracji zapośredniczenia jednostki reklamowej, konfigurowaniu optymalizacji źródła reklam oraz integrowaniu pakietu SDK i adaptera ironSource Ads z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Managera dla ironSource Ads ma te możliwości:

Integracja
Określanie stawek	¹
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą	²
Natywna

¹ Integracja ustalania stawek jest w fazie zamkniętej wersji beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

² Ten format jest obsługiwany tylko w ramach integracji kaskadowej.

Wymagania

Android API na poziomie 23 lub wyższym

[W przypadku ustalania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w ramach ustalania stawek, użyj adaptera IronSource w wersji 8.5.0.1 lub nowszej (zalecana najnowsza wersja).

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj ustawienia w interfejsie ironSource Ads

Zarejestruj się i zaloguj na konto ironSource Ads.

Dodaj nową aplikację

Aby dodać nową aplikację, kliknij Reklamy > Aplikacje i kliknij Dodaj aplikację.

Wypełnij formularz i kliknij Dodaj aplikację.

Zanotuj klucz aplikacji, a potem wybierz formaty reklam obsługiwane przez aplikację i kliknij Dalej.

Utwórz instancję

Następnie skonfiguruj instancję sieci dla dodanej aplikacji.

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

Wypełnij formularz i kliknij Zapisz i zamknij.

Zanotuj identyfikator instancji.

Znajdowanie klucza interfejsu API raportowania

Na stronie Moje konto kliknij kartę Interfejs API i zapisz klucz tajny oraz token odświeżania.

Włączanie trybu testowego

Aby włączyć reklamy testowe ironSource Ads, postępuj zgodnie z instrukcjami w przewodniku Testowanie integracji firmy ironSource Ads.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy ironSource w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Wyświetlanie > Grupy zysku i Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji 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 reklam ironSource, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieci reklamowej wybierz ironSource Ads, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz tajny klucz oraz token odświeżania uzyskane w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platforma i Aktywny jako Stan. Wpisz klucz aplikacji i identyfikator instancji uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

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

Dodawanie ironSource Mobile do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać ironSource Mobile do listy partnerów reklamowych w Europejskich Rozporządzeniach i amerykańskich przepisach stanowych w interfejsie Ad Managera, wykonaj czynności opisane w ustawieniach europejskich rozporządzeń i amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter ironSource Ads

Integracja z 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 te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera ironSource Ads:

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

Integracja ręczna

Pobierz najnowszą wersję pakietu ironSource Ads SDK na Androida i dodaj go do projektu.
Otwórz elementy adaptera reklam ironSource Ads w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera IronSource i dodaj go do projektu.

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK ironSource Ads

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystaniu tych danych przez każdą sieć. Obecnie Google nie może automatycznie przekazywać sieciom takich informacji.

W wersji pakietu SDK 6.7.9 ironSource Ads dodano interfejs API do uzyskiwania zgody. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do pakietu SDK reklam ironSource. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

JavaKotlin

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

IronSource.setConsent(true);

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

IronSource.setConsent(true)

Więcej informacji i wartości, które można podać w ramach tej metody, znajdziesz w dokumentacji ironSource Ads na temat zaawansowanych ustawień związanych z regulacją.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

W wersji pakietu SDK 6.14.0 reklamy ironSource dodały interfejs API obsługujący przepisy ustawy CCPA. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do pakietu SDK reklam ironSource. Te opcje muszą być ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK do reklam ironSource.

JavaKotlin

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

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

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

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

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

Krok 5. Dodaj wymagany kod

Cykl życia aplikacji

W każdej z tych metod zastąpij metody onPause() i onResume(), aby wywołać odpowiednie metody ironSource Ads w ten sposób:

JavaKotlin

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

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

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

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

Reguły Proguard

Jeśli ściskasz, zaciemnisz i zoptymalizujesz aplikację, reklamy ironSource wymagają dodania do projektu dodatkowych reguł ProGuard. Więcej informacji znajdziesz w przewodniku ironSource Ads na temat integracji z pakietem SDK Androida.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w Ad Managerze i włączyć tryb testowy w interfejsie reklam ironSource.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z ironSource Ads, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam ironSource Ads (z ustalaniem stawek) i ironSource Ads (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z ironSource Ads, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i odpowiednie komunikaty z adaptera reklam ironSource, które są generowane, gdy nie udaje się wczytać reklamy:

Kod błędu	Przyczyna
101	Parametry serwera ironSource Ads skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Aby zainicjować SDK, ironSource Ads wymaga kontekstu aktywności.
103	ironSource Ads może wczytywać tylko 1 reklamę na identyfikator instancji ironSource Ads.
105	Żądaną wielkość banera reklamowego nie obsługuje ironSource Ads.
106	Pakiet SDK ironSource Ads nie został zainicjowany.
501-1056	Błędy pakietu SDK ironSource Ads. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją.

Historia zmian adaptera do mediacji IronSource na Androida