Integracja Chartboost z zapośredniczeniem

Wybierz platformę: Android Nowy Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak wczytywać i wyświetlać reklamy z Chartboost za pomocą zapośredniczenia, korzystając z integracji typu wodospad, za pomocą Google Mobile Ads Flutter Plugin. Dowiesz się, jak dodać Chartboost do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla Chartboost ma te możliwości:

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

Wymagania

Krok 1. Skonfiguruj ustawienia w interfejsie Chartboost

Zarejestruj się w Chartboost i zaloguj się po zweryfikowaniu konta. Następnie otwórz kartę Apps management (Zarządzanie aplikacjami).

Panel aplikacji Chartboost

Aby utworzyć aplikację, kliknij przycisk Add new app (Dodaj nową aplikację).

Zarządzanie aplikacjami

Wypełnij pozostałą część formularza i kliknij przycisk Add App (Dodaj aplikację), aby zakończyć tworzenie aplikacji.

Formularz nowej aplikacji

Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zanotuj identyfikator aplikacji i sygnaturę aplikacji.

Android

Ustawienia aplikacji

iOS

Ustawienia aplikacji

Aby skonfigurować identyfikator jednostki reklamowej AdMob, musisz podać identyfikator użytkownika i sygnaturę użytkownika Chartboost. Te parametry znajdziesz, klikając Chartboost mediation (Zapośredniczenie Chartboost) w interfejsie Chartboost.

Panel mediacji Chartboost

Otwórz kartę Resources > API Explorer (Zasoby > Eksplorator interfejsu API) i zanotuj identyfikator użytkownika oraz sygnaturę użytkownika w sekcji Authentication (Uwierzytelnianie).

Chartboost API Explorer

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, skonfiguruj plik app-ads.txt dla swojej aplikacji.

Aby wdrożyć app-ads.txt w Chartboost, zapoznaj się z artykułem app-ads.txt.

Włącz tryb testowy

Tryb testowy możesz włączyć w aplikacji, otwierając kartę Apps management (Zarządzanie aplikacjami) w interfejsie Chartboost, wybierając aplikację z listy i klikając Edit app settings (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 jest włączony, możesz wysyłać żądania reklam za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymywać reklamy testowe Chartboost.

Gdy zaczniesz otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie poddana weryfikacji wydawcy w Chartboost. Aby monetyzacja w Chartboost działała, weryfikacja aplikacji wydawcy musi zostać zatwierdzona przez Chartboost.

Krok 2. Skonfiguruj popyt Chartboost w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodaj Chartboost do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Aby dodać Chartboost do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera Chartboost w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_chartboost: ^1.4.1

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia Google Mobile Ads dla Chartboost, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie dodaj tę zależność, aby odwołać się do wtyczki w pliku pubspec.yaml:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji swoim użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskiwać zgodę użytkowników na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania reklam. 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

Wtyczka zapośredniczenia Google Mobile Ads dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent(). Ten 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ą Google Mobile Ads Flutter Plugin.

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ą, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (definicje poszczególnych terminów zostały określone w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej „sprzedającego”. Przewodnik po 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. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność.

Wtyczka zapośredniczenia Google Mobile Ads dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent(). Ten 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ą Google Mobile Ads Flutter Plugin.

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

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją Chartboost's.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w AdMob i włącz tryb testowy w interfejsie Chartboost.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z Chartboost, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając źródła reklam Chartboost (Waterfall).

Kroki opcjonalne

Android

Uprawnienia

Aby zapewnić optymalną skuteczność, Chartboost zaleca dodanie tych opcjonalnych uprawnień do pliku AndroidManifest.xml aplikacji:

<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ć podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą ResponseInfo w tych klasach:

Android

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

Oto kody i towarzyszące im komunikaty zwracane przez adapter Chartboost, gdy nie uda się wczytać reklamy:

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 Parametry serwera Chartboost skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
104 Reklama pełnoekranowa lub z nagrodą Chartboost nie jest gotowa do wyświetlenia.

iOS

Kod błędu Przyczyna
101 Parametry serwera Chartboost skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Pakiet SDK Chartboost zwrócił błąd inicjowania.
103 Reklama Chartboost nie jest buforowana w momencie wyświetlania.
104 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost.
105 Wersja systemu operacyjnego urządzenia jest starsza niż minimalna wersja systemu operacyjnego obsługiwana przez pakiet SDK Chartboost.
200-299 Błędy buforowania pakietu SDK Chartboost. Więcej informacji znajdziesz w kodzie.
300-399 Błędy wyświetlania pakietu SDK Chartboost. Więcej informacji znajdziesz w kodzie.
400-499 Błędy kliknięcia pakietu SDK Chartboost. Więcej informacji znajdziesz w kodzie.

Historia zmian adaptera zapośredniczenia Chartboost Flutter

Wersja 1.4.2 (w toku)

  • Zaktualizowano minimalną wersję Fluttera do 3.38.1.
  • Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.4.1

Wersja 1.4.0

Wersja 1.3.3

Wersja 1.3.2

Wersja 1.3.1

Wersja 1.3.0

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.2

Wersja 1.0.1

Wersja 1.0.0