Integracja reklam ironSource z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z ironSource Ads za pomocą mediacji, obejmującej integracje kaskadowe. Znajdziesz w nim informacje o tym, jak dodać ironSource Ads do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter ironSource Ads z aplikacją Unity .

Obsługiwane integracje i formaty reklam

AdMob Adapter zapośredniczenia dla ironSource Ads ma te możliwości:

Integracja
Określanie stawek  1
Wodospad
Formaty
Baner  2
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą  2

1 Integracja ustalania stawek jest w zamkniętej fazie testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

2 Ten format jest obsługiwany tylko w przypadku integracji kaskadowej.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Unity 4 lub nowsza
  • Aby wdrożyć na Androidzie:
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza
  • działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj ustawienia w interfejsie ironSource Ads

Zarejestruj się i zaloguj na konto ironSource Ads.

Aby dodać aplikację do panelu reklam ironSource, kliknij przycisk Nowa aplikacja.

Wpisz szczegóły aplikacji

Wybierz Aktywna aplikacja, wpisz jej nazwę i kliknij Importuj informacje o aplikacji.

Jeśli aplikacja jest niedostępna, wybierz Aplikacja niedostępna w sklepie z aplikacjami i podaj tymczasową nazwę aplikacji. Wybierz platformę.

Wypełnij resztę formularza i kliknij Dodaj aplikację.

Zanotuj nowy klucz aplikacji, który wyświetla się po dodaniu aplikacji. Potrzebujesz tej wartości do skonfigurowania identyfikatora jednostki reklamowej AdMob. 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.

Określanie stawek

Kliknij LevelPlay > Konfiguracja > Sieci pakietów 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 niezbędne informacje i kliknij Zapisz i zamknij.

Po utworzeniu instancji identyfikator instancji jest widoczny w polu Identyfikator instancji.

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Wodospad

Aby skonfigurować identyfikator jednostki reklamowej AdMob, oprócz klucza aplikacji i identyfikatora instancji będziesz też potrzebować tajnego klucza reklam z IronSource i tokena odświeżania.

W panelu wydawcy reklam ironSource otwórz Moje konto i kliknij kartę API. Zapisz tajny klucz i odświeżający token dostępu.

Włączanie trybu testowego

Aby włączyć reklamy testowe reklam ironSource, wykonaj instrukcje podane w przewodniku testowania integracji w reklamach ironSource.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy 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.

Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w ustawieniach dotyczących RODO i ustawień dotyczących przepisów stanowych w USA, aby dodać ironSource Mobile do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter ironSource Ads

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę IronSource Mediation do reklam mobilnych Google, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie Rejestry ograniczone dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakres: com.google

Szczegóły UPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads – pośrednictwo IronSource i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośrednictwa reklamowego w przypadku IronSource z linku do pobrania w Changelogu i rozpakuj plik 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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK ironSource Ads

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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka do zapośredniczenia reklam mobilnych Google dla reklam ironSourcew wersji 1.0.0obsługuje metodęIronSource.SetConsent(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do interfejsu programowania reklam ironSource Ads SDK. 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);

Aby dowiedzieć się więcej, zapoznaj się z dokumentacją ironSource Ads dotyczącą zaawansowanych ustawień regulacji.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Wtyczka zapośredniczenia reklam mobilnych Google dla ironSource Adsw wersji 2.2.4obsługuje metodę IronSource.SetMetaData() Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do interfejsu programowania reklam ironSource Ads SDK. Te opcje muszą być ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK do reklam ironSource.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

Więcej informacji i szczegółowe informacje o wartościach, które można podać w ramach tej metody, znajdziesz w dokumentacji ironSource Ads na temat zaawansowanych ustawień dotyczących regulacji dotyczących Androida i iOS.

Krok 5. Dodaj wymagany kod

Android

Reguły Proguard

Jeśli ściskasz, zaciemnisz i zoptymalizujesz aplikację, IronSource Ads będzie wymagać dla projektu dodatkowych reguł ProGuard.

Podczas tworzenia projektu jako platformę wybierz Android. Następnie otwórz Ustawienia odtwarzacza i na karcie Ustawienia publikacji zaznacz pole Plik User Proguard. Unity powinien wyświetlić, gdzie został utworzony niestandardowy plik proguard-user.txt, który możesz zmodyfikować.

Plik Unity Proguard

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 z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją ironSource Ads.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie reklam ironSource.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z ironSource Ads, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam ironSource Ads (z ustalaniem stawek) i ironSource Ads (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z ironSource Ads, wydawcy mogą sprawdzić błąd źródłowy w odpowiedzi reklamy za pomocą ResponseInfo w tych klasach:

Android

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Oto kody i odpowiednie komunikaty z adaptera reklam ironSource, które są generowane, gdy nie udaje się wczytać reklamy:

Android

Kod błędu Przyczyna
101 Parametry serwera ironSource Ads skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Aby zainicjować SDK, reklamy ironSource wymagają kontekstu aktywności.
103 ironSource Ads może wczytywać tylko 1 reklamę na identyfikator instancji ironSource.
105 Żądaną wielkość banera reklamowego nie obsługuje ironSource Ads.
106 Pakiet SDK reklam ironSource nie został zainicjowany.
501-1056 Błędy pakietu SDK do reklam ironSource. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją.

iOS

Kod błędu Przyczyna
101 Parametry serwera ironSource Ads skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Adapter reklam ironSource nie obsługuje żądanego formatu reklamy.
103 Reklama ironSource jest już wczytana na potrzeby tej konfiguracji sieci.
104 Żądaną wielkość banera reklamowego nie obsługuje ironSource Ads.
508-1037 Błędy pakietu SDK ironSource Ads. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją.

Historia zmian wtyczki zapośredniczenia Unity firmy IronSource

Wersja 3.4.0

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.1

Wersja 3.2.0

Wersja 3.1.1

Wersja 3.1.0

Wersja 3.0.1

Wersja 3.0.0

Wersja 2.6.1

Wersja 2.6.0

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ługa wersji adaptera IronSource na iOS 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ługa wersji adaptera IronSource na Androida 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ługa wersji adaptera IronSource na iOS 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

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs API do reklam z nagrodą w ramach otwartych testów beta.
  • Obsługuje adapter IronSource na Androida w wersji 6.8.1.2
  • Obsługuje adapter iOS firmy IronSource w wersji 6.8.0.1

Wersja 1.0.4

  • Obsługa wersji adaptera Androida IronSource 6.7.11.0
  • Obsługuje adapter IronSource na iOS w wersji 6.7.11.0

Wersja 1.0.3

  • Obsługuje wersję adaptera IronSource na Androida 6.7.10
  • 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
  • Rozwiązaliśmy konflikt z wtyczką mediacji Unity Chartboost.

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.