Integracja Maio z zapośredniczeniem

W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z mai. zapośredniczenie, integracje kaskadowe. Przewodnik zawiera informacje o dodawaniu pakietu maio do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera maio z aplikacjąiOS .

Interfejs panelu sterowania maio używa japońskich etykiet, przycisków i opisów, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku etykiety i przyciski są jednak opisane w języku angielskim. Na przykład „URL スキーム” to „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter pośrednictwa dla maio ma te możliwości:

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

Wymagania

  • docelowa wersja iOS 12.0 lub nowsza

Krok 1. Skonfiguruj konfiguracje w interfejsie maio

Najpierw zarejestruj się lub zaloguj się na konto maio. Na pasku bocznym po lewej stronie kliknij kolejno Zarządzanie aplikacjami i Nowa aplikacja.

Wybierz kartę odpowiadającą preferowanemu typowi reklamy.

Pełnoekranowa

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklama pełnoekranowa z wideo, a potem kliknij Zaktualizuj.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Nagrody za filmy, a następnie kliknij Zaktualizuj.

Na stronie Zarządzanie aplikacjami zanotuj identyfikator mediów. W następnej sekcji musisz skonfigurować jednostkę reklamową w usłudze Ad Manager.

Na stronie Zarządzanie strefami zanotuj identyfikator strefy. Potrzebny będzie też w przypadku konfigurowania jednostki reklamowej Ad Managera w następnym rozdziale.

(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora multimediówidentyfikatora strefy musisz podać identyfikator APIklucz API. Na stronie interfejsu API do raportowania zanotuj identyfikator APIklucz API.

Krok 2. Skonfiguruj zamówienia maio w interfejsie Ad Manager

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcji Zasoby reklamoweAplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w maio, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz maio, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator API oraz klucz API uzyskane w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako PlatformaAktywny jako Stan. Wpisz identyfikator multimediów i identyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

Krok 3. Importuj pakiet SDK i adapter maio

  • Dodaj ten wiersz do pliku Podfile projektu:

    pod 'GoogleMobileAdsMediationMaio'
    
  • W wierszu poleceń uruchom:

    pod install --repo-update

Integracja ręczna

  • Pobierz najnowszą wersję pakietu SDK Mapy Google.
  • Pobierz najnowszą wersję interfejsu maio za pomocą linku do pobrania w Changelogu i uwzględnij link maioAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją maia.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w Ad Managerze.

Wydawcy korzystający z wersji 7.26.0 lub nowszej pakietu SDK do reklam mobilnych Google będą automatycznie otrzymywać reklamy testowe z maiO na telefonach i tabletach zarejestrowanych jako urządzenia testowe podczas wysyłania żądań.

Weryfikowanie reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z maia, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z  GADResponseInfo.adNetworkInfoArray w tych klasach:

Format Nazwa zajęć
Pełnoekranowa GADMMaioInterstitialAdapter
Z nagrodą GADMMaioRewardedAdapter

Oto kody i odpowiednie komunikaty z adaptera maio, które pojawiają się, gdy nie udaje się załadować reklamy:

Kod błędu Przyczyna
0-10 maio zwrócił błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodach maio.
101 maio nie ma jeszcze reklamy.
102 nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
103 Adapter maio nie obsługuje żądanego formatu reklamy.
104 Reklama została już załadowana w przypadku tej konfiguracji sieci.

Historia zmian adaptera zapośredniczenia iOS (maio)

Wersja 2.1.5.1

  • Zaktualizowaliśmy komponent CFBundleShortVersionString, tak aby zawierał 3 elementy zamiast 4.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
  • Wersja pakietu SDK Maio: 2.1.5.

Wersja 2.1.5.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.5.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
  • Wersja pakietu SDK Maio: 2.1.5.

Wersja 2.1.4.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.4.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
  • Wersja pakietu SDK Maio: 2.1.4.

Wersja 2.1.3.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.3.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
  • Wersja pakietu SDK Maio: 2.1.3.

Wersja 2.1.2.1

  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
  • Uwzględnij Info.plist w ramach MaioAdapter.xcframework.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
  • Wersja pakietu SDK Maio: 2.1.2.

Wersja 2.1.2.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 2.1.2.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
  • Wersja pakietu SDK Maio: 2.1.2.

Wersja 2.1.1.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 2.1.1.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
  • Wersja pakietu SDK Maio: 2.1.1.

Wersja 2.0.0.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 2.0.0.
  • Usunięto zależność od MaioOB SDK.
  • Usunięto obsługę architektury armv7.
  • Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
  • Wersja pakietu SDK Maio: 2.0.0.

Wersja 1.6.3.1

  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
  • Wersja pakietu SDK Maio: 1.6.3.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.6.3.0

  • Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.3 i pakietem SDK maioOB w wersji 2.0.0-alpha.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.12.0.
  • Wersja pakietu SDK Maio: 1.6.3.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.6.2.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.2 i pakietem SDK maioOB w wersji 2.0.0-alpha.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
  • Pakiet SDK Maio w wersji 1.6.2.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.6.1.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.1 i pakietem SDK maioOB w wersji 2.0.0-alpha.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.2.0.
  • Wersja pakietu SDK Maio: 1.6.1.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.6.0.1

  • Wersja zweryfikowana pod kątem zgodności z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
  • Wersja pakietu SDK Maio: 1.6.0.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.6.0.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.6.0 i pakietem SDK maioOB w wersji 2.0.0-alpha.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • Teraz wymagana jest co najmniej wersja 10.0 systemu iOS.
  • Wersja pakietu SDK Maio: 1.6.0.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.5.8.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.8 i pakietem SDK maioOB w wersji 2.0.0-alpha.
  • Dodano do adaptera możliwość określania stawek w przypadku formatów reklam pełnoekranowych i reklam z nagrodą.
  • Zmniejszona zależność od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.7.0.
  • Wersja pakietu SDK Maio: 1.5.8.
  • Pakiet SDK MaioOB w wersji 2.0.0-alpha.

Wersja 1.5.6.1

  • Dodano standardowe kody błędów i komunikaty dotyczące adaptera.
  • Zaktualizowano adapter, aby używał formatu .xcframework.
  • Naprawiliśmy błąd, który powodował, że czasami nie były przesyłane zdarzenia związane z reklamami z nagrodą.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.3.0.
  • Wersja pakietu SDK Maio: 1.5.6.

Wersja 1.5.6.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.6.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.68.0.
  • Wersja pakietu SDK Maio: 1.5.6.

Wersja 1.5.5.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.5.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.64.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.64.0.
  • Wersja pakietu SDK Maio: 1.5.5.

Wersja 1.5.4.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.4.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.60.0.
  • Wersja pakietu SDK Maio: 1.5.4.

Wersja 1.5.3.1

  • Aby ograniczyć limity czasu, żądania reklamy będą się teraz natychmiast kończyć niepowodzeniem, jeśli maio nie ma reklamy gotowej do wyświetlenia.
  • Wycofano obsługę architektury i386.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
  • Wersja pakietu SDK Maio: 1.5.3.

Wersja 1.5.3.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.3.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.55.1.
  • Wersja pakietu SDK Maio: 1.5.3.

Wersja 1.5.2.1

  • Rozwiązaliśmy problem, który powodował, że adapter nie wywoływał funkcji zwracającej wywołanie zwrotne -rewardedAdDidPresent:.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
  • Pakiet SDK Maio w wersji 1.5.2.

Wersja 1.5.2.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.2.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.53.1.
  • Pakiet SDK Maio w wersji 1.5.2.

Wersja 1.5.1.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.1.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
  • Wersja pakietu SDK Maio: 1.5.1.

Wersja 1.5.0.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.5.0.

Został opracowany i przetestowany z użyciem

  • Pakiet SDK do reklam mobilnych Google w wersji 7.51.0.
  • Pakiet SDK Maio Ads w wersji 1.5.0.

Wersja 1.4.8.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.8.

Wersja 1.4.6.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.6.
  • Zaktualizowano adapter, aby korzystał z nowego interfejsu API nagród.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.

Wersja 1.4.2.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.2.

Wersja 1.4.1.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.1.
  • Rozwiązaliśmy problem, który powodował, że adapter maio mógł nie działać, jeśli z AdMob otrzymano wiele identyfikatorów MediaId.

Wersja 1.4.0.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.4.0.

Wersja 1.3.2.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.2.

Wersja 1.3.1.1

  • Dodano do adaptera wywołanie zwrotne adapterDidCompletePlayingRewardBasedVideoAd:.

Wersja 1.3.1.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.1.

Wersja 1.3.0.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.3.0.

Wersja 1.2.19.0

  • Weryfikowana zgodność z pakietem SDK maio w wersji 1.2.19.

Wersja 1.2.18.0

  • Pierwsza wersja
  • Dodaliśmy obsługę reklam pełnoekranowych i reklam wideo z nagrodą.