Integracja Chartboost z zapośredniczeniem

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

Ad Manager 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 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

Ad Manager Aby skonfigurować Ad Manager 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 popyt na platformie Chartboost w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Android.

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 Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK Chartboost i adapter

Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla Chartboost klikając link pobierania w Historia zmian i wyodrębnienie GoogleMobileAdsChartboostMediation.unitypackage z pliku ZIP.

W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Custom Package (Pakiet niestandardowy) i znajdować 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. Biblioteka programu do rozpoznawania usług Unity Play rozpoznania zależności od zera i skopiuj zadeklarowane zależności do Katalog Assets/Plugins/Android Twojej aplikacji w Unity.

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Chartboost

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 Ad Manager 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 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 Ad Manager 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 Ad Manager 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

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

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