Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Chartboost za pomocą mediacji, obejmującej integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu Chartboost do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Chartboost z aplikacją Unity.
Obsługiwane integracje i formaty reklam
AdMob Adapter do mediacji dla Chartboost ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Aby wdrożyć na Androidzie:
- poziom interfejsu API 21 lub nowszy,
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS 12.0 lub nowsza
- działający projekt Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie Chartboost
Zarejestruj się na koncie Chartboost i zaloguj się, gdy Twoje konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.
Aby utworzyć aplikację, kliknij przycisk Dodaj nową aplikację.
Wypełnij resztę formularza i kliknij przycisk Dodaj aplikację, aby zakończyć proces.
Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.
Android
iOS
Aby skonfigurować identyfikator jednostki reklamowej AdMob, musisz podać identyfikator użytkownika i podpis użytkownika z Chartboost. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.
Otwórz kartę Zasoby > Eksplorer interfejsu API i zapisz identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.
Włączanie trybu testowego
Aby włączyć tryb testowy w aplikacji, otwórz kartę Zarządzanie aplikacjami w interfejsie Chartboost, wybierz aplikację z listy i kliknij Edytuj ustawienia aplikacji.
Android
iOS
W ustawieniach aplikacji możesz włączyć tryb testowy.
Gdy tryb testowy zostanie włączony, możesz żądać reklam za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymać reklamę testową Chartboost.
Gdy będziesz już otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w sprawdzaniu aplikacji wydawcy Chartboost. Aby zarabiać na reklamach w Chartboost, musisz uzyskać zatwierdzenie aplikacji wydawcy przez Chartboost.
Krok 2. Skonfiguruj zapotrzebowanie na reklamy w AdMob UI Chartboost
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.
Dodawanie Chartboost do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA
Aby dodać Chartboost do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.
Krok 3. Zaimportuj pakiet SDK i adapter Chartboost
OpenUPM-CLI
Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Chartboost Mediation Plugin for Unity do Google Mobile Ads, uruchamiając to polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Google Ads Mobile Ads Chartboost Mediation i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki Google Mobile Ads do pośredniczenia w kampaniach dla Chartboost z linku do pobrania w Changelog i rozpakuj plik zipGoogleMobileAdsChartboostMediation.unitypackage
.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsChartboostMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
Twojej aplikacji Unity.
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Chartboost
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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.
Wtyczka zapośredniczenia reklam mobilnych Google do Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na NonBehavioral
. 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.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
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 po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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ść.
Wtyczka zapośredniczenia reklam mobilnych Google do Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na OptInSale
. 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.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
Krok 5. Dodaj wymagany kod
Android
Do integracji z Chartboost nie jest potrzebny żaden dodatkowy kod.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją Chartboost.
Krok 6. Przetestuj implementację
Włączanie reklam testowych
Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Chartboost.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z Chartboost, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Chartboost (kaskada).
Kroki opcjonalne
Android
Uprawnienia
Aby zapewnić optymalną skuteczność, firma Chartboost zaleca dodanie do pliku AndroidManifest.xml
aplikacji tych opcjonalnych uprawnień:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
Integracja z iOS nie wymaga żadnych dodatkowych czynności.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Chartboost, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z ResponseInfo
w ramach tych klas:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
Oto kody i odpowiednie komunikaty zwracane przez adapter Chartboost, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK Chartboost zwrócił błąd. |
101 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze Chartboost. |
102 | Chartboost może wczytywać tylko 1 reklamę na lokalizację w danym momencie. |
103 | Parametry serwera Chartboost skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje. |
104 | Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Parametry serwera Chartboost skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje. |
102 | Pakiet SDK Chartboost zwrócił błąd inicjalizacji. |
103 | Reklama Chartboost nie jest zapisywana w pamięci podręcznej w momencie wyświetlania. |
104 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze Chartboost. |
105 | Wersja systemu operacyjnego urządzenia jest starsza niż minimalna obsługiwana wersja pakietu SDK Chartboost. |
200-299 | Błędy pamięci podręcznej pakietu SDK Chartboost. Więcej informacji znajdziesz w kodu. |
300-399 | Błędy pakietu SDK Chartboost. Więcej informacji znajdziesz w kodu. |
400-499 | Błędy kliknięć związane z pakietem SDK Chartboost. Więcej informacji znajdziesz w kodu. |
Historia zmian wtyczki do mediacji Chartboost dla Unity
Wersja 4.7.0
- Obsługuje adapter Chartboost na Androida w wersji 9.8.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.8.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 4.6.1
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
. - Obsługuje adapter Chartboost na Androida w wersji 9.7.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.7.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 4.6.0
- Obsługuje adapter Chartboost na Androida w wersji 9.7.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.7.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 4.5.0
- Obsługuje adapter Chartboost na Androida w wersji 9.6.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.6.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.6.0.
Wersja 4.4.0
- Obsługuje adapter Chartboost na Androida w wersji 9.5.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.5.1.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.5.3.
Wersja 4.3.0
- Obsługuje adapter Chartboost na Androida w wersji 9.4.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.4.0.0.
- Została ona utworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.5.0.
Wersja 4.2.0
- Obsługuje adapter Chartboost na Androida w wersji 9.3.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.3.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.2.0.
Wersja 4.1.1
- Treść adaptera została przeniesiona do
GoogleMobileAds/Mediation/Chartboost/
. - Przesłana przestrzeń nazw adaptera, która używa
GoogleMobileAds.Mediation.Chartboost
. - Obsługuje adapter Chartboost na Androida w wersji 9.2.1.1.
- Obsługuje adapter Chartboost na iOS w wersji 9.2.0.0.
- Została ona utworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.1.0.
Wersja 4.1.0
- Obsługuje adapter Chartboost na Androida w wersji 9.2.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.2.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.4.1.
Wersja 4.0.0
- Obsługuje adapter Chartboost na Androida w wersji 9.1.1.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.1.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.3.0.
Wersja 3.5.1
- Obsługuje adapter Chartboost na Androida w wersji 8.4.3.1.
- Obsługuje adapter Chartboost na iOS w wersji 8.5.0.2.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.2.
Wersja 3.5.0
- Obsługuje adapter Chartboost na Androida w wersji 8.4.2.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.5.0.2.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 3.4.1
- Obsługuje adapter Chartboost na Androida w wersji 8.3.1.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.5.0.2.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 3.4.0
- Obsługuje adapter Chartboost na Androida w wersji 8.3.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.5.0.1.0.
Wersja 3.3.1
- Obsługuje adapter Chartboost na Androida w wersji 8.2.1.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.4.1.1.
Wersja 3.3.0
- Obsługuje adapter Chartboost na Androida w wersji 8.2.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.4.0.0.
Wersja 3.2.0
- Obsługuje adapter Chartboost na Androida w wersji 8.1.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.3.1.0.
Wersja 3.1.0
- Usunięto metodę
RestrictDataCollection()
z klasyChartboost
. - Dodano
AddDataUseConsent()
metody pomocnicze do przekazywania do Chartboost informacji związanych z GDPR i CCPA. - Obsługuje adapter Chartboost na Androida w wersji 8.1.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.2.0.0.
Wersja 3.0.1
- Obsługuje adapter Chartboost na Androida w wersji 8.0.3.1.
- Obsługuje adapter Chartboost na iOS w wersji 8.1.0.1.
Wersja 3.0.0
- Obsługuje adapter Chartboost na Androida w wersji 8.0.2.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.1.0.0.
Wersja 2.0.1
- Obsługuje adapter Chartboost na Androida w wersji 7.5.0.1.
- Obsługuje adapter Chartboost na iOS w wersji 8.0.4.
Wersja 2.0.0
- Obsługuje adapter Chartboost na Androida w wersji 7.5.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 8.0.1.1.
Wersja 1.3.0
- Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
- Obsługuje adapter Chartboost na Androida w wersji 7.3.1.1.
- Obsługuje adapter Chartboost na iOS w wersji 7.5.0.0.
Wersja 1.2.0
- Obsługuje adapter Chartboost na Androida w wersji 7.3.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 7.3.0.0.
Wersja 1.1.1
- Obsługuje adapter Chartboost na Androida w wersji 7.2.0.1.
- Obsługuje adapter Chartboost na iOS w wersji 7.2.0.1.
Wersja 1.1.0
- Obsługuje pakiet SDK Chartboost na Androida w wersji 7.2.0.
- Obsługuje pakiet SDK Chartboost na iOS w wersji 7.2.0.
- Dodano metodę
Chartboost.RestrictDataCollection()
, aby umożliwić ograniczenie gromadzenia danych zgodnie z RODO w pakiecie SDK Chartboost.
Wersja 1.0.0
- Pierwsza wersja
- Obsługuje pakiet SDK Chartboost na Androida w wersji 7.0.1.
- Obsługuje pakiet SDK Chartboost na iOS w wersji 7.1.2.