Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja Chartboost z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z Chartboost przy użyciu mediacji, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać Chartboost do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter do mediacji Chartboost ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

Android w wersji API 24 lub nowszej

Nowości na kanale GMA Next-Gen SDK
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie Chartboost

Zarejestruj się, aby utworzyć konto Chartboost, a gdy zostanie ono zweryfikowane, zaloguj się. 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 sfinalizować aplikację.

Formularz nowej aplikacji

Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zapisz Identyfikator aplikacji i Podpis aplikacji.

Ustawienia aplikacji

Ad Manager wymaga identyfikatora użytkownika i podpisu użytkownika Chartboost do skonfigurowania identyfikatora jednostki reklamowej Ad Managera. Te parametry znajdziesz, klikając Zapośredniczenie Chartboost w interfejsie Chartboost.

Panel mediacji Chartboost

Otwórz kartę Zasoby > Eksplorator interfejsu API i zanotuj identyfikator użytkownika oraz podpis użytkownika w sekcji Uwierzytelnianie.

Chartboost API Explorer

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

Aby wdrożyć app-ads.txt w przypadku Chartboost, zapoznaj się z informacjami o pliku app-ads.txt.

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 za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymywać reklamy testowe Chartboost.

Gdy zaczniesz otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w sekcji Sprawdzanie aplikacji wydawcy w Chartboost. Aby zarabianie na platformie Chartboost było możliwe, aplikacja wydawcy musi zostać zatwierdzona przez Chartboost.

Krok 2. Skonfiguruj popyt Chartboost w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

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

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywny, 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 w przypadku Chartboost, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Wybierz Chartboost jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator użytkownika oraz podpis użytkownika uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako Rodzaj integracji, Android jako Platformę i Aktywny jako Stan. Wpisz identyfikator aplikacji, podpis aplikacji i lokalizację reklamy uzyskane 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 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 Chartboost Named Locations.

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

Dodawanie Chartboost do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

Aby dodać Chartboost do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

Integracja z Androidem 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/")
    }
  }
}

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:chartboost:9.12.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:chartboost:9.12.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

Pobierz plik .aar najnowszej wersji pakietu SDK Chartboost z Maven Central i dodaj go do projektu.
W repozytorium Maven Google otwórz artefakty adaptera Chartboost. Wybierz najnowszą wersję, pobierz plik .aar adaptera Chartboost i dodaj go do projektu.

Krok 4. Wdróż ustawienia prywatności w pakiecie Chartboost SDK

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

W wersji 8.1.0 pakietu SDK firma Chartboost dodała metodę addDataUseConsent(). Poniższy przykładowy kod ustawia zgodę na wykorzystywanie danych na NON_BEHAVIORAL. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem prośby o reklamy za pomocą metody GMA Next-Gen SDK.

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 i wartości, które można podać w poszczególnych metodach, znajdziesz w artykule o RODO na stronie Chartboost oraz w metodach ochrony prywatności na Androidzie.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące ochrony prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 Twoim łańcuchu zapośredniczenia. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

W wersji 8.1.0 pakietu SDK firma Chartboost dodała metodę addDataUseConsent(). Poniższy przykładowy kod ustawia zgodę na wykorzystywanie danych na OPT_IN_SALE. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem prośby o reklamy za pomocą GMA Next-Gen SDK.

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 i wartości, które można podać w poszczególnych metodach, znajdziesz w artykule Chartboost na temat CCPA oraz w metodach ochrony prywatności na Androidzie.

Krok 5. Dodaj wymagany kod

Aktualizowanie zmian w konfiguracji aktywności

Do każdej aktywności w AndroidManifest.xmlpliku, która wyświetla reklamy Chartboost i obsługuje różne orientacje, dodaj ten atrybut:

android:configChanges="keyboardHidden|orientation|screenSize"

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 sieci Chartboost, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Chartboost (kaskadowe).

Kroki opcjonalne:

Uprawnienia

Aby zapewnić optymalną skuteczność, 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 na żądanie reklamy, korzystając z ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i komunikaty towarzyszące, które są zwracane przez adapter Chartboost, gdy nie uda się wczytać 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 pasuje do rozmiaru banera obsługiwanego przez Chartboost.
102	Chartboost może wczytywać tylko 1 reklamę na lokalizację.
103	Parametry serwera Chartboost skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
104	Reklama pełnoekranowa lub reklama z nagrodą Chartboost nie jest gotowa do wyświetlenia.

Historia zmian w adapterze Chartboost Android Mediation