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

Integracja ironSource z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z ironSource Ads przy użyciu zapośredniczenia, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać reklamy ironSource do konfiguracji zapośredniczenia jednostki reklamowej, jak skonfigurować optymalizację źródła reklam oraz jak zintegrować pakiet SDK i adapter reklam ironSource z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

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

¹ Ten format jest obsługiwany tylko w integracji kaskadowej.

Wymagania

Android w wersji API 24 lub nowszej

[Ustalanie stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w ustalaniu stawek, użyj adaptera IronSource w wersji 8.5.0.1 lub nowszej (zalecana jest najnowsza wersja).

Najnowsze GMA Next-Gen SDK.
Zapoznaj się z przewodnikiem dla początkujących dotyczącym mediacji.

Krok 1. Skonfiguruj ustawienia w interfejsie ironSource Ads

Zarejestruj się i zaloguj na konto ironSource Ads.

Dodaj nową aplikację

Aby dodać nową aplikację, otwórz Reklamy > Aplikacje i kliknij Dodaj aplikację.

Wypełnij formularz i kliknij Dodaj aplikację.

Zanotuj klucz aplikacji, a potem wybierz formaty reklam obsługiwane przez aplikację i kliknij Dalej.

Utwórz instancję

Następnie skonfiguruj instancję dodanej aplikacji.

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

Określanie stawek

Wypełnij formularz i w sekcji Ceny wybierz Określanie stawek. Kliknij Zapisz i zamknij.

Zapisz Identyfikator instancji.

Wodospad

Wypełnij formularz i kliknij Zapisz i zamknij.

Zapisz Identyfikator instancji.

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Wodospad

Na stronie Moje konto kliknij kartę API i zanotuj klucz tajny oraz token odświeżania.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

Aby wdrożyć app-ads.txt w przypadku ironSource, zapoznaj się z informacjami o autoryzowanych sprzedawcach ironSource.

Włączanie trybu testowego

Aby włączyć reklamy testowe ironSource Ads, postępuj zgodnie z instrukcjami w przewodniku Testowanie integracji ironSource Ads.

Krok 2. Skonfiguruj popyt na reklamy ironSource w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

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

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywny, wybierz format reklamy i ustaw typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w obszarach 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 reklam ironSource, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz ironSource Ads jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie.

Włącz Automatyczne zbieranie danych i wpisz tajny klucz oraz token odświeżania uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Rodzaj integracji, Android jako Platformę i Aktywny jako Stan. Wpisz klucz aplikacji i identyfikator instancji uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

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

Dodawanie ironSource Mobile do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

Aby dodać ironSource Mobile do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK ironSource Ads i adapter

Integracja z Androidem 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: Korzystaj z najnowszych wersji pakietu SDK do reklam ironSource i adaptera:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.22.0-beta04")
    implementation("com.google.ads.mediation:ironsource:9.2.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Integracja ręczna

Pobierz najnowszą wersję pakietu ironSource Ads SDK na Androida i dodaj ją do swojego projektu.
W repozytorium Maven Google otwórz artefakty adaptera reklam ironSource. Wybierz najnowszą wersję, pobierz plik .aar adaptera IronSource i dodaj go do projektu.

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK ironSource Ads

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

Od wersji 7.7.0 pakietu SDK ironSource automatycznie odczytuje zgodę użytkowników w zakresie RODO ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Obsługa platform UMP i CMP Google, które obsługują dodatkową zgodę użytkowników.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA 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 Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

W wersji 6.14.0 pakietu SDK ironSource Ads dodaliśmy interfejs API obsługujący przepisy ustawy CCPA. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do pakietu ironSource Ads SDK. Te opcje muszą być ustawione przed zainicjowaniemGMA Next-Gen SDK, aby były prawidłowo przekazywane do pakietu ironSource Ads SDK.

Java

LevelPlay.setMetaData("do_not_sell", "true");IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")IronSourceMediationSnippets.kt

Więcej informacji i wartości, które można podać w tej metodzie, znajdziesz w dokumentacji ironSource Ads na temat zaawansowanych ustawień dotyczących przepisów.

Krok 5. Dodaj wymagany kod

Ładowanie reklamy z kontekstem aktywności

Podawaj kontekst Activity podczas wczytywania banerów, reklam pełnoekranowych i reklam z nagrodą. Bez kontekstu aktywności wczytywanie reklam zakończy się niepowodzeniem.

Reguły ProGuard

Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, ironSource Ads będzie wymagać dodatkowych reguł ProGuard w projekcie. Więcej informacji znajdziesz w przewodniku po integracji pakietu SDK do reklam ironSource na Androida.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze i włączono 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 (ustalanie stawek) i ironSource Ads (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z ironSource Ads, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i komunikaty wyświetlane przez adapter ironSource Ads, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
101	Parametry serwera reklam ironSource skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Aby zainicjować pakiet SDK, ironSource Ads wymaga kontekstu Activity.
103	ironSource Ads może wczytać tylko 1 reklamę na identyfikator instancji ironSource Ads.
105	Żądany rozmiar banera reklamowego nie jest obsługiwany przez ironSource Ads.
106	Pakiet SDK ironSource Ads nie został zainicjowany.
501-1056	Błędy pakietu SDK ironSource Ads. Więcej informacji znajdziesz w dokumentacji.