Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Chartboost za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Przewodnik zawiera informacje o tym, jak dodać Chartboost do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją Android .
Obsługiwane integracje i formaty reklam
Adapter mediacji dla Chartboost ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Natywna |
Wymagania
- Poziom interfejsu API 21 lub nowszy
Najnowszy pakiet SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Chartboost
Załóż konto Chartboost i zaloguj się, gdy konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.
Kliknij przycisk Dodaj nową aplikację, aby utworzyć aplikację.
Wypełnij resztę formularza i kliknij przycisk Dodaj aplikację, aby zakończyć proces.
Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.
AdMob wymaga identyfikatora użytkownika i podpisu użytkownika Chartboost do skonfigurowania identyfikatora jednostki reklamowej AdMob. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.
Otwórz kartę Zasoby > Eksplorer interfejsu API i zapisz identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.
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.
W ustawieniach aplikacji możesz włączyć tryb testowy.
Po włączeniu trybu testowego możesz wysyłać żądania reklam, korzystając z utworzonego wcześniej identyfikatora jednostki reklamowej, i otrzymywać 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
Dodawanie partnerów reklamowych do listy zgodnej 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
Integracja z Android Studio (zalecana)
W pliku settings.gradle.kts
na poziomie projektu dodaj te repozytoria:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
Następnie w pliku build.gradle.kts
na poziomie aplikacji dodaj poniższe zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera Chartboost:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}
Integracja ręczna
Pobierz z Maven Central plik
.aar
z najnowszą wersją pakietu Chartboost SDK i dodaj go do projektu.Przejdź do artefaktów adaptera Chartboost w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz plik
.aar
adaptera Chartboost i dodaj go do projektu.
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Chartboost
Zgoda użytkowników z UE i RODO
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.
W wersji pakietu SDK 8.1.0 firma Chartboost dodała metodę addDataUseConsent()
. Ten przykładowy kod zawiera zgodę na korzystanie z danych w usłudze NON_BEHAVIORAL
. 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.
Java
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)
Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w artykule Chartboost na temat RODO oraz w dokumentacji Metody ochrony prywatności na Androidzie .
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 „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.
W wersji pakietu SDK 8.1.0 firma Chartboost dodała metodę addDataUseConsent()
. Ten przykładowy kod zawiera zgodę na korzystanie z danych w usłudze OPT_IN_SALE
. 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.
Java
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w artykule na temat CCPA firmy Chartboost oraz w dokumentach Metody ochrony prywatności na Androidzie .
Krok 5. Dodaj wymagany kod
Modyfikowanie pliku AndroidManifest
Inne elementy
Dodaj ten atrybut do każdej aktywności w pliku AndroidManifest.xml
, która będzie wyświetlać reklamy Chartboost i obsługuje różne orientacje:
android:configChanges="keyboardHidden|orientation|screenSize"
Zdarzenia cyklu życia
Zgodnie z zaleceniem Chartboost dodaj ten kod do wszystkich zdarzeń cyklu życia aktywności, w których przypadku będą wyświetlane reklamy Chartboost.
Java
import com.chartboost.sdk.Chartboost;
// ...
@Override
public void onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed()) {
return;
} else {
super.onBackPressed();
}
}
Kotlin
import com.chartboost.sdk.Chartboost
// ...
@Override
fun onBackPressed() {
// If an interstitial is on screen, close it.
if (Chartboost.onBackPressed())
return
else
super.onBackPressed()
}
Krok 6. Przetestuj implementację
Kroki opcjonalne:
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" />
Kody błędów
Jeśli adapter nie otrzyma reklamy z Chartboost, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, używając
ResponseInfo.getAdapterResponses()
w ramach tych klas:
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
Oto kody i odpowiednie komunikaty z adaptera Chartboost, które pojawiają się, gdy nie udaje się załadować reklamy:
Kod błędu | Przyczyna |
---|---|
0-99 | Pakiet SDK Chartboost zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Chartboost. |
101 | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze Chartboost. |
102 | Chartboost może wczytać tylko 1 reklamę na lokalizację naraz. |
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. |
Historia zmian adaptera pośredniczącego Chartboost na potrzeby mediowania na Androida
Wersja 9.7.0.0
- Zweryfikowano zgodność z pakietem SDK Chartboost w wersji 9.7.0.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 23.0.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
- Wersja pakietu SDK Chartboost 9.7.0.
Wersja 9.6.1.0
- Zweryfikowano zgodność z pakietem SDK Chartboost w wersji 9.6.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.6.0.
- Wersja pakietu SDK Chartboost 9.6.1.
Wersja 9.6.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.6.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.5.0.
- Wersja pakietu SDK Chartboost 9.6.0.
Wersja 9.5.0.0
- Zweryfikowano zgodność z pakietem SDK Chartboost w wersji 9.5.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
- Pakiet Chartboost SDK w wersji 9.5.0.
Wersja 9.4.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.4.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
- Wersja pakietu SDK Chartboost 9.4.1.
Wersja 9.4.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.4.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
- Wersja pakietu SDK Chartboost 9.4.0.
Wersja 9.3.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.3.1.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 22.1.0.
- Wersja pakietu SDK Chartboost 9.3.1.
Wersja 9.3.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.3.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Pakiet Chartboost SDK w wersji 9.3.0
Wersja 9.2.1.1
- Zaktualizowano adapter, aby używać nowej klasy
VersionInfo
. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 22.0.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
- Pakiet Chartboost SDK w wersji 9.2.1
Wersja 9.2.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.2.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Wersja pakietu SDK Chartboost 9.2.1.
Wersja 9.2.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.2.0.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
- Wersja pakietu SDK Chartboost 9.2.0.
Wersja 9.1.1.0
- Dodaliśmy metodę
ChartboostMediationAdapter.setAppParams(String, String)
jako opcjonalny sposób kodowania na stałe identyfikatora i podpisu aplikacji, które mają być używane do inicjowania pakietu SDK Chartboost. - Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.1.1.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.3.0.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.3.0.
- Pakiet Chartboost SDK w wersji 9.1.1
Wersja 8.4.3.1
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
- Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
- Wersja pakietu SDK Chartboost 8.4.3.
Wersja 8.4.3.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.4.3.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
- Wersja pakietu SDK Chartboost 8.4.3.
Wersja 8.4.2.0
- Zweryfikowana zgodność z pakietem SDK Chartboost w wersji 8.4.2.
- Zaktualizowano
compileSdkVersion
itargetSdkVersion
do poziomu API 31. - Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 20.6.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
- Pakiet Chartboost SDK w wersji 8.4.2
Wersja 8.4.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.4.1.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 20.6.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
- Wersja pakietu SDK Chartboost 8.4.1.
Wersja 8.3.1.0
- Zweryfikowano zgodność z pakietem SDK Chartboost 8.3.1.
- Zaktualizowano adapter, aby używał nowego interfejsu API
AdError
.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
- Wersja pakietu SDK Chartboost 8.3.1.
Wersja 8.3.0.0
- Zweryfikowana zgodność z pakietem SDK Chartboost w wersji 8.3.0.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.5.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.5.0.
- Pakiet Chartboost SDK w wersji 8.3.0
Wersja 8.2.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.2.1.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
- Wersja pakietu SDK Chartboost 8.2.1.
Wersja 8.2.0.1
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.0.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
- Pakiet Chartboost SDK w wersji 8.2.0
Wersja 8.2.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.2.0.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.5.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
- Wersja pakietu SDK Chartboost 8.2.0.
Wersja 8.1.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.1.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
- Wersja pakietu SDK Chartboost 8.1.0.
Wersja 8.0.3.2
- Dodano opisowe kody błędów i przyczyny niepowodzenia wczytywania/wyświetlania adaptera.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.2.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
- Pakiet Chartboost SDK w wersji 8.0.3
Wersja 8.0.3.1
- Dodaliśmy obsługę banerów reklamowych Chartboost.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Wersja pakietu SDK Chartboost 8.0.3.
Wersja 8.0.3.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 8.0.3.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
- Wersja pakietu SDK Chartboost 8.0.3.
Wersja 8.0.2.0
- Zweryfikowana zgodność z pakietem SDK Chartboost w wersji 8.0.2.
- Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.0.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 19.0.1.
- Wersja pakietu SDK Chartboost 8.0.2.
Wersja 8.0.1.0
- Zweryfikowano zgodność z pakietem SDK Chartboost 8.0.1.
- Wymaga pakietu SDK Chartboost w wersji 8.0.1 lub nowszej.
- Aby wczytać reklamy, nie musisz już podawać kontekstu aktywności.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Pakiet Chartboost SDK w wersji 8.0.1
Wersja 7.5.0.1
- Naprawiliśmy błąd, przez który adapter Chartboost nie wywoływał zdarzeń reklamowych.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google została zaktualizowana do 18.3.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
- Pakiet SDK Chartboost w wersji 7.5.0.
Wersja 7.5.0.0
- Zweryfikowano zgodność z pakietem SDK Chartboost 7.5.0.
- Przeniesiono adapter na korzystanie z zależności AndroidX.
- Minimalna wymagana wersja pakietu SDK do reklam mobilnych Google to 18.1.1.
Wersja 7.3.1.1
- Zaktualizowano adapter, aby obsługiwał nowy interfejs API nagród w wersji beta otwartej.
- Zaktualizowano minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 17.2.0.
Wersja 7.3.1.0
- Zweryfikowano zgodność z pakietem SDK Chartboost 7.3.1.
Wersja 7.3.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 7.3.0.
Wersja 7.2.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 7.2.1.
Wersja 7.2.0.1
- Zaktualizowano adapter, aby wywoływał zdarzenie reklamowe
onRewardedVideoComplete()
.
Wersja 7.2.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 7.2.0.
Wersja 7.1.0.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 7.1.0.
Wersja 7.0.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 7.0.1.
- Dodano obsługę nowych kodów błędów Chartboost.
- Zaktualizowano projekt adaptera do wersji Android Studio 3.0
Wersja 7.0.0.0
- Zaktualizowaliśmy adapter, aby był zgodny z pakietem SDK Chartboost w wersji 7.0.0.
Wersja 6.6.3.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 6.6.3.
Wersja 6.6.2.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 6.6.2.
Wersja 6.6.1.0
- Weryfikowana zgodność z pakietem SDK Chartboost w wersji 6.6.1.
Wersja 6.6.0.0
- Zmieniliśmy system nazewnictwa wersji na [Wersja pakietu SDK Chartboost].[adapter patch version].
- Adaptery można teraz dodać jako zależność kompilacji, dodając do tagu zależności pliku build.gradle następujący kod:
compile 'com.google.ads.mediation:chartboost:6.6.0.0'
- Przeniesiono do dystrybucji adaptera w formacie AAR zamiast pliku jar (dodatkowe instrukcje znajdziesz w README).
Wersja 1.1.0
- Usunięto lokalizację reklamy Chartboost z dodatków Chartboost. Lokalizacja reklamy jest teraz określana w konsoli AdMob podczas konfigurowania Chartboost na potrzeby zapośredniczenia.
Wersja 1.0.0
- Pierwsza wersja. Obsługuje reklamy wideo z nagrodą i reklamy pełnoekranowe.