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

Z tego przewodnika dowiesz się, jak używać pakietu GMA Next-Gen SDK do wczytywania i wyświetlania reklam z Chartboost za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się z niego, jak dodać Chartboost do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Chartboost ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Android API na poziomie 24 lub wyższym.

Najnowsza wersja GMA Next-Gen SDK.
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie Chartboost

Zarejestruj się, aby utworzyć konto Chartboost, i zaloguj się, gdy zostanie ono zweryfikowane. Następnie przejdź na 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ć dodawanie aplikacji.

Formularz nowej aplikacji

Po utworzeniu aplikacji przekierujemy Cię do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Ustawienia aplikacji

Ad Manager wymaga identyfikatora użytkownika i podpisu użytkownika Chartboost, aby skonfigurować identyfikator jednostki reklamowej Ad Managera. Te parametry znajdziesz, klikając Chartboost mediation (Zapośredniczenie Chartboost) w interfejsie Chartboost.

Panel zapośredniczenia Chartboost

Otwórz kartę Resources > API Explorer (Zasoby > APIs Explorer) i zapisz swój identyfikator użytkownika oraz podpis użytkownika, które znajdziesz w sekcji Authentication (Uwierzytelnianie).

Chartboost API Explorer

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli 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 nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

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

Włączanie trybu testowego

Tryb testowy możesz włączyć w aplikacji, przechodząc do karty Zarządzanie aplikacjami w interfejsie Chartboost, wybierając aplikację z listy i klikając 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, używając utworzonego wcześniej identyfikatora jednostki reklamowej, i otrzymywać reklamy testowe Chartboost.

Gdy będziesz już otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w procesie sprawdzania aplikacji wydawcy Chartboost. Aby zarabianie na Chartboost działało, Chartboost musi zatwierdzić aplikację wydawcy.

Krok 2. Skonfiguruj oferty reklamowe 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 kliknij 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 dla 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średniczenie.

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 Typ 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 (Named Locations) 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 swojego interfejsu na potrzeby raportowania.

W interfejsie Chartboost miejsca docelowe reklam możesz wyświetlić na stronie Ustawienia podstawowe, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku Chartboost na temat nazwanych lokalizacji.

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 rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w artykułach Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z amerykańskimi przepisami stanowymi.

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

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

Kotlin

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

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.6.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.1.0'
}

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.
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. Wdróż ustawienia prywatności w pakiecie SDK Chartboost

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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.

Adapter Chartboost na Androida w wersji 9.13.0.0 lub nowszej automatycznie przekazuje do pakietu SDK Chartboost zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez pakiet SDK UMP i platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielenia dodatkowej zgody. Więcej informacji znajdziesz w artykule Metody ochrony prywatności w pakiecie SDK.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „sprzedającego”. Przewodnik po 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. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

W pakiecie SDK w wersji 8.1.0 firma Chartboost dodała metodę addDataUseConsent(). Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na wartość OPT_IN_SALE. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam 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 oraz wartości, które można podać w poszczególnych metodach, znajdziesz w artykule Chartboost na temat ustawy CCPA oraz w metodach Chartboost dotyczących prywatności na Androidzie.

Krok 5. Dodaj wymagany kod

Zmiany konfiguracji aktywności aktualizacji

Dodaj ten atrybut do każdej aktywności w pliku AndroidManifest.xml, która wyświetla reklamy Chartboost i obsługuje różne orientacje:

android:configChanges="keyboardHidden|orientation|screenSize"

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w usłudze Ad Manager i włączyć tryb testowy w interfejsie Chartboost.

Sprawdzanie reklam testowych

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

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ć błąd w odpowiedzi na reklamę, używając metody ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i towarzyszące im komunikaty, które adapter Chartboost wyświetla, 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ę naraz.
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 adaptera zapośredniczenia Chartboost na Androida