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. Flutter
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ą | |
Reklama 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
- Flutter w wersji 3.7.0 lub nowszej
- 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 Flutter 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
Integracja przez pub.dev
(Tylko na Androidzie) Dodaj poniższe repozytoria do pliku build.gradle
znajdującego się w nim
katalog android
Twojego projektu:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Dodaj tę zależność z najnowszymi wersjami
IronSource
Pakiet SDK i adapter w pakiecie
Plik pubspec.yaml
:
dependencies:
gma_mediation_ironsource: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla
IronSource
rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki
(i jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w
pubspec.yaml
przez dodanie tej zależności:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
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
obejmuje
GmaMediationIronsource().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.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().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
obejmuje
GmaMediationIronsource().setDoNotSell
. 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.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(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.
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
.
Cykl życia aplikacji
Zastąp metody onPause()
i onResume()
w każdym z tych
musisz wywoływać odpowiednie metody reklam ironSource w następujący sposób:
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
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 Ads (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ę . |
Dziennik zmian adaptera zapośredniczenia ironSource Flutter
1.0.0
- Pierwsza wersja.
- Zweryfikowano zgodność z adapterem ironSource na Androida w wersji 8.0.0.0
- Zweryfikowano zgodność z adapterem ironSource na iOS w wersji 8.0.0.0.0
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.