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. Przewodnik zawiera informacje o dodawaniu pakietu ironSource Ads do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera ironSource Ads z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla ironSource Ads ma te możliwości:

¹ 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 w wersji 3.7.0 lub nowszej
• Aby wdrożyć na Androidzie:
  • Android API na poziomie 21 lub wyższym
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS to 12.0 lub nowsza.
• działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w sekcji Pierwsze kroki.
• Przeczytaj Przewodnik dla początkujących na temat zapośredniczenia.

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. Ta wartość będzie potrzebna do skonfigurowania identyfikatora jednostki reklamowej AdMob. Wybierz formaty reklam obsługiwane przez Twoją aplikację. Następnie kliknij Dalej.

Utwórz instancję

Następnie skonfiguruj instancję sieci dla dodanej aplikacji.

Znajdowanie klucza interfejsu API raportowania

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ń zapośredniczenia dla jednostki reklamowej

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

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

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/")
      }
  }

Dodaj w pliku pubspec.yaml pakietu następującą zależność z najnowszymi wersjami pakietu SDK i adaptera ironSource Ads:

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

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 pośrednictwa reklam mobilnych Google dla reklam ironSource obejmuje metodę GmaMediationIronsource().SetConsent(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Ads SDK firmy IronSource. 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 sprzedawcę obowiązek zapewnienia użytkownikom możliwości rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej „sprzedawcy” należy umieścić dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po przepisach stanowych 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 zachować zgodność.

Wtyczka pośrednictwa reklam mobilnych Google dla reklam ironSource obejmuje metodę GmaMediationIronsource().setDoNotSell Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu Ads SDK firmy IronSource. Te opcje muszą zostać ustawione przed zainicjowaniem 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ń regulacji dotyczących Android i iOS.

Krok 5. Dodaj wymagany kod

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Zarejestruj urządzenie testowe w AdMob i włącz 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:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Oto kody i odpowiednie komunikaty z adaptera reklam ironSource, które są generowane, gdy nie udaje się wczytać reklamy:

Historia zmian adaptera zapośredniczenia Fluttera od ironSource

Następna wersja

• Skompilowano i przetestowano z użyciem 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 iOS firmy ironSource 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 adapterem Androida ironSource w wersji 8.0.0.0
• Zweryfikowana zgodność z adapterem iOS firmy ironSource w wersji 8.0.0.0.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.