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

Integracja Chartboost z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Chartboost wykorzystujące mediacji, na temat integracji kaskadowych. Omawiamy sposób dodawania Chartboost do konfiguracji zapośredniczenia oraz integracji pakietu SDK Chartboost i adaptera do aplikacji Android .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Chartboost ma te funkcje:

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

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ 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: 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 elementy zależności i konfiguracje wdrożenia. Użyj najnowszych wersji Pakiet SDK i adapter 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 .aar najnowszej wersji Chartboost SDK od Maven Central i dodaj je do projektu.
Przejdź do artefaktów adaptera Chartboost w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz Chartboost .aar adaptera i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

W pakiecie SDK w wersji 8.1.0 platforma Chartboost dodała metodę addDataUseConsent(). ten przykładowy kod ustawia NON_BEHAVIORAL zgody na korzystanie z danych. Jeśli wybierzesz możesz wywołać tę metodę, zrób 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)

Zobacz: Chartboost artykule o RODO i ich Metody ochrony prywatności na Androidzie .

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.

W pakiecie SDK w wersji 8.1.0 platforma Chartboost dodała metodę addDataUseConsent(). ten przykładowy kod ustawia OPT_IN_SALE zgody na korzystanie z danych. Jeśli wybierzesz należy wywołać tę metodę, należy to zrobić 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)

Zobacz: Chartboost Artykuł na temat ustawy CCPA i ich Metody ochrony prywatności na Androidzie .

Krok 5. Dodaj wymagany kod

Zmodyfikuj AndroidManifest

Inne elementy

Dodaj ten atrybut do każdej aktywności w AndroidManifest.xml który będzie wyświetlać reklamy Chartboost w różnych orientacjach:

android:configChanges="keyboardHidden|orientation|screenSize"

Zdarzenia cyklu życia

Zgodnie z zaleceniem Chartboost dodaj następujący kod do wszystkich zdarzenia cyklu życia aktywności, które będą powodować wyświetlanie reklam 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ą skuteczność, Chartboost zaleca dodanie następujących uprawnienia do pliku AndroidManifest.xml Twojej aplikacji:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Kody błędów

Jeśli adapter nie odbierze reklamy z Chartboost, możesz sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

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 nie można wczytać reklamy:

Kod błędu	Przyczyna
0-99	Pakiet Chartboost SDK zwrócił komunikat o błędzie. Zobacz dokumentację 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. Zobacz kod .
300-399	Pakiet Chartboost SDK wyświetla błędy. Zobacz kod .
400-499	Błędy kliknięć pakietu Chartboost SDK. Zobacz kod .