Ta strona została przetłumaczona przez Cloud Translation API.

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ą zapośredniczenia AdMob, obejmującego kaskadowe integracje. Znajdziesz w nim informacje o dodawaniu pakietu ironSource Ads do konfiguracji zapośredniczenia jednostki reklamowej, konfigurowaniu optymalizacji źródła reklam oraz integrowaniu pakietu SDK i adaptera ironSource Ads z aplikacją Android.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek	¹
Wodospad
Formaty
Baner	²
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą	²
Natywna

¹ 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

Poziom interfejsu API 21 lub nowszy
[Do ustalania stawek]: aby zintegrować wszystkie obsługiwane formaty reklamy z określaniem stawek, użyj adaptera IronSource w wersji 8.0.0.0 lub nowszej (zalecana najnowsza wersja).

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika 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 Aplikacja na żywo, wpisz adres URL aplikacji w Google Play 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. Potrzebna Ci ta wartość 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.

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.

Zanotuj identyfikator instancji.

Wodospad

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

Wpisz niezbędne informacje i kliknij Zapisz i zamknij.

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 ironSource Ads.

Na panelu tabeli wydawcy ironSource Ads 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

Musisz dodać reklamy ironSource do konfiguracji zapośredniczenia dla jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodaj reklamy ironSource jako źródło reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie ironSource Ads jako źródła reklam

Określanie stawek

Na karcie Ustalanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz ironSource Ads.
Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo z ustalaniem stawek z ironSource Ads.

Kliknij Potwierdź i zaakceptuj, a potem Dalej.

Jeśli masz już mapowanie dla ironSource Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz klucz aplikacji i identyfikator instancji uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz ironSource Ads.

Wybierz Reklamy ironSource i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam dla reklam ironSource, wpisz klucz tajny i token odświeżania uzyskane w poprzedniej sekcji. Następnie wpisz wartość eCPM dla reklam ironSource i kliknij Dalej.

Jeśli masz już mapowanie reklam ironSource Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz klucz aplikacji i identyfikator instancji uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla tej sieci. Gdy można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować tę wartość w Twoim imieniu.

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 z Android Studio (zalecana)

W pliku settings.gradle.kts na poziomie projektu dodaj te repozytoria:

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

Następnie w pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera ironSource Ads:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:ironsource:8.5.0.0")
}

Integracja ręczna

Pobierz najnowszą wersję pakietu ironSource Ads SDK na Androida i dodaj go do projektu.
Otwórz elementy adaptera reklam ironSource Ads w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera IronSource i dodaj go do projektu.

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.

W wersji pakietu SDK 6.7.9 reklamy ironSource dodały interfejs API do uzyskiwania zgody. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do pakietu SDK reklam 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.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

Więcej informacji i wartości, które można podać w ramach tej metody, znajdziesz w dokumentacji ironSource Ads na temat 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 „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać 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ść.

W wersji pakietu SDK 6.14.0 firma ironSource Ads dodała interfejs API, który obsługuje przepisy ustawy CCPA. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do interfejsu AdMob 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.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

Więcej informacji i wartości, które można podać w ramach tej metody, znajdziesz w dokumentacji ironSource Ads na temat zaawansowanych ustawień regulacji.

Krok 5. Dodaj wymagany kod

Cykl życia aplikacji

W każdej z tych metod zastąpij metody onPause() i onResume(), aby wywołać odpowiednie metody 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)
}

Reguły Proguard

Jeśli ściskasz, zaciemnisz i zoptymalizujesz aplikację, reklamy ironSource wymagają dodania do projektu dodatkowych reguł ProGuard. Więcej informacji znajdziesz w przewodniku integracji pakietu SDK Androida firmy 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.

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, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo.getAdapterResponses() w ramach tych klas:

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

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

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 Ads.
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ą.