Integracja Chartboost z zapośredniczeniem

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

Ad Manager Adapter do mediacji dla Chartboost ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą

Wymagania

  • Unity w wersji 4 lub nowszej
  • 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.

Panel aplikacji Chartboost

Aby utworzyć aplikację, kliknij przycisk Dodaj nową aplikację.

Zarządzanie aplikacjami

Wypełnij resztę formularza i kliknij przycisk Dodaj aplikację, aby zakończyć proces.

Formularz dotyczący nowej aplikacji

Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Android

Ustawienia aplikacji

iOS

Ustawienia aplikacji

Aby skonfigurować identyfikator jednostki reklamowej AdMob, musisz podać identyfikator użytkownika i podpis użytkownika z serwisu Chartboost. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.

Panel pośrednictwa Chartboost

Otwórz kartę Zasoby > Eksplorer interfejsu API i zapisz identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.

Chartboost API Explorer

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

Edytowanie ustawień aplikacji

iOS

Edytowanie ustawień aplikacji

W ustawieniach aplikacji możesz włączyć tryb testowy.

Tryb testowy Chartboost

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  Ad Manager 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 przewodnika dla 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 interfejs wiersza poleceń OpenUPM-CLI, możesz zainstalować wtyczkę zapośredniczenia Chartboost Google Mobile Ads dla Unity w projekcie, 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 Rejestry ograniczone dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

  • Nazwa: OpenUPM
  • Adres URL: https://package.openupm.com
  • Zakres: com.google

Szczegóły UPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads Chartboost Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zewnętrznych zależności > 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.

Wymuś rozwiązanie

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Chartboost

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 przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka do zapośredniczenia reklam mobilnych Google dla 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 podmiotu 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 do zapośredniczenia reklam mobilnych Google dla 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 Ad Manager 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 Ad Manager 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 kodowaniu.
300-399 Błędy pakietu SDK Chartboost. Więcej informacji znajdziesz w kodowaniu.
400-499 Błędy kliknięć w pakiecie SDK Chartboost. Więcej informacji znajdziesz w kodowaniu.

Historia zmian wtyczki do mediacji Chartboost dla Unity

Wersja 4.7.0

Wersja 4.6.1

Wersja 4.6.0

Wersja 4.5.0

Wersja 4.4.0

Wersja 4.3.0

Wersja 4.2.0

Wersja 4.1.1

Wersja 4.1.0

Wersja 4.0.0

Wersja 3.5.1

Wersja 3.5.0

Wersja 3.4.1

Wersja 3.4.0

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.0

Wersja 3.0.1

Wersja 3.0.0

Wersja 2.0.1

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.