Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Flutter Plugin wczytywać i wyświetlać reklamy z i-mobile przy użyciu mediacji, w tym integracji kaskadowych. Wyjaśniamy w nim, jak dodać i-mobile do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter i-mobile z aplikacją Flutter.

Interfejs panelu i-mobile używa japońskiego tekstu w etykietach, przyciskach i opisach. Zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak tłumaczone, a w nawiasach podawane są ich angielskie odpowiedniki.

Obsługiwane integracje i formaty reklam

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

• Najnowsza wersja Google Mobile Ads Flutter Plugin.
• platformy Flutter w wersji 3.7.0 lub nowszej,
• Wdrażanie na Androidzie
  • Android w wersji API 24 lub nowszej.
• Wdrażanie na iOS
  • iOS w wersji 13.0 lub nowszej.
• działający projekt Fluttera skonfigurowany za pomocą Google Mobile Ads Flutter Plugin; Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
• Skonfiguruj zapośredniczenie AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

Zarejestruj się lub zaloguj na konto i-mobile.

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

Wypełnij formularz i kliknij przycisk 新規登録 (Sign up).

Aby utworzyć nowe miejsce reklamowe, wybierz aplikację na karcie Zarządzanie witrynami/aplikacjami.

Otwórz kartę 広告スポット管理 (Ad Spot Management) i kliknij przycisk 新規広告スポット (New Ad Spot).

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 新規登録 (Sign up).

Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Get App settings).

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 mediacji w interfejsie AdMob.

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps 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 tego nie zrobiono, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby wdrożyć app-ads.txt w przypadku i-mobile, zapoznaj się z odpowiedziami na najczęstsze pytania.

Krok 2. Skonfiguruj popyt i-mobile w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Krok 3. Zaimportuj pakiet SDK i-mobile i adapter

Integracja za pomocą 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 i-mobile SDK i adaptera:

dependencies:
  gma_mediation_imobile: ^1.0.6

Integracja ręczna

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

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

Krok 4. Wymagany jest dodatkowy kod

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob. i-mobile udostępnia testowe identyfikatory miejsca, identyfikatory mediów i identyfikatory wydawcy. Możesz je znaleźć tutaj.

Weryfikowanie reklam testowych

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

Kody błędów

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

Oto kody i komunikaty wyświetlane przez adapter i-mobile, gdy nie uda się wczytać reklamy:

Historia zmian adaptera i-mobile do mediacji w Flutterze

Wersja 1.0.6

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

Wersja 1.0.5

• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.
• Dodano obsługę Swift Package Manager.
• Obsługuje adapter i-mobile Android w wersji 2.3.2.4.
• Obsługuje adapter i-mobile iOS w wersji 2.3.4.8.
• Zbudowano i przetestowano za pomocą 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 przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.0.3

• Zaktualizowano minimalną wersję Fluttera do 3.38.1
• Zaktualizowano obsługę wtyczki 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 przy użyciu 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 iOS w wersji 2.3.4.3.
• Zbudowano i przetestowano przy użyciu 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 przy użyciu 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.