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

Integracja ironSource z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy ironSource korzystające z mediacji, wodospad integracje. Opisuje sposób dodawania reklam ironSource do zapośredniczenia jednostki reklamowej. jak skonfigurować optymalizację źródeł reklam i jak zintegrować Pakiet SDK i adapter reklam ironSource na Android aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager do reklam ironSource te funkcje:

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

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ 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 Google Play 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 skonfigurowaniaAd Manager 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.

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

Wpisz wymagane informacje, a potem kliknij Zapisz i zamknij.

Gdy instancja zostanie utworzona, będzie on wymieniony w polu Identyfikator instancji.

Znajdowanie klucza interfejsu API do raportowania

Oprócz klucza aplikacji i identyfikatora instancji potrzebujesz też tajnego klucza i tokena odświeżania ironSource Ads, aby skonfigurowaćAd Manager identyfikator jednostki reklamowej.

Otwórz Moje konto w panelu wydawcy ironSource Ads, a następnie kliknij kartę Interfejs API. Zapisz Tajny klucz i Token odświeżania.

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 Ad Manager interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w przypadku usługi IronSource , możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz IronSource , wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszSecret Key and Refresh Token uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszApp Key and Instance ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

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 Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK i adapter reklam ironSource

Integracja Android Studio (zalecana)

W pliku settings.gradle.kts na poziomie projektu dodaj: 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 elementy zależności i konfiguracje wdrożenia. Użyj najnowszych wersji Pakiet SDK i adapter reklam ironSource:

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

Integracja ręczna

Pobierz najnowszą wersję Pakiet SDK do wyświetlania reklam ironSource na Androida i dodaj ją do projektu.
Przejdź do Artefakty adaptera reklam ironSource w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz pliku .aar adaptera IronSource i dodaj go do projektu.

Krok 4. Wdroż ustawienia prywatności w pakiecie SDK do reklam ironSource

Zgoda użytkowników z UE i RODO

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

W pakiecie SDK w wersji 6.7.9 usługa ironSource Ads dodała interfejs API do uzyskiwania zgody. Następująca próbka pokazuje, jak przekazać te informacje o zgodzie do pakietu SDK ironSource. Jeśli metody wywoływania tej metody, zalecamy wykonanie tych czynności przed wysyłanie żądań 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)

Zobacz dokumentację reklam ironSource na Zaawansowane ustawienia dotyczące regulacji .

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.

W pakiecie SDK w wersji 6.14.0 firma ironSource Ads dodała interfejs API, aby obsługiwać przepisy CCPA. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do funkcji ironSource Ads SDK. Te opcje należy skonfigurować przed zainicjować pakiet SDK do reklam mobilnych Google aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK 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")

Zobacz dokumentację reklam ironSource na temat zaawansowanych regulacji prawnych Ustawienia .

Krok 5. Dodaj wymagany kod

Cykl życia aplikacji

Zastąp metody onPause() i onResume() w każdej aktywności na wywołaj odpowiednie metody reklam ironSource w następujący 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 zmniejszać, zaciemniać i optymalizować aplikację , reklamy ironSource wymagają dodatkowych reguł ProGuard w projekcie. Skonsultuj się Przewodnik po integracji pakietu SDK na Androida z reklam ironSource .

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager 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 odbierze reklamy z reklam ironSource, możesz sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez reklamy ironSource adaptera, gdy reklama nie wczytuje się:

Kod błędu	Przyczyna
101	Parametry serwera reklam ironSource skonfigurowane w Ad Manager Brak interfejsu lub jest on nieprawidłowy.
102	Reklamy ironSource wymagają kontekstu aktywności do zainicjowania pakietu SDK.
103	Reklamy ironSource mogą wczytywać tylko 1 reklamę na identyfikator instancji reklam ironSource.
105	Żądany rozmiar banera reklamowego nie jest obsługiwany w reklamach ironSource.
106	Pakiet SDK do wyświetlania reklam ironSource nie został zainicjowany.
501-1056	Błędy pakietu SDK do reklam ironSource. Zobacz dokumentację .
101	Brakuje parametrów serwera reklam ironSource skonfigurowanych w Ad Manager interfejsie lub są one nieprawidłowe.
102	Adapter reklam ironSource nie obsługuje żądanego formatu reklamy.
103	Reklama ironSource jest już wczytana na potrzeby tej konfiguracji sieci.
104	Żądany rozmiar banera reklamowego nie jest obsługiwany w reklamach ironSource.
508-1037	Błędy pakietu SDK do reklam ironSource. Zobacz dokumentację .