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 w zakresie integracji kaskady. Opisano w nim, jak dodać ironSource do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet ironSource SDK i adapter z aplikacją na Unity.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla ironSource ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Pełnoekranowa z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 19 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Skorzystaj z zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj konfiguracje w interfejsie ironSource
Zarejestruj się i zaloguj na konto ironSource.
Aby dodać aplikację do panelu ironSource, 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. IronSource obsługuje wiele instancji sieci na potrzeby reklam z nagrodą i reklam pełnoekranowych.
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.
Oprócz KLUCZ APLIKACJI i Identyfikatora instancji potrzebujesz też tajnego klucza i tokena odświeżania ironSource, aby skonfigurowaćAdMob identyfikator jednostki reklamowej.
Wejdź na Moje konto w panelu wydawcy ironSource i kliknij kartę Interfejs API. Zapisz Tajny klucz i Token odświeżania.
Włącz tryb testowy
Aby włączyć reklamy testowe ironSource, postępuj zgodnie z instrukcjami w przewodniku ironSource na temat testowania integracji.
Krok 2. Skonfiguruj źródła ofert reklamowych 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 ironSource SDK i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia dla reklam mobilnych Google dla ironSource, korzystając z linku do pobierania w Dzienniku zmian, i wyodrębnij GoogleMobileAdsIronSourceMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Assets > Import Package > Custom package (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 zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji Unity.
Krok 4. Zaimplementuj ustawienia prywatności w pakiecie ironSource SDK
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) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Wtyczka zapośredniczenia reklam mobilnych Google dla ironSource w wersji 1.0.0 zawiera metodę IronSource.SetConsent()
. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu ironSource SDK. Jeśli chcesz wywoływać tę metodę, warto zrobić to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Więcej informacji znajdziesz w dokumentacji 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ą przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla ironSource w wersji 2.2.4 zawiera metodę IronSource.SetMetaData()
. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu ironSource SDK. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby upewnić się, że zostaną prawidłowo przekazane do pakietu ironSource SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Więcej informacji oraz wartości, które mogą być podane w tej metodzie, znajdziesz w dokumentacji ironSource na potrzeby zaawansowanych ustawień regulacji dotyczących Androida i iOS.
Krok 5. Dodaj wymagany kod
Android
Reguły ProGuard
Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, IronSource będzie wymagać w projekcie dodatkowych reguł ProGuard.
Podczas tworzenia projektu jako platformę wybierz Androida. Następnie otwórz Ustawienia odtwarzacza i zaznacz Plik ochrony użytkownika na karcie Ustawienia publikowania. W Unity powinna się wyświetlić informacja, gdzie został utworzony niestandardowy plik proguard-user.txt
, który można zmodyfikować.
Zapoznaj się z przewodnikiem IronSource na temat integracji pakietu SDK na Androida, by dowiedzieć się więcej o tym, jakie reguły ProGuard są wymagane w Twoim projekcie, i dodaj je do pliku proguard-user.txt
.
iOS
Integracja SKAdNetwork
Wykonaj dokumentację 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 witrynyironSource, 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 ironSource, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi reklamy, używając ResponseInfo
w tych 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 ironSource, gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera ironSource skonfigurowane w AdMob interfejsie użytkownika lub są one nieprawidłowe. |
102 | Aby zainicjować pakiet SDK, ironSource wymaga kontekstu aktywności. |
103 | ironSource może wczytać tylko jedną reklamę na identyfikator instancji ironSource. |
105 | Żądany rozmiar banera reklamowego nie jest obsługiwany przez ironSource. |
106 | Pakiet SDK ironSource nie został zainicjowany. |
501-1056 | Błędy pakietu ironSource w pakiecie SDK. Więcej informacji znajdziesz w dokumentacji. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera ironSource skonfigurowane w AdMob interfejsie użytkownika lub są one nieprawidłowe. |
102 | Adapter ironSource nie obsługuje żądanego formatu reklamy. |
103 | Reklama ironSource jest już wczytana dla tej konfiguracji sieci. |
104 | Żądany rozmiar banera reklamowego nie jest obsługiwany przez ironSource. |
508-1037 | Błędy pakietu ironSource w pakiecie SDK. Więcej informacji znajdziesz w dokumentacji. |
Historia zmian wtyczki Unity Mediation IronSource
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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.3.0.
Wersja 2.3.0
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/IronSource/
. - Zrefaktoryzowano przestrzeń nazw adaptera 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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.
- Stworzona i przetestowana z wtyczką 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
- Naprawiono 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.