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

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

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

Uwaga: w IronSource możesz utworzyć maksymalną liczbę identyfikatorów instancji. Jeśli pojawi się błąd z informacją, że nie można utworzyć więcej identyfikatorów instancji, skontaktuj się z zespołem pomocy IronSource, aby uzyskać pomoc.

Ważne: jeśli chcesz obsługiwać reklamy pełnoekranowe z nagrodą, wybierz format Reklama wideo z nagrodą i użyj tego identyfikatora instancji, aby dodać reklamy ironSource jako źródło reklam w kroku 2. Aby skonfigurować identyfikator instancji na potrzeby obsługi reklam pełnoekranowych z nagrodą, musisz skontaktować się z zespołem pomocy ironSource Ads pod adresem [e-mail].

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

Ważne: Sprawdź, czy masz uprawnienia Zarządzanie kontem, aby wykonać na potrzeby uzyskiwania zgody użytkowników z UE, RODO, ustawy CPRA i komunikatora dla użytkowników. Zobacz Zarządzaj dostępem użytkowników do .

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

Uwaga: brak możliwości zintegrowania zgodnych reklam ironSource z reklamami mobilnymi Google Wersje pakietu SDK mogą powodować problemy z kompilacją.

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.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob i IronSource .

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.