Integracja i-mobile z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google 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 przypadku etykiet, przycisków i opisów. 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:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 lub nowszej
  • Wdrażanie na Androidzie
    • Android API na poziomie 23 lub wyższym
  • Wdrażanie na iOS
    • iOS w wersji 12.0 lub nowszej
  • Działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie i-mobile

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

Następnie wypełnij formularz, podając 広告スポット名 (nazwę boksu reklamowego), 広告スポットサイズ (rozmiar boksu reklamowego) i inne szczegóły. Następnie kliknij przycisk 新規登録 (Sign up).

new_ad_spot_form

Nowe miejsce na reklamę jest gotowe. Aby wyświetlić szczegóły integracji, kliknij przycisk アプリ設定取得 (Get App settings).

ad_spot_list

Zanotuj パブリッシャーID (Publisher ID), メディアID (Media ID) i スポットID (Spot ID). Będziesz ich potrzebować później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie AdMob.

Android

iOS

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (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, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt dla swojej 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

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

Krok 3. Zaimportuj pakiet SDK i-mobile i adapter

Integracja za pomocą pub.dev

Dodaj w pliku pubspec.yaml pakietu to zależności z najnowszymi wersjami pakietu SDK i-mobile oraz adaptera:

dependencies:
  gma_mediation_imobile: ^

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

Android

Integracja z i-mobile nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją i-mobile, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob. i-mobile udostępnia testowe identyfikatory Spota, identyfikatory multimedió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 reklamę, korzystając z ResponseInfo w tych klasach:

Android

Format Nazwa zajęć
Baner com.google.ads.mediation.imobile.IMobileAdapter
Pełnoekranowa com.google.ads.mediation.imobile.IMobileAdapter
Natywna com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Format Nazwa zajęć
Baner IMobileAdapter
Pełnoekranowa IMobileAdapter
Natywna GADMediationAdapterIMobile

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

Android

Kod błędu Przyczyna
0-99 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w sekcji kod.
101 i-mobile wymaga kontekstu Activity, aby wczytywać reklamy.
102 Parametry serwera i-mobile skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
103 Rozmiar żądanej reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
104 Wywołanie zwrotne dotyczące wczytywania reklam natywnych i-mobile zwróciło pustą listę reklam natywnych.

iOS

Kod błędu Przyczyna
0-10 Pakiet SDK i-mobile zwrócił błąd. Więcej informacji znajdziesz w kodzie.
101 Parametry serwera i-mobile skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102 Rozmiar żądanej reklamy nie pasuje do rozmiaru banera obsługiwanego przez i-mobile.
103 Nie udało się wyświetlić reklamy na urządzeniu i-mobile.
104 i-mobile zwrócił pustą tablicę reklam natywnych.
105 Nie udało się pobrać komponentów reklamy natywnej z i-mobile.
106 i-mobile nie obsługuje wysyłania żądań dotyczących wielu reklam pełnoekranowych przy użyciu tego samego identyfikatora miejsca docelowego.

Historia zmian adaptera i-mobile Flutter Mediation

Wersja 1.0.1

Wersja 1.0.0