Integracja reklam ironSource z zapośredniczeniem

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 AdMob do reklam ironSource te funkcje:

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

1 Trwa integracja określania stawek zamkniętych testów beta, skontaktuj się ze swoim menedżerem konta i poproś o dostęp.

2 Ten format to tylko obsługiwane w integracji kaskadowej.

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

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 Karta Ustawienia publikacji. Unity powinna pokazywać, gdzie niestandardowy Utworzono proguard-user.txt plik do modyfikacji.

Plik Unity Proguard

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 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 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 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. Zobacz dokumentację .

iOS

Kod błędu Przyczyna
101 Brak 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. Zobacz dokumentację .

Historia zmian wtyczki IronSource Unity Mediation

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