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. 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 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 przypadku integracji kaskadowej.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter 3.7.0 lub nowszy
• Aby wdrożyć na Androidzie:
  • Interfejs API Androida na poziomie 21 lub wyższym
• 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.
• Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj ustawienia w interfejsie ironSource Ads

Zarejestruj się i zaloguj na konto ironSource Ads.

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

Wpisz szczegóły aplikacji

Wybierz Aktywna aplikacja, wpisz jej nazwę 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 pozostałe pola formularza i kliknij Add App (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.

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  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 dotyczące RODO i Ustawienia dotyczące przepisów stanowych USA, aby dodać w interfejsie AdMob firmę ironSource na urządzenia mobilne do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi.

Krok 3. Zaimportuj pakiet SDK i adapter reklam ironSource

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 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 reklam mobilnych Google do pośrednictwa IronSource , wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie w pliku pubspec.yaml dodaj odwołanie do wtyczki, 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 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). 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 przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Wtyczka do zapośredniczenia reklam mobilnych Google dla reklam ironSourceobsługuje metodęGmaMediationIronsource().SetConsent(). Ten przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK 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 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 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 zapośredniczenia do reklam mobilnych Google dla reklam ironSource obejmuje metodę GmaMediationIronsource().setDoNotSell . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do interfejsu programowania reklam ironSource Ads SDK. 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 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 Androida 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

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie reklam ironSource.

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:

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 za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

• Zweryfikowano zgodność z adapterem ironSource na Androida w wersji 8.2.1.0
• Zweryfikowano 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 adapterem Androida ironSource w wersji 8.0.0.0
• 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.