Integracja ironSource z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

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, a także jak przeprowadzać integrację kaskadową. Wyjaśnia, 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:

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

Wymagania

• Android w wersji 24 lub nowszej

• [W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu 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ę.

Znajdowanie klucza interfejsu API raportowania

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/")
    }
  }
}

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

1. Pobierz najnowszą wersję pakietu ironSource Ads SDK na Androida i dodaj ją do swojego projektu.

2. W repozytorium Maven Google przejdź do artefaktów 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 platformy Google UMP i platform CMP, które obsługują udzielenie dodatkowej zgody.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli możliwość wycofania zgody 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 stanów USA dotyczącymi ochrony 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 CCPA. Poniższy przykładowy kod pokazuje, jak przekazać te informacje o zgodzie do pakietu ironSource Ads SDK. Te opcje muszą zostać ustawione przed zainicjowaniemGMA Next-Gen SDK, aby można je było prawidłowo przekazać do pakietu ironSource Ads SDK.

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

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 Activity kontekst podczas wczytywania banerów, reklam pełnoekranowych i reklam z nagrodą. Bez kontekstu aktywności wczytywanie reklam się nie powiedzie.

Reguły ProGuard

Jeśli zmniejszysz, zaciemnisz i zoptymalizujesz aplikację, ironSource Ads będzie wymagać dodatkowych reguł ProGuard w Twoim 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 (określanie 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: