Integracja Pangle z zapośredniczeniem

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