Integracja Chartboost z zapośredniczeniem

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.

Panel aplikacji Chartboost

Kliknij przycisk Dodaj nową aplikację, aby utworzyć aplikację.

Zarządzanie aplikacjami

Wypełnij pozostałe pola i kliknij przycisk Dodaj aplikację, aby zakończyć tworzenie aplikacji.

Nowy formularz aplikacji

Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Android

Ustawienia aplikacji

iOS

Ustawienia aplikacji

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.

Panel zapośredniczenia Chartboost

Otwórz kartę Zasoby > Eksplorator interfejsów API i zanotuj identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.

Eksplorator interfejsu Chartboost

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

Edytuj ustawienia aplikacji

iOS

Edytuj ustawienia aplikacji

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

Tryb testowy Chartboost

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

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

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 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.