Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Chartboost za pomocą zapośredniczenia, na temat integracji kaskadowych. Omawiamy sposób dodawania Chartboost do konfiguracji zapośredniczenia oraz integracji pakietu SDK Chartboost i adaptera do aplikacji Unity.
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia do Chartboost ma te funkcje:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na 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. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Chartboost
Zarejestruj konto Chartboost i zaloguj się, gdy Twoje konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.
Kliknij przycisk Dodaj nową aplikację, aby utworzyć aplikację.
Wypełnij pozostałe pola formularza i kliknij przycisk Dodaj aplikację, aby dokończyć dodawanie aplikacji. .
Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zanotuj: Identyfikator aplikacji i Podpis aplikacji.
Android
iOS
AdMob wymaga identyfikatora użytkownika Chartboost Podpis użytkownika do skonfigurowania reklamy AdMob identyfikator jednostki. Aby znaleźć te parametry, kliknij Zapośredniczenie Chartboost w interfejsie Chartboost.
Otwórz menu Zasoby > API Explorer i zwróć uwagę na Identyfikator użytkownika i Podpis użytkownika znajdują się w sekcji Uwierzytelnianie.
Włącz tryb testowy
Aby włączyć tryb testowy w swojej aplikacji, otwórz Zarządzanie aplikacjami. w interfejsie Chartboost, wybierz swoją aplikację z listy i kliknij Edytowanie ustawień aplikacji
Android
iOS
W ustawieniach aplikacji możesz włączyć tryb testowy.
Po włączeniu trybu testowego możesz wysyłać żądania reklam, korzystając z utworzonego identyfikatora jednostki reklamowej wcześniej i otrzymać reklamę testową Chartboost.
Gdy zaczniesz otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona o publikacji w serwisie Publisher App Review przygotowanym przez Chartboost. Aby zarabiać na Chartboost, wydawca muszą zostać zatwierdzone przez 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
Krok 3. Zaimportuj pakiet SDK Chartboost i adapter
OpenUPM-CLI
Jeśli masz OpenUPM-CLI możesz zainstalować reklamy mobilne Google Chartboost Wtyczka zapośredniczenia dla Unity, uruchamiając następujące 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ć plik Ustawienia menedżera pakietów Unity
Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z zakresem następujące szczegóły:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakresy:
com.google
Następnie otwórz Okno > Menedżer pakietów, aby otworzyć plik Unity Package Manager oraz Z menu wybierz My Registries (Moje rejestry).
Wybierz pakiet zapośredniczenia Chartboost dla reklam mobilnych Google i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla
Chartboost po kliknięciu linku pobierania w
Historia zmian
i wyodrębnij
GoogleMobileAdsChartboostMediation.unitypackage
z kodu pocztowego
.
W edytorze projektów Unity wybierz Zasoby > Importuj pakiet >
Custom Package (Pakiet niestandardowy) i znajdź
GoogleMobileAdsChartboostMediation.unitypackage
pobranego pliku. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij
Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play >
Program do rozpoznawania Androida > Wymuś rozwiązanie. Program do rozpoznawania usług Unity Play
biblioteka rozpozna zależności od zera i skopiuje
zadeklarowano zależności w katalogu Assets/Plugins/Android
Aplikacja Unity.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Chartboost
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera
Metoda Chartboost.AddDataUseConsent()
. Użycie danych w poniższych przykładowych zbiorach kodu
NonBehavioral
. Jeśli zdecydujesz się wywoływać tę metodę, jest zalecana
zrobić to przed wysłaniem żądania reklamy 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
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Wtyczka zapośredniczenia do reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera
Metoda Chartboost.AddDataUseConsent()
. Użycie danych w poniższych przykładowych zbiorach kodu
OptInSale
. Jeśli zdecydujesz się wywoływać tę metodę, jest zalecana
zrobić to przed wysłaniem żądania reklamy 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
Obserwuj Chartboost
dokumentacja
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ą skuteczność, Chartboost zaleca dodanie następujących
uprawnienia do pliku AndroidManifest.xml
Twojej aplikacji:
<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 odbierze reklamy z Chartboost,
wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia
ResponseInfo
w ramach tych zajęć:
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 Chartboost SDK zwrócił błąd. |
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. Zobacz kod . |
300-399 | Pakiet Chartboost SDK wyświetla błędy. Zobacz kod . |
400-499 | Błędy kliknięć pakietu Chartboost SDK. Zobacz kod . |
Historia zmian wtyczki Chartboost Unity Mediation
Następna wersja
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
.
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.