Integracja Pangle z zapośredniczeniem

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, które obejmuje integracje kaskadowe i . Dowiesz się, 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

AdMob Adapter pośredniczący dla Pangle ma te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą

Wymagania

• Najnowszy pakiet SDK do reklam mobilnych Google
• Unity w wersji 5.6 lub nowszej
• Aby wdrożyć na Androidzie:
  • Poziom interfejsu API 21 lub nowszy
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS 12.0 lub nowsza
• 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 lub zaloguj się na konto Pangle.

Dodawanie nowej aplikacji

Przejdź na kartę Aplikacje i kliknij przycisk Dodaj aplikację.

Wybierz system operacyjny, dla którego chcesz utworzyć aplikację, i wypełnij pozostałą część formularza. Następnie kliknij Prześlij.

Android

iOS

Zanotuj identyfikator aplikacji Twojej aplikacji.

Android

iOS

Tworzenie miejsca docelowego reklamy

Po utworzeniu aplikacji kliknij przycisk Dodaj, aby utworzyć miejsce docelowe reklamy.

Android

iOS

Określanie stawek

Wybierz Format reklamy i Nazwa miejsca docelowego reklamy, a jako Typ ustalania stawek wybierz Określanie stawek w aplikacji. Wypełnij pozostałe pola formularza i kliknij Prześlij.

Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.

Android

iOS

Wodospad

Wybierz format reklamy i nazwę miejsca docelowego reklamy oraz globalny CPM jako typ ceny. Wypełnij resztę formularza i kliknij Prześlij.

Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.

Android

iOS

Znajdowanie klucza interfejsu Pangle Reporting API

Określanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

Zanotuj identyfikator użytkownika w lewym dolnym rogu strony.

Kliknij Integracje > Pakiet SDK i interfejs API > Pangle Reporting API 2.0. Zanotuj wartości Identyfikator roli i Klucz bezpieczeństwa.

Włącz tryb testowy

Aby włączyć reklamy testowe Pangle, postępuj zgodnie z instrukcjami w przewodniku Pangle dotyczącym dodawania reklam testowych.

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

Uwaga: brak zgodności wersji pakietu SDK Pangle i pakietu SDK do reklam mobilnych Google może spowodować problemy z tworzeniem.

OpenUPM-CLI

Ważne: jeśli przechodzisz z użycia .unitypackage na OpenUPM-CLI, musisz ręcznie odinstalować zasoby ze starej lokalizacji, usuwając wszystkie pliki z folderu Assets/GoogleMobileAds/Mediation/Pangle.

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę zapośredniczenia do reklam mobilnych Google Pangle, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

Ważne: jeśli przechodzisz z poziomu .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji, usuwając wszystkie pliki z foldera Assets/GoogleMobileAds/Mediation/Pangle.

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z ograniczonym dostępem z tymi informacjami:

• Nazwa: OpenUPM
• Adres URL: https://package.openupm.com
• Zakresy: com.google

Następnie wybierz Okno > Menedżer pakietów, aby otworzyć menedżera pakietów Unity, i z menu wybierz My Registries (Moje rejestry).

Wybierz pakiet Google Mobile Ads Pangle Mediation i kliknij Zainstaluj.

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla platformy 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 > Zewnętrzny menedżer zależności > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

Krok 4. Dodaj wymagany kod

Android

Integracja z Pangle nie wymaga dodatkowego kodu.

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ę

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 odpowiada obsługiwanemu rozmiarowi banera w 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 do pośrednictwa reklamowego w Unity

Wersja 4.3.3

• Obsługuje adapter Pangle na Androida w wersji 6.2.0.7.0.
• Obsługuje adapter Pangle na iOS w wersji 6.2.0.9.0.
• Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.1.

Wersja 4.3.2

• Obsługuje adapter Pangle na Androida w wersji 6.2.0.6.0.
• Obsługuje adapter Pangle na iOS w wersji 6.2.0.8.0.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.

Wersja 4.3.1

• Obsługuje adapter Pangle na Androida w wersji 6.2.0.5.0.
• Obsługuje adapter Pangle na iOS w wersji 6.2.0.7.0.
• Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.

Wersja 4.3.0

• Obsługuje adapter Pangle na Androida w wersji 6.2.0.4.0.
• Obsługuje adapter Pangle na iOS w wersji 6.2.0.5.0.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.

Wersja 4.2.1

• Obsługuje adapter Pangle na Androida w wersji 6.1.0.7.0.
• Obsługuje adapter Pangle na iOS w wersji 6.1.0.6.0.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.

Wersja 4.2.0

• Nazwa DummyClient została zmieniona na PlaceholderClient.
• Obsługuje adapter Pangle na Androida w wersji 6.1.0.6.0.
• Obsługuje adapter Pangle na iOS w wersji 6.1.0.5.0.
• Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.2.0.

Wersja 4.1.0

• Obsługuje adapter Pangle na Androida w wersji 6.0.0.8.0.
• Obsługuje adapter Pangle na iOS w wersji 6.1.0.5.0.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.1.

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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Ta wersja została opracowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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

• Treści adaptera zostały przeniesione 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.
• Skompilowana i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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

• Zmieniono nazwy tych metod w klasie Pangle:
  • SetGDPR() -> SetGDPRConsent()
  • SetCCPA() -> SetDoNotSell()
• Obsługuje adapter Pangle do Androida w wersji 4.7.0.5.0.
• Obsługuje adapter Pangle na iOS w wersji 4.7.0.5.0.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity 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.
• Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.