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

Z tego przewodnika dowiesz się, jak używać pakietu GMA Next-Gen SDK 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 do wyświetlania reklam 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 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 GMA Next-Gen SDK.
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 tego źródła reklam.

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 Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe 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 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 zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w artykułach Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z amerykańskimi przepisami stanowymi, 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 i konfiguracje implementacji:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:ironsource:9.7.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:ironsource:9.7.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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 przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do personalizacji 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.

Adapter ironSource Ads na Androida w wersji 7.7.0.0 i nowszych obsługuje przekazywanie sygnałów zgody na wykorzystanie danych zgodnie z RODO z pakietu SDK UMP i platform do zarządzania zgodą użytkowników, które są zintegrowane ze specyfikacją Google dotyczącą udzielenia dodatkowej zgody, do pakietu SDK do wyświetlania reklam ironSource Ads. Więcej informacji znajdziesz w artykule ironSource na temat zgodności z RODO.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „sprzedającego”. Przewodnik po 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. 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 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 inicjalizacją GMA Next-Gen SDK, aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK do wyświetlania reklam ironSource.

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 funkcji ResponseInfo.getAdSourceResponses() 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.