Integracja reklam ironSource z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z reklam ironSource za pomocą zapośredniczenia obejmującego integracje kaskadowe. Dowiesz się z niego, jak dodać reklamy ironSource do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter reklam ironSource z aplikacją Flutter .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do reklam ironSource zapewnia te funkcje:

¹ Integracja określania stawek jest w fazie zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się ze swoim menedżerem konta.

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

Wymagania

• Najnowszy pakiet SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Aby wdrożyć to na Androidzie:
  • Interfejs API Androida na poziomie 21 lub wyższym
• Aby wdrożyć w iOS:
  • Cel wdrożenia iOS w wersji 12.0 lub nowszej
• Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
• Wykonaj 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.

Utwórz instancję

Następnie skonfiguruj instancję sieci dla dodanej aplikacji.

Znajdowanie klucza interfejsu API do raportowania

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

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 za pomocą pub.dev

(Tylko w Androidzie) Dodaj te repozytoria do pliku build.gradle w katalogu android projektu:

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

Dodaj tę zależność do najnowszych wersji pakietu IronSource SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_ironsource: ^1.0.0

Integracja ręczna

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

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

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource zawiera metodę GmaMediationIronsource().SetConsent() . Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK ironSource. Jeśli zdecydujesz się wywoływać tę metodę, zalecamy wykonanie jej 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);

Więcej informacji znajdziesz w dokumentacji reklam ironSource na temat zaawansowanych ustawień dotyczących regulacji.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Wtyczka zapośredniczenia do reklam mobilnych Google dla reklam ironSource zawiera metodę GmaMediationIronsource().setDoNotSell . Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK ironSource. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane do pakietu SDK ironSource.

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

GmaMediationIronsource().setDoNotSell(true);

Więcej informacji oraz wartości, które można podać w tej metodzie, znajdziesz w dokumentacji reklam ironSource na temat zaawansowanych ustawień regulacji zarówno na Androida, jak 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łą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 otrzyma reklamy z reklam ironSource, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na reklamę, używając polecenia ResponseInfo w następujących klasach:

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter reklam ironSource, gdy nie uda się wczytać reklamy:

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.