Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z reklam ironSource, które używają zapośredniczenie, obejmujące kaskadę, integracje. Omawiamy sposób dodawania reklam ironSource do oraz jak zintegrować pakiet SDK i adapter reklam ironSource. do aplikacji. Unity
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager do reklam ironSource te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą |
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Unity projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ 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 skonfigurowaniaAd Manager 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.
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
Oprócz klucza aplikacji i identyfikatora instancji potrzebujesz też tajnego klucza i tokena odświeżania ironSource Ads, aby skonfigurowaćAd Manager 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 Ad Manager interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
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 Ad Manager UI.
Krok 3. Zaimportuj pakiet SDK i adapter reklam ironSource
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla ironSource
Reklamy z linku pobierania w
Historia zmian i wyodrębnij plik
GoogleMobileAdsIronSourceMediation.unitypackage
z pliku ZIP.
W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Niestandardowy zakres dat
Spakuj i znajdź plik GoogleMobileAdsIronSourceMediation.unitypackage
.
pobranego pliku. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś
Zakończ. Biblioteka programu do rozpoznawania usług Unity Play będzie działać w zależności
od zera i skopiować zadeklarowane zależności
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
Krok 4. Wdroż ustawienia prywatności w pakiecie SDK do reklam ironSource
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource
wersja 1.0.0
obejmuje
IronSource.SetConsent()
. Poniższy przykładowy kod pokazuje, jak to zrobić
informacji o zgodzie użytkowników na przesyłanie
pakietu SDK do wyświetlania reklam ironSource. Jeśli wybierzesz nazwę
zaleca się zrobić to przed wysłaniem żądania reklam za pomocą
pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Zobacz dokumentację reklam ironSource na Zaawansowane ustawienia dotyczące regulacji .
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource
wersja 2.2.4
obejmuje
IronSource.SetMetaData()
. Poniższy przykładowy kod pokazuje, jak to zrobić
informacji o zgodzie użytkowników na przesyłanie
pakietu SDK do wyświetlania reklam ironSource. Te opcje należy ustawić przed
można zainicjować reklamy mobilne Google
pakiet SDK
aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK ironSource.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Zapoznaj się z dokumentacją reklam ironSource na temat zaawansowanych ustawień regulacji dotyczących obu tych formatów Androida, oraz iOS .
Krok 5. Dodaj wymagany kod
Android
Reguły ProGuard
Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, Reklamy IronSource wymagają dodatkowych reguł ProGuard w projekcie.
Podczas tworzenia projektu jako platformę wybierz Android. Następnie:
otwórz Ustawienia odtwarzacza i zaznacz Plik User Proguard w
Ustawienia publikacji. Unity powinna pokazywać, gdzie niestandardowy
Utworzono proguard-user.txt
plik do modyfikacji.
Skonsultuj się
Przewodnik po integracji pakietu SDK na Androida w reklamach IronSource
aby dowiedzieć się więcej o regułach ProGuard wymaganych w projekcie,
i dodaj je do pliku proguard-user.txt
.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją dotyczącą reklam ironSource, aby dodać identyfikatory SKAdNetwork do
Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager 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 odbierze reklamy z reklam ironSource, wydawcy mogą sprawdzić
przyczyną błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w
następujące klasy:
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 reklamy ironSource adaptera, gdy reklama nie wczytuje się:
Android
Kod błędu | Przyczyna |
---|---|
101 | Brak parametrów serwera reklam ironSource skonfigurowanych w Ad Manager 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. Zobacz dokumentację . |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brak parametrów serwera reklam ironSource skonfigurowanych w Ad Manager 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. Zobacz dokumentację . |
Historia zmian wtyczki IronSource Unity Mediation
Wersja 3.2.1
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter IronSource na Androida w wersji 8.2.1.0.
- Obsługuje adapter IronSource na iOS w wersji 8.2.0.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.
Wersja 3.2.0
- Obsługuje adapter IronSource na Androida w wersji 8.2.0.0.
- Obsługuje adapter IronSource na iOS w wersji 8.2.0.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
Wersja 3.1.1
- Obsługuje adapter IronSource na Androida w wersji 8.1.0.0.
- Obsługuje adapter IronSource na iOS w wersji 8.1.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
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.