Pakiet SDK do reklam mobilnych Google jest w trybie konserwacji. Aby korzystać z najnowszych aktualizacji i funkcji, migrate na pakiet SDK nowej generacji do reklam mobilnych Google i go skonfiguruj.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja ironSource z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z ironSource Ads za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się z niego, jak dodać ironSource Ads do konfiguracji zapośredniczenia jednostki reklamowej, jak skonfigurować optymalizację źródła reklam oraz jak zintegrować pakiet SDK i adapter ironSource Ads z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia ironSource Ads ma te funkcje:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą	¹
Rodzimy użytkownik

¹ Ten format jest obsługiwany tylko w integracji kaskadowej.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Android z interfejsem API na poziomie 24 lub wyższym.

[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w ramach określania stawek, użyj adaptera IronSource w wersji 8.5.0.1 lub nowszej (zalecamy najnowszą wersję).

Najnowsza wersja Google Mobile Ads SDK (Legacy).
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie ironSource Ads

Zarejestruj się i zaloguj się na konto ironSource Ads.

Dodaj nową aplikację

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

Wypełnij formularz i kliknij Dodaj aplikację.

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

Utwórz instancję

Następnie skonfiguruj instancję dodanej aplikacji.

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

Określanie stawek

Wypełnij formularz i w sekcji Ceny wybierz Określanie stawek. Kliknij Zapisz i zamknij.

Zanotuj identyfikator instancji.

Kaskada

Wypełnij formularz i kliknij Zapisz i zamknij.

Zanotuj identyfikator instancji.

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

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

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

Aby wdrożyć plik app-ads.txt dla ironSource, zapoznaj się z informacjami o autoryzowanych sprzedawcach ironSource.

Włączanie trybu testowego

Aby dowiedzieć się, jak włączyć reklamy testowe ironSource Ads, postępuj zgodnie z instrukcjami podanymi w przewodniku po testowaniu integracji tej sieci.

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

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

Wpisz unikalną nazwę grupy zysku, ustaw stan na aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na aplikację mobilną. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i aplikację mobilną, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dla ironSource Ads, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako sieć reklamową wybierz ironSource Ads, wpisz unikalną nazwę i włącz zapośredniczenie.

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

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, Android jako Platformę 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 amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA, aby dodać ironSource Mobile do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK do wyświetlania reklam 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/")
    }
  }
}

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji:

Kotlin

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

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:ironsource:9.6.1.0'
}

Integracja ręczna

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

Krok 4. Skonfiguruj ustawienia prywatności w pakiecie SDK do wyświetlania reklam ironSource

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Od wersji 7.7.0 pakietu SDK ironSource automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielenia dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Obsługa platformy Google UMP i platform CMP, które obsługują tryb udzielenia dodatkowej zgody Google.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych 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. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

W pakiecie SDK w wersji 6.14.0 firma ironSource Ads dodała interfejs API, aby zapewnić zgodność z przepisami ustawy CCPA. Poniższy przykładowy kod pokazuje, jak przekazać te informacje o zgodzie do pakietu SDK do wyświetlania reklam ironSource Ads. Te opcje należy ustawić przed zainicjowaniem Google Mobile Ads SDK (Legacy), aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK ironSource Ads.

Java

LevelPlay.setMetaData("do_not_sell", "true");IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")IronSourceMediationSnippets.kt

Więcej informacji i wartości, które można podać w metodzie, znajdziesz w dokumentacji ironSource Ads dotyczącej ustawień zaawansowanych związanych z przepisami.

Krok 5. Dodaj wymagany kod

Wczytywanie reklamy z kontekstem aktywności

Przekazuj kontekst Activity podczas wczytywania banerów, reklam pełnoekranowych i reklam z nagrodą. Bez kontekstu aktywności wczytywanie reklamy się nie powiedzie.

Reguły ProGuard

Jeśli zmniejszasz, zaciemniasz i optymalizujesz aplikację, ironSource Ads wymaga dodatkowych reguł ProGuard w projekcie. Więcej informacji znajdziesz w przewodniku po integracji pakietu SDK ironSource Ads na Androida.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w usłudze Ad Manager i włączyć tryb testowy w interfejsie ironSource Ads.

Sprawdzanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z ironSource Ads, możesz sprawdzić błąd w odpowiedzi na reklamę, korzystając z metody ResponseInfo.getAdapterResponses() w tych klasach:

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

Oto kody i powiązane z nimi komunikaty, które adapter ironSource Ads wyświetla, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
101	Parametry serwera ironSource Ads skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	ironSource Ads wymaga kontekstu aktywności do zainicjowania pakietu SDK.
103	ironSource Ads może wczytać tylko 1 reklamę na identyfikator instancji ironSource Ads.
105	Żądany rozmiar banera reklamowego nie jest obsługiwany przez ironSource Ads.
106	Pakiet SDK ironSource Ads nie został zainicjowany.
107	Żądanie wyświetlenia reklamy zostało wysłane, zanim reklama została wczytana.
108	Pakiet SDK do wyświetlania reklam ironSource zwrócił puste sygnały ustalania stawek.
501-1056	Błędy pakietu SDK do wyświetlania reklam ironSource. Więcej informacji znajdziesz w dokumentacji.

Historia zmian adaptera zapośredniczenia IronSource na Androida