Integracja Chartboost z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Chartboost przy użyciu mediacji, obejmującej integracje kaskadowe. Pokazuje on, jak dodać Chartboost do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboost z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

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

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Aby wdrożyć na Androidzie:
  • Android API na poziomie 21 lub wyższym
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS: 12.0 lub nowsza,
• działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
• Przejdź przez proces zapośredniczenia: Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie Chartboost

Zarejestruj się na koncie Chartboost i zaloguj się, 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ć proces.

Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Aby skonfigurować identyfikator jednostki reklamowej AdMob, musisz podać identyfikator użytkownika i podpis użytkownika z serwisu Chartboost. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.

Otwórz kartę Zasoby > Eksplorer interfejsu API i zapisz identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.

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.

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

Gdy tryb testowy zostanie włączony, możesz żądać reklam za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymać reklamę testową Chartboost.

Gdy będziesz już otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w sprawdzaniu aplikacji wydawcy Chartboost. Aby można było z niej korzystać, wydawca musi ją przesłać do sprawdzenia i otrzymać zgodę Chartboost.

Krok 2. Skonfiguruj zapotrzebowanie na reklamy Chartboost w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

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 RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

Integracja za pomocą pub.dev

Dodaj w pliku pubspec.yaml pakietu te zależności z najnowszymi wersjami pakietu SDK i adaptera Chartboost:

dependencies:
  gma_mediation_chartboost: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki pośredniczącej reklam mobilnych Google dla Chartboost, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

Krok 4. Wprowadź 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 zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka zapośredniczenia reklam mobilnych Google do Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent(). Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na NonBehavioral. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na sprzedawcę obowiązek zapewnienia użytkownikom możliwości rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej „sprzedawcy” należy umieścić dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zachować zgodność.

Wtyczka do zapośredniczenia reklam mobilnych Google dla Chartboost w wersji 3.1.0 zawiera metodę Chartboost.AddDataUseConsent(). Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na OptInSale. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

Krok 5. Dodaj wymagany kod

Krok 6. Przetestuj implementację

Włączanie reklam testowych

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

Weryfikacja reklam testowych

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

Kroki opcjonalne

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z Chartboost, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z ResponseInfo w ramach tych klas:

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

GADMAdapterChartboost
GADMediationAdapterChartboost

Oto kody i odpowiednie komunikaty zwracane przez adapter Chartboost, gdy nie udaje się załadować reklamy:

Historia zmian adaptera do zapośredniczenia reklam w Flutterze firmy Chartboost

1.0.0

• Pierwsza wersja.
• Weryfikowana zgodność z adapterem Chartboost na Androida w wersji 9.8.1.0
• Weryfikowana zgodność z adapterem Chartboost na iOS w wersji 9.8.0.0
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.