Integracja Chartboost z zapośredniczeniem

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z Chartboost za pomocą zapośredniczenia, w tym integracji kaskadowych. Dowiesz się, 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 dla Chartboost ma te możliwości:

Wymagania

• Android API w wersji 24 lub nowszej

• Najnowszy 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ę w Chartboost i zaloguj, gdy Twoje konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.

Aby utworzyć aplikację, kliknij przycisk Dodaj nową aplikację.

Wypełnij resztę formularza i kliknij przycisk Dodaj aplikację , aby zakończyć tworzenie aplikacji.

Po utworzeniu aplikacji nastąpi przekierowanie do jej panelu. Zanotuj identyfikator aplikacji i sygnaturę aplikacji.

Do skonfigurowania identyfikatora jednostki reklamowej Ad Managera wymagany jest identyfikator użytkownika i sygnatura użytkownika Chartboost. Te parametry znajdziesz, klikając Zapośredniczenie Chartboost w interfejsie Chartboost.

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

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 utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, utwórz plik app-ads.txt dla Ad Managera.

Aby zaimplementować app-ads.txt w Chartboost, zapoznaj się z artykułem app-ads.txt.

Włącz tryb testowy

Tryb testowy możesz włączyć w aplikacji, otwierając kartę Zarządzanie aplikacjami w interfejsie Chartboost, wybierając aplikację z listy i klikając Edytuj ustawienia aplikacji.

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

Gdy tryb testowy jest włączony, możesz poprosić o reklamy, używając utworzonego wcześniej identyfikatora jednostki reklamowej, i otrzymywać reklamy testowe Chartboost.

Gdy zaczniesz otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w sekcji sprawdzania aplikacji wydawcy w Chartboost. Aby zarabianie w Chartboost działało, aplikacja wydawcy musi zostać zatwierdzona przez Chartboost.

Krok 2. Skonfiguruj popyt Chartboost w interfejsie Ad Managera

Skonfiguruj ustawienia 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 dla Chartboost, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamową wybierz Chartboost, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz automatyczne zbieranie danych i wpisz identyfikator użytkownika oraz sygnaturę użytkownika uzyskane w poprzedniej sekcji.

Gdy wybierzesz partnera zysku, jako rodzaj integracji wybierz Zapośredniczenie mobilne SDK, jako platformę – Android, a jako stan – Aktywny. Wpisz identyfikator aplikacji, sygnaturę aplikacji i lokalizację reklamy uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Lokalizacje reklam Chartboost (lokalizacje nazwane) to proste nazwy reprezentujące miejsce w aplikacji, w którym chcesz wyświetlać reklamy. 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 lokalizacje reklam można wyświetlić na stronie Ustawienia podstawowe, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku po Chartboost nazwanych lokalizacjach.

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

Dodaj 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 przepisami stanowymi w USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

Integracja z Androidem Studio (zalecane)

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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.11.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")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:chartboost:9.11.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

1. Pobierz plik .aar najnowszej wersji pakietu SDK Chartboost z Maven Central i dodaj go do projektu.

2. Otwórz artefakty adaptera Chartboost w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera Chartboost i dodaj go do projektu.

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK Chartboost

Zgoda użytkownika z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji swoim użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskiwać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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ć wyboru zgody użytkownika do takich sieci.

W pakiecie SDK w wersji 8.1.0 Chartboost dodał metodę addDataUseConsent(). Ten 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ą GMA Next-Gen SDK.

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Więcej informacji oraz wartości, które można podać w każdej metodzie, znajdziesz w artykule Chartboost dotyczącym RODO i w ich metodach prywatności na Androidzie.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (definicje poszczególnych terminów zostały określone 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 „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 z instrukcjami każdej z tych sieci, aby zapewnić zgodność.

W pakiecie SDK w wersji 8.1.0 Chartboost dodał metodę addDataUseConsent(). Ten 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ą GMA Next-Gen SDK.

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

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 każdej metodzie, znajdziesz w artykule Chartboost dotyczącym CCPA i w ich metodach prywatności na Androidzie.

Krok 5. Dodaj wymagany kod

Zaktualizuj zmiany konfiguracji aktywności

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łącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze i włącz tryb testowy w interfejsie Chartboost.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z Chartboost, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając Chartboost (wodospad) źródła lub źródeł reklam.

Kroki opcjonalne:

Uprawnienia

Aby zapewnić optymalną skuteczność, Chartboost zaleca dodanie tych opcjonalnych uprawnień do pliku AndroidManifest.xml aplikacji:

<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, używając ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i towarzyszące im komunikaty zwracane przez adapter Chartboost, gdy nie uda się wczytać reklamy: