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 obejmującego integrację kaskadową. Dowiesz się, jak dodać Chartboost do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją w Unity.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do Chartboost:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt w Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Wykonaj zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Chartboost
Sign up for a Chartboost account and log in once your account is verified. Then, navigate to the Apps management tab.
Click the Add new app button to create your app.
Fill out the rest of the form and click the Add App button to finalize your app.
After your app is created, you will be directed to its dashboard. Take note of the App ID and App Signature of your app.
Android
iOS
AdMob requires the Chartboost User ID and User Signature for setting up your AdMob ad unit ID. You can find these parameters by clicking Chartboost mediation on the Chartboost UI.
Navigate to the Resources > API Explorer tab and take note of your User ID and User Signature located under the Authentication section.
Turn on test mode
You can enable test mode on your app by navigating to the Apps management tab from the Chartboost UI, selecting your app from the list and clicking on Edit app settings.
Android
iOS
From your app's settings, you can toggle Test mode on your app.
Once test mode is enabled, you can request ads using the ad unit ID created earlier and receive a Chartboost test ad.
After you are able to receive Chartboost test ads, your app will be placed on Chartboost's Publisher App Review. In order for monetization on Chartboost to work, the publisher app review will need to be approved by Chartboost.
Krok 2. Skonfiguruj popyt na platformie 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 Chartboost i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla Chartboost, korzystając z linku pobierania w dzienniku zmian i wyodrębnij GoogleMobileAdsChartboostMediation.unitypackage
z pliku ZIP.
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 wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play od zera przeprowadzi analizę zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
Krok 4. Wdróż 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) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Ten przykładowy kod ustawia stan zgody na korzystanie z danych na NonBehavioral
. Jeśli chcesz wywoływać tę metodę, zrób 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 wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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 każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent()
. Ten przykładowy kod ustawia stan zgody na korzystanie z danych na OptInSale
. Jeśli chcesz wywoływać tę metodę, zrób 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
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
Nie musisz wykonywać żadnych dodatkowych czynności w przypadku integracji z iOS.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Chartboost, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, używając parametru ResponseInfo
z 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 nie uda się wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet Chartboost SDK zwrócił komunikat o błędzie. |
101 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost. |
102 | Chartboost może wczytać tylko 1 reklamę na lokalizację naraz. |
103 | Brak parametrów serwera Chartboost skonfigurowanych w AdMob interfejsie lub są nieprawidłowe. |
104 | Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brak parametrów serwera Chartboost skonfigurowanych w AdMob interfejsie lub są nieprawidłowe. |
102 | Pakiet SDK Chartboost zwrócił błąd inicjowania. |
103 | Reklama Chartboost nie jest zapisywana w pamięci podręcznej podczas 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 systemu operacyjnego w pakiecie Chartboost SDK. |
200-299 | Błędy pamięci podręcznej pakietu SDK Chartboost. Więcej informacji znajdziesz w opisie kodu. |
300-399 | Pakiet Chartboost SDK wyświetla błędy. Więcej informacji znajdziesz w opisie kodu. |
400-499 | Błędy kliknięć pakietu Chartboost SDK. Więcej informacji znajdziesz w opisie kodu. |
Historia zmian wtyczki Chartboost Unity Mediation
Wersja 4.6.0
- Obsługuje adapter Androida Chartboost w wersji 9.7.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.7.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 4.5.0
- Obsługuje adapter Androida Chartboost w wersji 9.6.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.6.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.4.0
- Obsługuje adapter Androida Chartboost w wersji 9.5.0.0.
- Obsługuje adapter Chartboost na iOS w wersji 9.5.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 9.4.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 9.3.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.2.0.
Wersja 4.1.1
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/Chartboost/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.Chartboost
. - Obsługuje adapter Androida Chartboost w wersji 9.2.1.1.
- Obsługuje adapter Chartboost na iOS w wersji 9.2.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 9.2.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 9.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 8.5.0.2.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 8.5.0.2.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS w wersji 8.5.0.2.
- Utworzono i przetestowano z wykorzystaniem wtyczki 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 Chartboost na iOS 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 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 Chartboost na iOS w wersji 8.4.0.0.
Wersja 3.2.0
- Obsługuje adapter Androida Chartboost 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 metody pomocnicze (
AddDataUseConsent()
) służące do przekazywania informacji dotyczących RODO i CCPA do platformy Chartboost. - Obsługuje adapter Androida Chartboost 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 Androida Chartboost 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 Androida Chartboost 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 Androida Chartboost w wersji 7.5.0.1.
- Obsługuje adapter Chartboost na iOS 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
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą.
- 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 Chartboost iOS SDK w wersji 7.2.0.
- Dodano metodę
Chartboost.RestrictDataCollection()
, która włącza ograniczenia zbierania danych zgodnie z RODO przez pakiet SDK Chartboost.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje pakiet SDK Chartboost na Androida w wersji 7.0.1.
- Obsługuje pakiet Chartboost iOS SDK w wersji 7.1.2.