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. Pokazuje on, 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

Adapter zapośredniczenia AdMob 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 określania stawek jest w wersji beta dostępnej publicznie.

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

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 lub nowszej
  • Aby wdrożyć na Androidzie:
    • interfejsu API na poziomie 23 lub wyższym,
  • Aby wdrożyć aplikację na iOS:
    • docelowa wersja iOS 12.0 lub nowsza,
  • działający projekt Flutter 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.

Dodaj nową aplikację

Aby dodać nową aplikację, kliknij Reklamy > Aplikacje i kliknij Dodaj aplikację.

Wypełnij formularz i kliknij Dodaj aplikację.

Zanotuj klucz aplikacji, a potem wybierz formaty reklam obsługiwane przez aplikację i kliknij Dalej.

Android

iOS

Utwórz instancję

Następnie skonfiguruj instancję dodanej aplikacji.

Kliknij Reklamy > Konfiguracja > Instancje. Wybierz aplikację i kliknij Utwórz instancję.

Określanie stawek

Wypełnij formularz i w sekcji Ceny wybierz Ustalanie stawek. Kliknij Zapisz i zamknij.

Android

iOS

Zanotuj identyfikator instancji.

Android

iOS

Wodospad

Wypełnij formularz i kliknij Zapisz i zamknij.

Zanotuj identyfikator instancji.

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

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

Wodospad

Na stronie Moje konto kliknij kartę Interfejs API i zapisz klucz tajny oraz token odświeżania.

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w przypadku ironSource, zapoznaj się z informacjami na stronie autoryzowanych sprzedawców ironSource.

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

Konfigurowanie ustawień pośrednictwa 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

Wykonaj czynności opisane w ustawieniach dotyczących europejskich przepisów i amerykańskich przepisów stanowych, aby dodać ironSource Mobile do listy partnerów reklamowych w ramach europejskich i amerykańskich przepisów stanowych w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter ironSource Ads

Integracja za pomocą 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/")
      }
  }

W pliku pubspec.yaml pakietu dodaj te zależności z najnowszymi wersjami pakietu SDK i adaptera reklam ironSource:

dependencies:
  gma_mediation_ironsource: ^

Integracja ręczna

Pobierz najnowszą wersję wtyczki pośredniczącej reklam mobilnych Google dla ironSource Ads, 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

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 wykorzystaniu 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 reklam mobilnych Google do pośrednictwa reklam ironSource Ads wykorzystuje 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 na temat zaawansowanych ustawień regulacji.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj 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 reklam mobilnych Google do pośrednictwa reklam ironSource Ads wykorzystuje 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 Twojego 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 tych aktywności zastąpij metody onPause() i onResume() odpowiednimi metodami 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

Upewnij się, że zarejestrujesz urządzenie testowe w AdMob i włączysz tryb testowy w interfejsie reklam ironSource.

Weryfikacja 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ć pakiet SDK, ironSource Ads wymaga 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 ironSource Ads 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 do pośrednictwa reklamowego Flutter firmy ironSource

1.3.0

  • Skompilowano i przetestowano za pomocą wtyczki Flutter do reklam mobilnych Google w wersji 6.0.0.

1.2.0

  • Skompilowano i przetestowano z użyciem wtyczki Google Mobile Ads dla Fluttera w wersji 5.3.1.

1.1.0

  • Wtyczka na iOS jest teraz ramką statyczną.
  • Skompilowano i przetestowano z użyciem wtyczki Google Mobile Ads dla Fluttera w wersji 5.3.1.

1.0.0

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