Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z i-mobile za pomocą zapośredniczenia, co obejmuje integracje kaskadowe. Dowiesz się, jak dodać i-mobile do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Flutter.

Interfejs panelu i-mobile zawiera etykiety, przyciski i opisy w języku japońskim. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak przetłumaczone, a ich angielskie odpowiedniki podano w nawiasach.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Managera dla i-mobile ma te możliwości:

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Najnowsza wersja Google Mobile Ads Flutter Plugin.
• Flutter w wersji 3.7.0 lub nowszej.
• To deploy on Android
  • Android z interfejsem API na poziomie 24 lub wyższym.
• Aby wdrożyć na iOS:
  • iOS w wersji 13.0 lub nowszej.
• Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Szczegółowe informacje znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj się na konto i-mobile.

Dodaj aplikację do panelu i-mobile, klikając kartę サイト／アプリ管理 (Zarządzanie witryną/aplikacją) i przycisk platformy aplikacji.

Wypełnij formularz i kliknij przycisk 新規登録 (Zarejestruj się).

Aby utworzyć nowe miejsce reklamowe, wybierz aplikację na karcie サイト／アプリ管理 (Zarządzanie witryną/aplikacją).

Otwórz kartę 広告スポット管理 (Zarządzanie miejscami wyświetlania reklam) i kliknij przycisk 新規広告スポット (Nowe miejsce wyświetlania reklamy).

Następnie wypełnij formularz, podając 広告スポット名 (nazwę miejsca wyświetlania reklamy), 広告スポットサイズ (rozmiar miejsca wyświetlania reklamy) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Zarejestruj się).

Nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Pobierz ustawienia aplikacji).

Zanotuj パブリッシャーID (identyfikator wydawcy), メディアID (identyfikator multimediów) i スポットID (Spot ID). Te parametry będą potrzebne później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie Ad Managera.

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 i-mobile, zapoznaj się z najczęstszymi pytaniami.

Krok 2. Skonfiguruj oferty reklamowe i-mobile w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Krok 3. Zaimportuj pakiet SDK i adapter i-mobile

Integracja przez pub.dev

(Tylko Android) Dodaj te repozytoria do pliku build.gradle w katalogu android projektu:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

Dodaj do pliku pubspec.yaml pakietu tę zależność z najnowszymi wersjami pakietu SDK i adaptera i-mobile:

dependencies:
  gma_mediation_imobile: ^1.0.6

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla i-mobile, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z zawartością) do projektu Flutter. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

Krok 4. Wymagany dodatkowy kod

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager. i-mobile udostępnia testowe wartości Spot ID, Media ID i Publisher ID, które znajdziesz tutaj.

Sprawdzanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z i-mobile, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, korzystając z ResponseInfo w tych klasach:

Oto kody i powiązane z nimi komunikaty, które adapter i-mobile wyświetla, gdy nie uda się wczytać reklamy:

Historia zmian adaptera zapośredniczenia i-mobile do Fluttera

Wersja 1.0.6

• Dodaliśmy obsługę adaptera i-mobile na Androida w wersji 2.3.2.5.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.8.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.

Wersja 1.0.5

• Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 9.1.0.
• Dodaliśmy obsługę Swift Package Managera.
• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.4.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.8.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.

Wersja 1.0.4

• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.3.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.7.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.0.3

• Zaktualizowano minimalną wersję Fluttera do 3.38.1.
• Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 8.0.0.
• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.3.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.6.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.0.2

• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.1.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.3.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.1

• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.1.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.2.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.0.0

• Pierwsza wersja.
• Obsługuje adapter i-mobile na Androida w wersji 2.3.2.0.
• Obsługuje adapter i-mobile na iOS w wersji 2.3.4.1.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.