Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Pangle za pomocą zapośredniczenia obejmującego integracje kaskadowe i . Dowiesz się z niego, jak dodać Pangle do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Pangle z aplikacją Unity .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do Pangle:
| Integracja | |
|---|---|
| Ustalanie stawek | |
| Wodospad | |
| Formaty | |
| Baner | |
| Pełnoekranowa | |
| Otrzymano | |
| Pełnoekranowa z nagrodą | |
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity w wersji 5.6 lub nowszej
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Wykonaj zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Pangle
Zarejestruj się lub zaloguj na konto Pangle.
Dodaj nową aplikację
Otwórz kartę Applications (Aplikacje) i kliknij przycisk Add App (Dodaj aplikację).
Wybierz System operacyjny, dla którego chcesz utworzyć aplikację, i wypełnij resztę formularza. Następnie kliknij Prześlij.
Android
iOS
Zanotuj identyfikator aplikacji swojej aplikacji.
Android
iOS
Tworzenie miejsca docelowego reklamy
Po utworzeniu aplikacji kliknij przycisk Dodaj, aby utworzyć miejsce docelowe reklamy.
Android
iOS
Ustalanie stawek
Wybierz Format reklamy i Nazwa miejsca docelowego reklamy, a jako Typ wybierz Ustalanie stawek w aplikacji. Wypełnij resztę formularza i kliknij Prześlij.
Po utworzeniu miejsca docelowego reklamy zanotuj Identyfikator miejsca docelowego reklamy.
Android
iOS
Wodospad
Wybierz Format reklamy i Nazwa miejsca docelowego reklamy, a jako Typ cen – Globalny CPM. Wypełnij resztę formularza i kliknij Prześlij.
Po utworzeniu miejsca docelowego reklamy zanotuj Identyfikator miejsca docelowego reklamy.
Android
iOS
Znajdowanie klucza interfejsu Pangle Reporting API
Ustalanie stawek
W przypadku integracji określania stawek ten krok nie jest wymagany.
Wodospad
Zwróć uwagę na identyfikator użytkownika w lewym dolnym rogu strony.
Kliknij Integracje > SDK i interfejs API > Pangle Reporting API 2.0. Zwróć uwagę na identyfikator roli i klucz bezpieczeństwa.
Włącz tryb testowy
Wykonaj instrukcje z przewodnika Jak dodać reklamę testową w Pangle, aby dowiedzieć się, jak włączyć reklamy testowe Pangle.
Krok 2. Skonfiguruj żądania Pangle w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Krok 3. Zaimportuj pakiet SDK i adapter Pangle
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla Pangle, korzystając z linku pobierania w dzienniku zmian, i wyodrębnij GoogleMobileAdsPangleMediation.unitypackage z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsPangleMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania nazw usług Unity Play od zera przeprowadzi analizę zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji w Unity.
Krok 4. Dodaj wymagany kod
Android
Do integracji z Pangle nie jest wymagany żaden dodatkowy kod.
iOS
Integracja SKAdNetwork
Wykonaj czynności opisane w dokumentacji usługi Pangle, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.
Krok 5. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Pangle interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyPangle, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Pangle (Bidding) and Pangle (Waterfall) źródeł reklam.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Pangle, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę, używając polecenia ResponseInfo w tych klasach:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Pangle, gdy nie udało się wczytać reklamy:
Android
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego). |
| 102 | com.google.ads.mediation.pangle | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Pangle. |
| 103 | com.google.ads.mediation.pangle | Brak odpowiedzi na pytanie o stawkę lub odpowiedź jest nieprawidłowa. |
| -1-60000 | com.pangle.ads | Pakiet SDK Pangle zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Pangle. |
iOS
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego). |
| 102 | com.google.ads.mediation.pangle | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Pangle. |
| -1-60000 | Wysłane przez Pangle SDK | Pakiet SDK Pangle zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Pangle. |
Historia zmian wtyczki Pangle Unity Mediation
Wersja 4.0.1
- Obsługuje adapter Pangle na Androida w wersji 6.0.0.5.0.
- Obsługuje adapter Pangle na iOS w wersji 6.0.0.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 4.0.0
- Obsługuje adapter Pangle na Androida w wersji 6.0.0.5.0.
- Obsługuje adapter Pangle na iOS w wersji 6.0.0.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 3.0.0
- Obsługuje adapter Pangle na Androida w wersji 6.0.0.3.0.
- Obsługuje adapter Pangle na iOS w wersji 5.9.0.9.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 2.8.1
- Obsługuje adapter Pangle na Androida w wersji 5.9.0.6.0.
- Obsługuje adapter Pangle na iOS w wersji 5.9.0.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 2.8.0
- Obsługuje adapter Pangle na Androida w wersji 5.9.0.4.0.
- Obsługuje adapter Pangle na iOS w wersji 5.9.0.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 2.7.0
- Obsługuje adapter Pangle na Androida w wersji 5.9.0.2.0.
- Obsługuje adapter Pangle na iOS w wersji 5.8.0.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 2.6.0
- Obsługuje adapter Pangle na Androida w wersji 5.8.0.9.0.
- Obsługuje adapter Pangle na iOS w wersji 5.8.0.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 2.5.0
- Obsługuje adapter Pangle na Androida w wersji 5.7.0.1.0.
- Obsługuje adapter Pangle na iOS w wersji 5.7.0.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 2.4.0
- Obsługuje adapter Pangle na Androida w wersji 5.5.0.9.0.
- Obsługuje adapter Pangle na iOS w wersji 5.5.0.9.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 2.3.0
- Obsługuje adapter Pangle na Androida w wersji 5.3.0.6.0.
- Obsługuje adapter Pangle na iOS w wersji 5.3.1.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.4.1.
Wersja 2.2.0
- Obsługuje adapter Pangle na Androida w wersji 5.2.0.6.0.
- Obsługuje adapter Pangle na iOS w wersji 5.2.0.9.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.3.0.
Wersja 2.1.0
- Obsługuje adapter Pangle na Androida w wersji 5.1.0.9.0.
- Obsługuje adapter Pangle na iOS w wersji 5.1.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 2.0.0
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/Pangle/. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.Pangle. - Obsługuje adapter Pangle na Androida w wersji 5.0.0.7.0.
- Obsługuje adapter Pangle na iOS w wersji 5.0.0.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 1.5.1
- Obsługuje adapter Pangle na Androida w wersji 4.9.0.7.0.
- Obsługuje adapter Pangle na iOS w wersji 4.9.0.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.0.
Wersja 1.5.0
- Obsługuje adapter Pangle na Androida w wersji 4.9.0.6.0.
- Obsługuje adapter Pangle na iOS w wersji 4.9.0.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 1.4.0
- Obsługuje adapter Pangle na Androida w wersji 4.8.1.0.0.
- Obsługuje adapter Pangle na iOS w wersji 4.8.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 1.3.1
- Obsługuje adapter Pangle na Androida w wersji 4.7.0.6.0.
- Obsługuje adapter Pangle na iOS w wersji 4.7.0.6.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 1.3.0
- Zmieniliśmy nazwy tych metod w klasie
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Obsługuje adapter Pangle na Androida w wersji 4.7.0.5.0.
- Obsługuje adapter Pangle na iOS w wersji 4.7.0.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 1.2.0
- Obsługuje adapter Pangle na Androida w wersji 4.5.0.6.1.
- Obsługuje adapter Pangle na iOS w wersji 4.5.2.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.1.0.
Wersja 1.1.0
- Obsługuje adapter Pangle na Androida w wersji 4.5.0.3.0.
- Obsługuje adapter Pangle na iOS w wersji 4.5.1.3.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter Pangle na Androida w wersji 4.3.0.8.0.
- Obsługuje adapter Pangle na iOS w wersji 4.3.0.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.