Ta strona została przetłumaczona przez Cloud Translation API.

Integracja 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ą AdMob Mediation, obejmując integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu Chartboost do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Chartboost z aplikacją na Androida.

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

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik dla początkujących na temat zapośredniczenia.

Krok 1. Skonfiguruj konfiguracje w interfejsie Chartboost

Zarejestruj się na koncie Chartboost i zaloguj się, gdy Twoje konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.

Panel aplikacji Chartboost

Aby utworzyć aplikację, kliknij przycisk Dodaj nową aplikację.

Zarządzanie aplikacjami

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

Formularz dotyczący nowej aplikacji

Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Ustawienia aplikacji

Aby skonfigurować identyfikator jednostki reklamowej AdMob, musisz podać identyfikator użytkownika i podpis użytkownika z serwisu Chartboost. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.

Panel pośrednictwa 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

Gdy tryb testowy zostanie włączony, możesz żądać reklam za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymać 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 Chartboost w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Chartboost do konfiguracji pośrednictwa dla danej jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodawanie Chartboost jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy mediów na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Karta Jednostki reklamowe powinna być teraz wypełniona wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie Chartboost jako źródła reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij Chartboost.

Wybierz Chartboost i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródeł reklam w Chartboost, wpisz identyfikator użytkownika i podpis użytkownika uzyskane w poprzedniej sekcji. Następnie w przypadku Chartboost wpisz wartość eCPM i kliknij Dalej.

Jeśli masz już mapowanie dla Chartboost, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator aplikacji, sygnaturę aplikacji i miejsce docelowe reklamy uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Miejsca docelowe reklam Chartboost (nazwane lokalizacje) to proste nazwy reprezentujące miejsce w aplikacji, w którym chcesz wyświetlać reklamę. AdMob wysyła żądania do lokalizacji określonej w ustawieniach. Po wysłaniu żądań Chartboost dodaje lokalizację do swojej platformy na potrzeby raportowania. Użytkownicy mogą też tworzyć nowe lokalizacje reklam bezpośrednio na platformie Chartboost, zanim wywołają je w swoich grach.

W interfejsie Chartboost możesz wyświetlić swoje lokalizacje reklam na stronie Ustawienia podstawowe, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku Chartboost [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/).
Na koniec kliknij Gotowe, aby dodać Chartboost jako źródło reklam, a następnie kliknij Zapisz.

Uwaga: optymalizacja źródła reklam wymaga kilku dni na zebranie wystarczającej ilości danych, aby można było dokładnie obliczyć eCPM w ramach sieci zapośredniczącej. Stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla tej sieci. Gdy można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować tę wartość w Twoim imieniu.

Dodawanie Chartboost do listy partnerów reklamowych zgodnych 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 amerykańskich przepisów stanowych.

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 te 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.6.0")
    implementation("com.google.ads.mediation:chartboost:9.8.2.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 Maven Google. 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(). Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na 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 na temat RODO i Metody ochrony prywatności na Androidzie firmy Chartboost.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na sprzedawcę obowiązek zapewnienia użytkownikom możliwości rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej „sprzedawcy” należy umieścić dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po przepisach stanowych 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. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zachować zgodność.

W wersji pakietu SDK 8.1.0 firma Chartboost dodała metodę addDataUseConsent(). Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na 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 i Metody ochrony prywatności na Androidzie firmy Chartboost.

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

Włączanie reklam testowych

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

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Chartboost, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam Chartboost (kaskada).

Kroki opcjonalne:

Uprawnienia

Aby zapewnić optymalną skuteczność, firma 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 dodatkowe komunikaty zwracane przez adapter Chartboost, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
0-99	Pakiet SDK Chartboost zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Chartboost.
101	Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze Chartboost.
102	Chartboost może wczytywać tylko 1 reklamę na lokalizację w danym momencie.
103	Parametry serwera Chartboost skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
104	Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia.