Integracja InMobi z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z InMobi przy użyciu mediacji. Obejmuje on integrację z systemem licytowania i metodą kaskadową. W tym artykule znajdziesz informacje o tym, jak dodać InMobi do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter InMobi z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

¹ Integracja określania stawek jest w wersji beta dostępnej publicznie.

² Tylko w przypadku zapośredniczenia kaskadowego.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• [Dla określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj wtyczki Google Mobile Ads do zapośredniczenia w InMobi w wersji 4.5.0 lub nowszej (zalecana najnowsza wersja).
• Aby wdrożyć na Androidzie:
  • poziom interfejsu API 21 lub nowszy,
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS: 10.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, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie InMobi

Zarejestruj się na konto InMobi. Podczas tworzenia konta pozostaw odznaczoną opcję Użyj SSP InMobi z Otwartym ustalaniem stawek Google.

Gdy Twoje konto zostanie zweryfikowane, zaloguj się.

Dodaj aplikację

Aby dodać aplikację do panelu InMobi, kliknij Zasoby reklamowe > Zasoby reklamoweUstawienia.

Kliknij Dodaj zasoby i w menu wybierz kanał Aplikacja mobilna.

Zacznij wpisywać adres URL opublikowanej aplikacji w pasku wyszukiwania i wybierz ją z automatycznie wypełnionych wyników. Kliknij Dalej.

Jeśli aplikacja nie jest opublikowana, kliknij Połącz ręcznie i wpisz wymagane dane. Kliknij Dalej.

Sprawdź ustawienia Zgodność z aplikacjami i witrynami, a potem kliknij Zapisz i utwórz miejsca docelowe.

Miejsca docelowe

Po skonfigurowaniu zasobów reklamowych system przekieruje Cię do procesu tworzenia miejsca docelowo-wych.

Po utworzeniu miejsca docelowego wyświetlają się jego szczegóły. Zapisz identyfikator miejsca docelowego, który posłuży Ci do skonfigurowania jednostki reklamowej AdMob.

Identyfikator konta

Identyfikator konta InMobi znajdziesz w sekcji Finansowanie > Ustawienia płatności > Informacje o płatnościach.

Znajdowanie klucza interfejsu API InMobi do raportowania

Włączanie trybu testowego

Włącz tryb testowy dla swojej lokalizacji we wszystkich aktywnych wyświetleniach lub tylko na określonych urządzeniach testowych.

Krok 2. Skonfiguruj zapotrzebowanie InMobi w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Dodawanie InMobi do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać InMobi do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w ustawieniach dotyczących RODO i amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter InMobi

Integracja przez pub.dev

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do pośredniczenia reklam mobilnych Google dla InMobi, 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_inmobi:
    path: path/to/local/package

Krok 4. Wprowadź ustawienia prywatności w pakiecie InMobi SDK

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 dla InMobi nie obsługuje przekazywania informacji o zgodzie do pakietu SDK InMobi.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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 zapewnić zgodność.

Wtyczka zapośredniczenia reklam mobilnych Google dla InMobi nie obsługuje przekazywania informacji o zgodzie do pakietu SDK InMobi.

Krok 5. Dodaj wymagany dodatkowy kod

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie InMobi.

Weryfikowanie reklam testowych

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

Kroki opcjonalne:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Kody błędów

Jeśli adapter nie otrzyma reklamy z InMobi, wydawcy mogą sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z metody ResponseInfo w tych klasach:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

GADMAdapterInMobi
GADMediationAdapterInMobi

Oto kody i odpowiednie komunikaty z adaptera InMobi, które są wyświetlane, gdy nie udaje się załadować reklamy:

Historia zmian adaptera zapośredniczenia InMobi Flutter

Następna wersja

• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

• Weryfikowana zgodność z adapterem InMobi na Androida w wersji 10.7.5.0.
• Weryfikowana zgodność z adapterem InMobi na iOS w wersji 10.7.5.0.
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.0.0

• Pierwsza wersja.
• Weryfikowana zgodność z adapterem InMobi na Androida w wersji 10.6.7.1.
• Weryfikowana zgodność z adapterem InMobi na iOS w wersji 10.7.2.0.
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.