Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z reklam Pangle, korzystając z zapośredniczenia, obejmujące kaskadę i określanie stawek stawek. Wyjaśniamy, jak dodaj Pangle do konfiguracji zapośredniczenia jednostki reklamowej i jak zintegrować tag Pakiet SDK Pangle i adapter do aplikacji Flutter .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob do Pangle zawiera: 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
- Flutter w wersji 3.7.0 lub nowszej
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 12.0 lub nowszej
- Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ 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
Integracja przez pub.dev
(Tylko na Androidzie) Dodaj poniższe repozytoria do pliku build.gradle
znajdującego się w nim
katalog android
Twojego projektu:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Dodaj tę zależność z najnowszymi wersjami
Pangle Pakiet SDK i adapter w pakiecie
Plik pubspec.yaml
:
dependencies:
gma_mediation_pangle: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla
Pangle
rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki
(i jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w
pubspec.yaml
przez dodanie tej zależności:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
Krok 4. Dodaj wymagany kod
Android
Do integracji z Pangle nie jest wymagany żaden dodatkowy kod.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją 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ć
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w
następujące klasy:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter Pangle, gdy nie można 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 adaptera Pangle Flutter Mediation Adapter
1.1.0
- Zweryfikowano zgodność z adapterem Androida Pangle w wersji 5.9.0.4.0.
- Zweryfikowano zgodność z adapterem systemu iOS Pangle w wersji 5.9.0.7.0.
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Zweryfikowano zgodność z adapterem Androida Pangle w wersji 5.8.0.9.0
- Zweryfikowano zgodność z adapterem systemu iOS Pangle w wersji 5.8.0.8.0
- Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.0.0.