Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z maio przy użyciu mediacji, a także jak przeprowadzać integrację kaskadową. Wyjaśnia, jak dodać maio do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacją na iOS.

Interfejs panelu platformy maio używa tekstu w języku japońskim w przypadku 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 podawane w języku angielskim. „URL スキーム” to na przykład „URL Scheme”.

Obsługiwane integracje i formaty reklam

Adapter do mediacji w przypadku maio ma te możliwości:

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

Wymagania

  • iOS w wersji 12.0 lub nowszej

Krok 1. Skonfiguruj ustawienia w interfejsie maio

Najpierw zarejestruj się lub zaloguj na konto maio. Na pasku bocznym po lewej stronie kliknij przycisk Zarządzanie aplikacjami, a następnie 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 wideo, a następnie kliknij Aktualizuj.

Z nagrodą

Wpisz nazwę aplikacji, wybierz platformę i podaj adres URL aplikacji. Jako Typ reklamy wybierz Reklamy wideo z nagrodą, a następnie kliknij Aktualizuj.

Na stronie Application Management (Zarządzanie aplikacjami) zanotuj Media ID (Identyfikator multimediów). Jest on potrzebny do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

Na stronie Zarządzanie strefami zanotuj Identyfikator strefy. Będzie ona też potrzebna do skonfigurowania jednostki reklamowej Ad Managera w następnej sekcji.

(Tylko kaskadowe) Oprócz identyfikatora multimediówidentyfikatora strefy do skonfigurowania identyfikatora jednostki reklamowej na potrzeby zapośredniczenia potrzebne będą identyfikator interfejsu APIKLUCZ INTERFEJSU API. Na stronie interfejsu API do raportowania zanotuj identyfikator APIklucz API.

Krok 2. Skonfiguruj popyt na platformie maio w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Wyświetlanie > Grupy zysku i przycisk Nowa grupa zysku.

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

Następnie kliknij przycisk Dodaj partnera zysku.

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

Wybierz maio jako sieć reklamową, wpisz unikalną nazwę i włącz zapośredniczanie.

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 Rodzaj integracji, iOS jako PlatformęAktywny jako Stan. Wpisz identyfikator multimediówidentyfikator strefy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślna stawka CPM.

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

Krok 3. Zaimportuj pakiet SDK i adapter maio

  • Dodaj do pliku Podfile projektu ten wiersz:

    pod 'GoogleMobileAdsMediationMaio'
    
  • W wierszu poleceń uruchom:

    pod install --repo-update

Integracja ręczna

  • Pobierz najnowszą wersję pakietu SDK maio.
  • Pobierz najnowszą wersję adaptera maio, korzystając z linku do pobierania w dzienniku zmian, i połącz maioAdapter.framework w projekcie.

Krok 4. Dodaj wymagany kod

Integracja z SKAdNetwork

Postępuj zgodnie z dokumentacją maio, 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 Ad Managerze.

Wydawcy korzystający z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej będą automatycznie otrzymywać z maio reklamy testowe 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 w inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła reklam maio (kaskadowe).

Kody błędów

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

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

Oto kody i komunikaty, które są zwracane przez adapter maio, gdy nie uda się wczytać reklamy:

Kod błędu Przyczyna
0-10 maio zwrócił błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w kodzie usługi maio.
101 maio nie ma jeszcze dostępnej reklamy.
102 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
103 Adapter maio nie obsługuje formatu reklamy, o który wysłano żądanie.
104 Reklama jest już wczytana w przypadku tej konfiguracji sieci.

Historia zmian adaptera zapośredniczenia maio na iOS

Następna wersja

  • Włącz opcje -fobjc-arc i -fstack-protector-all.

Wersja 2.1.6.1

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

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
  • Maio SDK w wersji 2.1.6.

Wersja 2.1.6.0

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

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.13.0.
  • Maio SDK w wersji 2.1.6.

Wersja 2.1.5.1

  • Zaktualizowano CFBundleShortVersionString, aby zawierał 3 komponenty zamiast 4.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.1.5.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.1.4.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.1.3.0

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

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
  • Maio SDK w wersji 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 platformach w ramach MaioAdapter.xcframework.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.1.2.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.1.1.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 2.0.0.0

  • Sprawdzona zgodność z pakietem SDK maio w wersji 2.0.0.
  • Usunięto zależność od MaioOB SDK.
  • Usunięto obsługę architektury armv7.
  • Teraz wymaga minimalnej wersji iOS 12.0.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.3.1

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.3.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.2.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.1.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.0.1

  • Sprawdzona zgodność 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.6.0.0

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

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • Teraz wymaga minimalnej wersji iOS 10.0.
  • Maio SDK w wersji 1.6.0.
  • MaioOB SDK w wersji 2.0.0-alpha.

Wersja 1.5.8.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.6.1

  • Dodano standardowe kody błędów i komunikaty o błędach dotyczące adapterów.
  • Zaktualizowano adapter, aby używał formatu .xcframework.
  • Naprawiliśmy błąd, który powodował, że czasami nie przekazywano zdarzeń związanych z reklamami z nagrodą.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.6.0

  • Zweryfikowana 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.5.0

  • Zweryfikowana 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.4.0

  • Zweryfikowana 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.3.1

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.3.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.2.1

  • Rozwiązaliśmy problem polegający na tym, że adapter nie wywoływał wywołania zwrotnego -rewardedAdDidPresent:.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.2.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.1.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 1.5.0.0

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

Zaprojektowano i przetestowano z użyciem

  • Pakiet SDK do reklam mobilnych Google w wersji 7.51.0.
  • Pakiet SDK do wyświetlania reklam Maio w wersji 1.5.0.

Wersja 1.4.8.0

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

Wersja 1.4.6.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.6.
  • Zaktualizowaliśmy adapter, aby korzystał z nowego interfejsu API reklam z nagrodą.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.

Wersja 1.4.2.0

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

Wersja 1.4.1.0

  • Zweryfikowana zgodność z pakietem SDK maio w wersji 1.4.1.
  • Rozwiązaliśmy problem, który powodował, że adapter maio mógł ulec awarii, jeśli z AdMob otrzymywano wiele identyfikatorów multimediów.

Wersja 1.4.0.0

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

Wersja 1.3.2.0

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

Wersja 1.3.1.1

  • Dodano wywołanie zwrotne adapterDidCompletePlayingRewardBasedVideoAd: do adaptera.

Wersja 1.3.1.0

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

Wersja 1.3.0.0

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

Wersja 1.2.19.0

  • Sprawdzona 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ą.