Integracja Maio z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z witryny Maio za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać maio do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter maio z aplikacjąiOS .

Etykiety, przyciski i opisy w interfejsie panelu maio w języku japońskim, a zrzuty ekranu w tym przewodniku nie zostały przetłumaczone. W opisach i instrukcjach w tym przewodniku odniesienia do etykiet i przycisków odnoszą się jednak do ich angielskich odpowiedników. np. „URL” („Schemat URL”) i tak dalej.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager dla Maio udostępnia te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

  • Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej

  • Najnowszy pakiet SDK do reklam mobilnych Google

  • Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie maio

Najpierw zarejestruj się lub zaloguj na swoje konto maio. Kliknij przycisk Zarządzanie aplikacjami na lewym pasku bocznym i wybierz Nowa aplikacja.

Wybierz kartę odpowiadającą Twojemu preferowanemu Typowi reklamy.

Pełnoekranowa

Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Pełnoekranowa reklama wideo i kliknij Zaktualizuj.

Otrzymano

Wpisz nazwę swojej aplikacji, wybierz platformę i podaj URL aplikacji. Jako Typ reklamy wybierz Nagrody wideo i kliknij Zaktualizuj.

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

Na stronie Zone Management (Zarządzanie strefą) zanotuj Identyfikator strefy. W następnej sekcji musisz też skonfigurować Ad Manager jednostkę reklamową.

(Tylko kaskada) Aby skonfigurować identyfikator jednostki reklamowej na potrzeby zapośredniczenia, oprócz identyfikatora mediów i identyfikatora strefy będziesz potrzebować identyfikatora interfejsu API i klucza interfejsu API. Na stronie interfejsu API do raportowania zanotuj Identyfikator interfejsu API i KLUCZ API.

Krok 2. Skonfiguruj popyt na Maio w Ad Manager interfejsie użytkownika

Zaloguj się na konto Ad Managera.

Dodaj maio do firm

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Przejdź do sekcji Administracja > Firmy i kliknij przycisk Nowa firma na karcie Wszystkie firmy. Kliknij Sieć reklamowa.

Jako Sieć reklamowa wybierz maio, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie. Włącz Automatyczne zbieranie danych i wpisz API ID and API KEY uzyskane w poprzedniej sekcji.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włącz udostępnianie bezpiecznych sygnałów

Ustalanie stawek

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Save (Zapisz).

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj maio określanie stawek

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący, a potem na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz maio.

Przesuń przełącznik obok opcji Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj mapowanie jednostki reklamowej

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę, dla której chcesz utworzyćmaio .

Otwórz kartę Mapowanie jednostki reklamowej i kliknij Nowe mapowanie jednostek reklamowych.

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna i kliknij Aplikacja mobilna. Następnie wpiszPublisher ID otrzymane w poprzedniej sekcji. Na koniec kliknij Zapisz.

Wodospad

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę, dla której utworzyliśmy maio w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, iOS jako Platformę i Aktywne jako Stan.

Wpisz wartość Media ID and Zone IDuzyskaną w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy tylko obliczysz eCPM, jest on automatycznie aktualizowany w Twoim imieniu.

Krok 3. Zaimportuj pakiet SDK i adapter maio

  • Dodaj ten wiersz do pliku Podfile projektu:

    pod 'GoogleMobileAdsMediationMaio'

  • W wierszu poleceń:

    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 historii zmian, i połącz maioAdapter.framework w swoim projekcie.

Krok 4. Dodaj wymagany kod

Integracja SKAdNetwork

Wykonaj dokumentację maio, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager.

Wydawcy, którzy korzystają z pakietu SDK do reklam mobilnych Google w wersji 7.26.0 lub nowszej, automatycznie będą otrzymywać w żądaniach reklamy testowe z Maio na telefony i tablety zarejestrowane jako urządzenia testowe.

Weryfikacja reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z maio, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu GADResponseInfo.adNetworkInfoArray w tych zajęciach:

Format Nazwa zajęć
Pełnoekranowa GADMMaioInterstitialAdapter
Otrzymano GADMMaioRewardedAdapter

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter maio, gdy nie można wczytać reklamy:

Kod błędu Przyczyna
0-10 maio zwróciło błąd związany z pakietem SDK. Więcej informacji znajdziesz w code i dokumentacji maio.
101 Maio nie ma dostępnej reklamy.
102 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
103 Kontekst użyty do wczytania reklamy nie był instancją „Activity”.
0-10 maio zwróciło błąd związany z pakietem SDK. Więcej informacji znajdziesz w kodzie 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 żądanego formatu reklamy.
104 Reklama dla tej konfiguracji sieci została już wczytana.

Historia zmian adaptera zapośredniczenia na iOS maio

Wersja 2.1.3.0

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

Stworzone i przetestowane w:

  • 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ędniono Info.plist w ramach platformy MaioAdapter.xcframework.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 2.1.2.

Stworzone i przetestowane w:

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

Wersja 2.1.1.0

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

Stworzone i przetestowane w:

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

Wersja 2.0.0.0

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

Stworzone i przetestowane w:

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

Stworzone i przetestowane w:

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

Wersja 1.6.3.0

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

Stworzone i przetestowane w:

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

Wersja 1.6.2.0

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

Stworzone i przetestowane w:

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

Wersja 1.6.1.0

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

Stworzone i przetestowane w:

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

Wersja 1.6.0.1

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

Stworzone i przetestowane w:

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

Wersja 1.6.0.0

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

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 8.13.0.
  • Teraz wymagany jest iOS w wersji co najmniej 10.0.
  • Maio SDK w wersji 1.6.0.
  • Pakiet SDK MaioOB w wersji 2.0.0-alfa.

Wersja 1.5.8.0

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

Stworzone i przetestowane w:

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

Wersja 1.5.6.1

  • Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.
  • Zaktualizowano adapter, aby używać formatu .xcframework.
  • Naprawiono błąd, który powodował, że zdarzenia reklamy z nagrodą czasami nie były przekierowywane.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 8.3.0 lub nowszej.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.6.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.68.0 lub nowszej.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.5.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.64.0 lub nowszej.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.4.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.60.0 lub nowszej.

Stworzone i przetestowane w:

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

Wersja 1.5.3.1

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

Stworzone i przetestowane w:

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

Wersja 1.5.3.0

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

Stworzone i przetestowane w:

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

Wersja 1.5.2.1

  • Rozwiązaliśmy problem, który powodował, że adapter nie wywoływał wywołania zwrotnego -rewardedAdDidPresent:.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.2.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.1.

Stworzone i przetestowane w:

  • 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 maio SDK w wersji 1.5.0.

Stworzone i przetestowane

  • 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

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

Wersja 1.4.6.0

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

Wersja 1.4.2.0

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

Wersja 1.4.1.0

  • Zweryfikowana zgodność z pakietem maio SDK w wersji 1.4.1.
  • Rozwiązaliśmy problem, który powodował, że adapter maio może działać nieprawidłowo, jeśli podano wiele identyfikatorów MediaId z AdMob.

Wersja 1.4.0.0

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

Wersja 1.3.2.0

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

Wersja 1.3.1.1

  • Dodano wywołanie zwrotne adapterDidCompletePlayingRewardBasedVideoAd: do adaptera.

Wersja 1.3.1.0

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

Wersja 1.3.0.0

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

Wersja 1.2.19.0

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

Wersja 1.2.18.0

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