Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z reklam ironSource za pomocą zapośredniczenia obejmującego integracje kaskadowe. Dowiesz się z niego, jak dodać reklamy ironSource do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter reklam ironSource z aplikacją Unity .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do reklam ironSource zapewnia te funkcje:
Integracja | ||
---|---|---|
Ustalanie stawek | 1 | |
Wodospad | ||
Formaty | ||
Baner | 2 | |
Pełnoekranowa | ||
Otrzymano | ||
Pełnoekranowa z nagrodą | 2 |
1 Integracja określania stawek jest w fazie zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się ze swoim menedżerem konta.
2 Ten format jest obsługiwany tylko w przypadku integracji kaskadowej.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
- 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 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 skonfigurowaniaAdMob identyfikatora jednostki reklamowej. Wybierz formaty reklam obsługiwane przez Twoją aplikację. Następnie kliknij Dalej.
Android
iOS
Utwórz instancję
Następnie skonfiguruj instancję sieci dla dodanej aplikacji.
Ustalanie stawek
Kliknij LevelPlay > Konfiguracja > Sieci SDK, a następnie wybierz swoją aplikację. W sekcji Określanie stawek kliknij ikonę edycji, aby wyświetlić identyfikator instancji określania stawek.
Android
iOS
Zanotuj identyfikator instancji.
Android
iOS
Wodospad
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
Ustalanie stawek
W przypadku integracji określania stawek ten krok nie jest wymagany.
Wodospad
Oprócz klucza aplikacji i identyfikatora instancji potrzebujesz też tajnego klucza i tokena odświeżania ironSource Ads, aby skonfigurowaćAdMob 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 AdMob interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
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 AdMob UI.
Krok 3. Zaimportuj pakiet SDK i adapter reklam ironSource
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla reklam ironSource, korzystając z linku pobierania w dzienniku zmian i wyodrębniając GoogleMobileAdsIronSourceMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsIronSourceMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
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.
Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource
wersja 1.0.0
zawiera metodę
IronSource.SetConsent()
. Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK ironSource. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy wykonanie jej przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Więcej informacji 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.
Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource
w wersji 2.2.4
zawiera metodę
IronSource.SetMetaData()
. Ten przykładowy kod pokazuje, jak przekazywać 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.
using GoogleMobileAds.Api.Mediation.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 zarówno na Androida, jak i iOS.
Krok 5. Dodaj wymagany kod
Android
Reguły ProGuard
Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, reklamy IronSource wymagają dodatkowych reguł ProGuard w Twoim projekcie.
Podczas tworzenia projektu jako Platformę wybierz Android. Następnie otwórz Ustawienia odtwarzacza i zaznacz Plik User Proguard na karcie Ustawienia publikacji. Unity powinna pokazywać, gdzie został utworzony niestandardowy plik proguard-user.txt
, który możesz zmodyfikować.
Zapoznaj się z przewodnikiem po integracji pakietu Android SDK w reklamach IronSource, aby dowiedzieć się więcej o regułach ProGuard wymaganych w Twoim projekcie i dodaj te reguły do pliku proguard-user.txt
.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją reklam ironSource, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob 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 (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z reklam ironSource, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na reklamę, używając polecenia ResponseInfo
w następujących klasach:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter reklam ironSource, gdy nie uda się wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera reklam ironSource skonfigurowanych w AdMob 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 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. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera reklam ironSource skonfigurowanych w AdMob 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. |
Historia zmian wtyczki IronSource Unity Mediation
Wersja 3.1.0
- Obsługuje adapter IronSource na Androida w wersji 8.1.0.0.
- Obsługuje adapter IronSource na iOS w wersji 8.1.0.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.0.1
- Obsługuje adapter IronSource na Androida w wersji 8.0.0.1.
- Obsługuje adapter IronSource na iOS w wersji 8.0.0.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.0.0
- Obsługuje adapter IronSource na Androida w wersji 8.0.0.0.
- Obsługuje adapter IronSource na iOS w wersji 8.0.0.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 2.6.1
- Obsługuje adapter IronSource na Androida w wersji 7.9.0.0.
- Obsługuje adapter IronSource na iOS w wersji 7.9.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 2.6.0
- Obsługuje adapter IronSource na Androida w wersji 7.9.0.0.
- Obsługuje adapter IronSource na iOS w wersji 7.9.0.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 2.5.0
- Obsługuje adapter IronSource na Androida w wersji 7.6.0.0.
- Obsługuje adapter IronSource na iOS w wersji 7.6.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 2.4.0
- Obsługuje adapter IronSource na Androida w wersji 7.5.2.0.
- Obsługuje adapter IronSource na iOS w wersji 7.5.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 2.3.1
- Obsługuje adapter IronSource na Androida w wersji 7.3.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.3.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.3.0.
Wersja 2.3.0
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/IronSource/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.IronSource
. - Obsługuje adapter IronSource na Androida w wersji 7.3.0.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.3.0.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 2.2.7
- Obsługuje adapter IronSource na Androida w wersji 7.2.7.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.7.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 2.2.6
- Obsługuje adapter IronSource na Androida w wersji 7.2.6.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.6.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 2.2.5
- Obsługuje adapter IronSource na Androida w wersji 7.2.5.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.5.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 2.2.4
- Dodano metodę
IronSource.SetMetaData(string, string)
. - Obsługuje adapter IronSource na Androida w wersji 7.2.3.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 2.2.3
- Obsługuje adapter IronSource na Androida w wersji 7.2.3.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.3.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.1.0.
Wersja 2.2.2
- Obsługuje adapter IronSource na Androida w wersji 7.2.2.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.2.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 2.2.1
- Obsługuje adapter IronSource na Androida w wersji 7.2.1.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.1.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.2.0
- Obsługuje adapter IronSource na Androida w wersji 7.2.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.2.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.1.5
- Obsługuje adapter IronSource na Androida w wersji 7.1.14.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.14.0.
Wersja 2.1.4
- Obsługuje adapter IronSource na Androida w wersji 7.1.13.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.13.0.
Wersja 2.1.3
- Obsługuje adapter IronSource na Androida w wersji 7.1.12.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.12.0.
Wersja 2.1.2
- Obsługuje adapter IronSource na Androida w wersji 7.1.11.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.11.1.0.
Wersja 2.1.1
- Obsługuje adapter IronSource na Androida w wersji 7.1.8.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.8.0.
Wersja 2.1.0
- Obsługuje adapter IronSource na Androida w wersji 7.1.6.0.
- Obsługuje adapter IronSource na iOS w wersji 7.1.6.1.0.
Wersja 2.0.3
- Obsługuje adapter IronSource na Androida w wersji 7.0.3.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.0.3.0.
Wersja 2.0.2
- Obsługuje adapter IronSource na Androida w wersji 7.0.2.0.
- Obsługuje adapter IronSource na iOS w wersji 7.0.2.0.
Wersja 2.0.1
- Obsługuje adapter IronSource na Androida w wersji 7.0.1.1.0.
- Obsługuje adapter IronSource na iOS w wersji 7.0.1.0.
Wersja 2.0.0
- Obsługuje adapter IronSource na Androida w wersji 7.0.0.0.
- Obsługuje adapter IronSource na iOS w wersji 7.0.0.0.
Wersja 1.10.0
- Obsługuje adapter IronSource na Androida w wersji 6.18.0.0.
- Obsługuje adapter IronSource na iOS w wersji 6.18.0.0.
Wersja 1.9.1
- Obsługuje adapter IronSource na Androida w wersji 6.17.0.1.
- Obsługuje adapter IronSource na iOS w wersji 6.17.0.1.0.
Wersja 1.9.0
- Obsługuje adapter IronSource na Androida w wersji 6.17.0.0.
- Obsługuje adapter IronSource na iOS w wersji 6.16.3.0.
Wersja 1.8.2
- Obsługuje adapter IronSource na Androida w wersji 6.16.2.0.
- Obsługuje adapter IronSource na iOS w wersji 6.16.2.0.
Wersja 1.8.1
- Obsługuje adapter IronSource na Androida w wersji 6.16.1.0.
- Obsługuje adapter IronSource na iOS w wersji 6.16.1.0.
Wersja 1.8.0
- Obsługuje adapter IronSource na Androida w wersji 6.16.0.0.
- Obsługuje adapter IronSource na iOS w wersji 6.16.0.0.
Wersja 1.7.0
- Obsługuje adapter IronSource na Androida w wersji 6.15.0.1.0.
- Obsługuje adapter IronSource na iOS w wersji 6.15.0.1.0.
Wersja 1.6.0
- Obsługuje adapter IronSource na Androida w wersji 6.14.0.1.0.
- Obsługuje adapter IronSource na iOS w wersji 6.14.0.0.
Wersja 1.5.0
- Obsługuje adapter IronSource na Androida w wersji 6.13.0.1.0.
- Obsługuje adapter IronSource na iOS w wersji 6.13.1.0.0.
Wersja 1.4.0
- Obsługuje adapter IronSource na Androida w wersji 6.12.0.0.
- Obsługuje adapter IronSource na iOS w wersji 6.12.0.0.
Wersja 1.3.2
- Obsługuje adapter IronSource na Androida w wersji 6.10.0.0.
- Obsługuje adapter IronSource na iOS w wersji 6.8.7.0.
Wersja 1.3.1
- Obsługuje adapter IronSource na Androida w wersji 6.10.0.0
- Obsługuje adapter IronSource na iOS w wersji 6.8.6.0
Wersja 1.3.0
- Obsługuje adapter IronSource na Androida w wersji 6.10.0.0
- Obsługuje adapter IronSource na iOS w wersji 6.8.4.1.0
Wersja 1.2.0
- Obsługuje adapter IronSource na Androida w wersji 6.9.0.1
- Obsługuje adapter IronSource na iOS w wersji 6.8.4.1.0
Wersja 1.1.2
- Obsługuje adapter IronSource na Androida w wersji 6.8.4.1
- Obsługuje adapter IronSource na iOS w wersji 6.8.4.1
Wersja 1.1.1
- Obsługuje adapter IronSource na Androida w wersji 6.8.4.1
- Obsługuje adapter IronSource na iOS w wersji 6.8.3.0
Wersja 1.1.0
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji beta.
- Obsługuje adapter IronSource na Androida w wersji 6.8.1.2
- Obsługuje adapter IronSource na iOS w wersji 6.8.0.1
Wersja 1.0.4
- Obsługuje adapter IronSource na Androida w wersji 6.7.11.0
- Obsługuje adapter IronSource na iOS w wersji 6.7.11.0
Wersja 1.0.3
- Obsługuje adapter IronSource na Androida w wersji 6.7.10.0
- Obsługuje adapter IronSource na iOS w wersji 6.7.10.0
Wersja 1.0.2
- Obsługuje adapter IronSource na Androida w wersji 6.7.9.1.1
- Obsługuje adapter IronSource na iOS w wersji 6.7.10.0
- Wyeliminowaliśmy konflikt z wtyczką zapośredniczenia Chartboost Unity.
Wersja 1.0.1
- Obsługuje adapter IronSource na Androida w wersji 6.7.9.0.
- Obsługuje adapter IronSource na iOS w wersji 6.7.9.2.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter IronSource na Androida w wersji 6.7.9.0.
- Obsługuje adapter IronSource na iOS w wersji 6.7.9.1.0.