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

Integracja Chartboost z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Chartboost za pomocą zapośredniczenia orazintegracji kaskadowej. Dowiesz się, jak dodać Chartboost do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją Android z aplikacją.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Chartboost ma te funkcje:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Chartboost

Zarejestruj 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 pozostałe pola i kliknij przycisk Dodaj aplikację, aby zakończyć tworzenie aplikacji.

Nowy formularz aplikacji

Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Ustawienia aplikacji

Ad Manager Aby skonfigurować Ad Manager identyfikator jednostki reklamowej, musisz mieć Identyfikator użytkownika i Podpis użytkownika Chartboost. Aby znaleźć te parametry, kliknij Zapośredniczenie Chartboost w interfejsie Chartboost.

Panel zapośredniczenia Chartboost

Otwórz kartę Zasoby > Eksplorator interfejsów API i zanotuj identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.

Eksplorator interfejsu Chartboost

Włącz tryb testowy

Aby włączyć tryb testowy w swojej aplikacji, w interfejsie Chartboost otwórz kartę Zarządzanie aplikacjami, wybierz aplikację z listy i kliknij Edytuj ustawienia aplikacji.

Edytuj ustawienia aplikacji

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

Tryb testowy Chartboost

Po włączeniu trybu testowego możesz wysyłać żądania reklam, używając wcześniej utworzonego identyfikatora jednostki reklamowej, i otrzymywać reklamę testową Chartboost.

Gdy otrzymasz reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w Sprawdzaniu aplikacji przez wydawców firmy Chartboost. Aby zarabiać na Chartboost, sprawdzenie aplikacji wydawcy musi zostać zatwierdzone przez Chartboost.

Krok 2. Skonfiguruj popyt na platformie Chartboost w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 w przypadku usługiChartboost, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz Chartboost, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

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

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszApp ID, App Signature and Ad Location uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Lokalizacje reklam Chartboost (Nazwane lokalizacje) to proste nazwy miejsc w aplikacji, w których chcesz wyświetlać reklamę.Ad Manager wysyła żądania do lokalizacji określonej w ustawieniach. Gdy żądania zostaną wysłane, Chartboost doda lokalizację do swojego interfejsu na potrzeby raportowania.

W interfejsie Chartboost Lokalizacje reklam możesz wyświetlić na stronie Ustawienia podstawowe, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku Named Locations (Nazwane lokalizacje) Chartboost.

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

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

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Chartboost do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK Chartboost i adapter

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żyj najnowszych wersji pakietu SDK i adaptera Chartboost:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}

Integracja ręczna

Pobierz plik .aar najnowszej wersji Chartboost SDK z Maven Central i dodaj go do swojego 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. Wdróż 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

W pakiecie SDK w wersji 8.1.0 platforma Chartboost dodała metodę addDataUseConsent(). Ten przykładowy kod zawiera zgodę na korzystanie z danych w usłudze NON_BEHAVIORAL. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego 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)

Zapoznaj się z artykułem na temat RODO na stronie Chartboost i jego: metodami ochrony prywatności w Androidzie , aby dowiedzieć się więcej oraz poznać wartości, jakie można podać w przypadku poszczególnych metod.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący 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. 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 pakiecie SDK w wersji 8.1.0 platforma Chartboost dodała metodę addDataUseConsent(). Ten przykładowy kod zawiera zgodę na korzystanie z danych w usłudze OPT_IN_SALE. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego 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)

Zapoznaj się z artykułem na temat ustawy CCPA na stronie Chartboost Android Privacy Methods , aby dowiedzieć się więcej i dowiedzieć się, jakie wartości można podać w przypadku poszczególnych metod.

Krok 5. Dodaj wymagany kod

Zmodyfikuj 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ługiwać różne orientacje:

android:configChanges="keyboardHidden|orientation|screenSize"

Zdarzenia cyklu życia

Zgodnie z zaleceniem Chartboost dodaj poniższy kod do wszystkich zdarzeń cyklu życia Twojej aktywności, w których przypadku będą się wyświetlać 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łącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w Chartboost interfejsie użytkownika.

Weryfikacja reklam testowych

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

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ć podstawowy błąd w odpowiedzi za pomocą opcji ResponseInfo.getAdapterResponses() w ramach tych klas:

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

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Chartboost, gdy reklama się nie wczytuje:

Kod błędu	Przyczyna
0-99	Pakiet Chartboost SDK zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji Chartboost.
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost.
102	Chartboost może wczytać tylko 1 reklamę na lokalizację naraz.
103	Brak parametrów serwera Chartboost skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe.
104	Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia.
101	Brak parametrów serwera Chartboost skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe.
102	Pakiet SDK Chartboost zwrócił błąd inicjowania.
103	Reklama Chartboost nie jest zapisywana w pamięci podręcznej podczas wyświetlania.
104	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Chartboost.
105	Wersja systemu operacyjnego urządzenia jest niższa niż minimalna obsługiwana wersja systemu operacyjnego w pakiecie Chartboost SDK.
200-299	Błędy pamięci podręcznej pakietu SDK Chartboost. Więcej informacji znajdziesz w opisie kodu.
300-399	Pakiet Chartboost SDK wyświetla błędy. Więcej informacji znajdziesz w opisie kodu.
400-499	Błędy kliknięć pakietu Chartboost SDK. Więcej informacji znajdziesz w opisie kodu.