Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Chartboost za pomocą zapośredniczenia (łącznie z integracją kaskady). Opisano w nim, jak dodać Chartboost do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją na Unity.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla Chartboost ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt na Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Wykonaj czynności dotyczące zapośredniczenia Wprowadzenie
Krok 1. Skonfiguruj konfiguracje w interfejsie Chartboost
Zarejestruj konto Chartboost i zaloguj się, gdy konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.
Kliknij przycisk Dodaj nową aplikację, aby utworzyć aplikację.
Wypełnij pozostałe pola i kliknij przycisk Dodaj aplikację, aby zakończyć tworzenie aplikacji.
Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.
Android
iOS
AdMob Aby skonfigurować AdMob identyfikator jednostki reklamowej, musisz mieć Identyfikator użytkownika i Podpis użytkownika Chartboost. Aby znaleźć te parametry, kliknij Zapośredniczenie Chartboost w interfejsie Chartboost.
Otwórz kartę Zasoby > Eksplorator interfejsów API i zanotuj identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.
Włącz tryb testowy
Aby włączyć tryb testowy w swojej aplikacji, w interfejsie Chartboost otwórz kartę Zarządzanie aplikacjami, wybierz aplikację z listy i kliknij Edytuj ustawienia aplikacji.
Android
iOS
W ustawieniach aplikacji możesz włączyć w niej tryb testowy.
Po włączeniu trybu testowego możesz wysyłać żądania reklam, używając wcześniej utworzonego identyfikatora jednostki reklamowej, i otrzymywać reklamę testową Chartboost.
Gdy otrzymasz reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w Sprawdzaniu aplikacji przez wydawców firmy Chartboost. Aby zarabiać na Chartboost, sprawdzenie aplikacji wydawcy musi zostać zatwierdzone przez Chartboost.
Krok 2. Skonfiguruj oferty reklamowe Chartboost w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodaj Chartboost 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ć Chartboost do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet SDK i adapter Chartboost
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Chartboost, korzystając z linku do pobrania w historii zmian, i wyodrębnij GoogleMobileAdsChartboostMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Assets > Import Package > Custom Package (Zasoby > Importuj pakiet > Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsChartboostMediation.unitypackage
. Zaznacz wszystkie pliki i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności w Usługach Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji Unity.
Krok 4. Zaimplementuj 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Wtyczka zapośredniczenia reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Poniższy przykładowy kod ustawia zgodę użytkownika NonBehavioral
na korzystanie z danych. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań 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 wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Poniższy przykładowy kod ustawia zgodę użytkownika OptInSale
na korzystanie z danych. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
Krok 5. Dodaj wymagany kod
Android
Integracja z Chartboost nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją Chartboost, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Chartboost interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyChartboost, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Chartboost (Waterfall) źródeł reklam.
Kroki opcjonalne
Android
Uprawnienia
Aby uzyskać optymalną wydajność, 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ć przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z metody ResponseInfo
w ramach tych klas:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Chartboost, gdy reklama się nie wczytuje:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK Chartboost zwrócił błąd. |
101 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost. |
102 | Chartboost może wczytywać tylko 1 reklamę na lokalizację. |
103 | Brakuje parametrów serwera Chartboost skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
104 | Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlania. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera Chartboost skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
102 | Pakiet SDK Chartboost zwrócił błąd inicjowania. |
103 | Reklama Chartboost nie jest przechowywana w pamięci podręcznej w czasie wyświetlania. |
104 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost. |
105 | Wersja systemu operacyjnego urządzenia jest niższa niż minimalna obsługiwana wersja pakietu SDK Chartboost. |
200-299 | Błędy pamięci podręcznej pakietu SDK Chartboost. Więcej informacji znajdziesz w kodzie. |
300-399 | Pakiet SDK Chartboost pokazuje błędy. Więcej informacji znajdziesz w kodzie. |
400-499 | Błędy związane z kliknięciami w pakiecie Chartboost SDK. Więcej informacji znajdziesz w kodzie. |
Historia zmian wtyczki Chartboost Unity Mediation
Wersja 4.5.0
- Obsługuje adapter Androida Chartboost w wersji 9.6.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 9.6.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.4.0
- Obsługuje adapter na Androida Chartboost w wersji 9.5.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 9.5.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.5.3.
Wersja 4.3.0
- Obsługuje adapter Androida Chartboost w wersji 9.4.0.0.
- Obsługuje adapter systemu iOS Chartboost w wersji 9.4.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.5.0.
Wersja 4.2.0
- Obsługuje adapter Androida Chartboost w wersji 9.3.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 9.3.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.2.0.
Wersja 4.1.1
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/Chartboost/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.Chartboost
. - Obsługuje adapter Androida Chartboost w wersji 9.2.1.1.
- Obsługuje adapter na iOS Chartboost w wersji 9.2.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 4.1.0
- Obsługuje adapter Androida Chartboost w wersji 9.2.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 9.2.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 4.0.0
- Obsługuje adapter Androida Chartboost w wersji 9.1.1.0.
- Obsługuje adapter na iOS Chartboost w wersji 9.1.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.5.1
- Obsługuje adapter Androida Chartboost w wersji 8.4.3.1.
- Obsługuje adapter na iOS Chartboost w wersji 8.5.0.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 3.5.0
- Obsługuje adapter Androida Chartboost w wersji 8.4.2.0.
- Obsługuje adapter na iOS Chartboost w wersji 8.5.0.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.4.1
- Obsługuje adapter Androida Chartboost w wersji 8.3.1.0.
- Obsługuje adapter na iOS Chartboost w wersji 8.5.0.2.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.4.0
- Obsługuje adapter Androida Chartboost w wersji 8.3.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 8.5.0.1.0.
Wersja 3.3.1
- Obsługuje adapter Androida Chartboost w wersji 8.2.1.0.
- Obsługuje adapter systemu iOS Chartboost w wersji 8.4.1.1.
Wersja 3.3.0
- Obsługuje adapter Androida Chartboost w wersji 8.2.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 8.4.0.0.
Wersja 3.2.0
- Obsługuje adapter Androida Chartboost w wersji 8.1.0.0.
- Obsługuje adapter na iOS Chartboost w wersji 8.3.1.0.
Wersja 3.1.0
- Usunięto metodę
RestrictDataCollection()
z klasyChartboost
. - Dodano metody pomocnicze (
AddDataUseConsent()
) w celu przekazywania do Chartboost informacji dotyczących RODO i CCPA. - Obsługuje adapter Androida Chartboost w wersji 8.1.0.0.
- Obsługuje adapter systemu iOS Chartboost w wersji 8.2.0.0.
Wersja 3.0.1
- Obsługuje adapter Androida Chartboost w wersji 8.0.3.1.
- Obsługuje adapter na iOS Chartboost w wersji 8.1.0.1.
Wersja 3.0.0
- Obsługuje adapter Androida Chartboost w wersji 8.0.2.0.
- Obsługuje adapter iOS Chartboost w wersji 8.1.0.0.
Wersja 2.0.1
- Obsługuje adapter Androida Chartboost w wersji 7.5.0.1.
- Obsługuje adapter na iOS Chartboost w wersji 8.0.4.0.
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 włączyć ograniczenia zbierania danych zgodnej z RODO w przypadku pakietu 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.