Integracja ironSource z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads 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ć ironSource Ads do konfiguracji zapośredniczenia jednostki reklamowej, jak skonfigurować optymalizację źródła reklam oraz jak zintegrować pakiet SDK i adapter ironSource Ads z aplikacją na iOS.

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

iOS w wersji 12.0 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.0.1 lub nowszej (zalecana jest najnowsza wersja).

Najnowsze Google Mobile Ads 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, iOS jako Platformę i Aktywny jako Stan. Wpisz klucz aplikacji i identyfikator instancji uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślna stawka 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

Używanie menedżera pakietów Swift

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 8.10.0.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

W Xcode kliknij File > Add Package Dependencies... (Plik > Dodaj zależności pakietu…).

W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-ironsource.git

W sekcji Reguła zależności wybierz Rozgałęzienie.
W polu tekstowym wpisz main.

Korzystanie z CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:
```
pod 'GoogleMobileAdsMediationIronSource'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu ironSource Ads SDK na iOS i połącz IronSource.framework w projekcie.
Pobierz najnowszą wersję adaptera reklam ironSource, korzystając z linku do pobierania w dzienniku zmian, i połącz go z projektem, korzystając z linku IronSourceAdapter.framework.

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ą 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 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 zainicjowaniemGoogle Mobile Ads SDK, aby były prawidłowo przekazywane do pakietu ironSource Ads SDK.

Swift

// For Swift integration, you need to import the ironSource SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
// ...

IronSource.setMetaDataWithKey("do_not_sell", value: "YES")

Objective-C

#import <IronSource/IronSource.h>
// ...

[IronSource setMetaDataWithKey:@"do_not_sell" value:@"YES"];

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

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją ironSource Ads, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

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 reklamy za pomocą

GADResponseInfo.adNetworkInfoArray w ramach tych klas:

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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	Adapter reklam ironSource nie obsługuje formatu reklamy, o który wysłano żądanie.
103	Reklama ironSource jest już wczytana w przypadku tej konfiguracji sieci.
104	Żądany rozmiar banera reklamowego nie jest obsługiwany przez ironSource Ads.
508-1037	Błędy pakietu SDK ironSource Ads. Więcej informacji znajdziesz w dokumentacji.

Historia zmian adaptera do mediacji ironSource na iOS