Integracja ironSource z zapośredniczeniem

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

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ć.

Plik Unity User Proguard

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

Wersja 2.4.0

Wersja 2.3.1

Wersja 2.3.0

Wersja 2.2.7

Wersja 2.2.6

Wersja 2.2.5

Wersja 2.2.4

Wersja 2.2.3

Wersja 2.2.2

Wersja 2.2.1

Wersja 2.2.0

Wersja 2.1.5

Wersja 2.1.4

Wersja 2.1.3

Wersja 2.1.2

Wersja 2.1.1

Wersja 2.1.0

Wersja 2.0.3

Wersja 2.0.2

Wersja 2.0.1

Wersja 2.0.0

Wersja 1.10.0

Wersja 1.9.1

Wersja 1.9.0

Wersja 1.8.2

Wersja 1.8.1

Wersja 1.8.0

Wersja 1.7.0

Wersja 1.6.0

Wersja 1.5.0

Wersja 1.4.0

Wersja 1.3.2

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.