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

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

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

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 Ad Managera, musisz podać w usłudze Chartboost identyfikator użytkownika i podpis użytkownika. 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 w Ad Manager UI Chartboost

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dlaChartboost, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz Chartboost, wpisz unikalną Nazwę i włącz Zaspośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszUser ID and User Signature uzyskane w poprzedniej sekcji.

Po wybraniu partnera zysku jako Typ integracji wybierz Zapośredniczenie mobilne SDK, jako Platforma wpisz Android, a jako Stan wybierz Aktywny. Wpisz wartośćApp ID, App Signature and Ad Location uzyskaną w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Lokalizacje reklam Chartboost (nazwane lokalizacje) to proste nazwy reprezentujące miejsce w aplikacji, w którym chcesz wyświetlać reklamę. Ad Manager wysyła żądania do lokalizacji określonej w ustawieniach. Po wysłaniu żądań Chartboost doda lokalizację do interfejsu użytkownika na potrzeby raportowania.

W interfejsie Chartboost możesz wyświetlić swoje lokalizacje reklam na stronie Podstawowe ustawienia, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku po nazwanych lokalizacjach Chartboost.

Gdy skończysz, u dołu strony kliknij Zapisz.

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 Ad Managera, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące 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 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.5.0")
    implementation("com.google.ads.mediation:chartboost:9.8.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 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 każdej metody, znajdziesz w artykule Chartboost na temat RODO oraz w dokumentach Metody ochrony prywatności na Androidzie .

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 zapewnić 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 firmy Chartboost oraz w Metodach 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ę

Włączanie reklam testowych

Upewnij się, że zarejestrujesz urządzenie testowe w Ad Managerze i włączysz tryb testowy w interfejsie Chartboost.

Weryfikowanie 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 parametru 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. 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 Ad Manager są nieprawidłowe lub ich brakuje.
104	Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia.