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 przy użyciu 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ą Flutter .

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

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

² Ten format jest obsługiwany tylko w ramach integracji kaskadowej.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter 3.7.0 lub nowszy
• Aby wdrożyć na Androidzie:
  • Poziom interfejsu API 21 lub nowszy
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS 12.0 lub nowsza
• działający Flutter 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 reklam ironSource

Zarejestruj się i zaloguj na konto ironSource Ads.

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

Wpisz szczegóły aplikacji

Wybierz Aplikacja na żywo, wpisz adres URL swojej aplikacji 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.

Uwaga: IronSource ogranicza maksymalną liczbę identyfikatorów instancji, które możesz utworzyć. Jeśli otrzymasz komunikat o błędzie, że nie możesz utworzyć więcej identyfikatorów instancji, skontaktuj się z zespołem pomocy IronSource, aby uzyskać pomoc.

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

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 musisz też podać tajny klucz i token odświeżania z ironSource Ads.

Na panelu ironSource Ads dla wydawców kliknij Moje konto, a potem kartę API. Zapisz tajny klucz i odświeżający token.

Włączanie trybu testowego

Aby włączyć reklamy testowe ironSource Ads, postępuj zgodnie z instrukcjami w przewodniku Testowanie integracji firmy ironSource Ads.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy ironSource w  AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie ironSource Mobile do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Ważne: sprawdź, czy masz uprawnienia Zarządzanie kontem, aby skonfigurować zgodę użytkownika z UE i RODO, ustawę CPRA i Platformę do wysyłania wiadomości do użytkowników. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

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

Uwaga: brak integracji zgodnych wersji pakietów SDK reklam ironSource i reklam mobilnych Google może spowodować problemy z kompilacją.

Integracja przez pub.dev

(dotyczy tylko Androida) dodaj te repozytoria do pliku build.gradle w katalogu android projektu:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

Dodaj te zależności z najnowszymi wersjami pakietu IronSource SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_ironsource: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla IronSource , wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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 ironSourceobsługuje metodę GmaMediationIronsource().SetConsent() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do interfejsu programowania reklam ironSource Ads SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby 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);

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 podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 Adsobsługuje metodę GmaMediationIronsource().setDoNotSell 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.

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(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 Android 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.

Aby dowiedzieć się, które reguły ProGuard są wymagane w przypadku Twojego projektu, zapoznaj się z przewodnikiem IronSource Ads dotyczącym integracji pakietu SDK na Androida i dodaj te reguły do pliku proguard-user.txt.

Cykl życia aplikacji

W każdej z Twoich aktywności zastąpij metody onPause() i onResume() odpowiednimi metodami z biblioteki ironSource Ads w ten 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 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.

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

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 ironSource Ads. 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 została już załadowana w przypadku 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 adaptera zapośredniczenia Fluttera od ironSource

Następna wersja

• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

• Weryfikowana zgodność z adapterem Androida ironSource w wersji 8.2.1.0
• Weryfikowana zgodność z adapterem ironSource na iOS w wersji 8.2.0.0.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.0.0

• Pierwsza wersja.
• Weryfikowana zgodność z przejściem na Androida z wersji 8.0.0.0 firmy ironSource
• Weryfikowana zgodność z adapterem ironSource na iOS w wersji 8.0.0.0.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.