Zintegruj 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ą 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

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.

Panel aplikacji Chartboost

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

Zarządzanie aplikacjami

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

Nowy formularz aplikacji

Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacjipodpis aplikacji.

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

Panel zapośredniczenia 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.

Edytowanie ustawień aplikacji

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

Tryb testowy Chartboost

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 RODOustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

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

  1. Pobierz z Maven Central plik .aar z najnowszą wersją pakietu Chartboost SDK i dodaj go do projektu.

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

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