Ta strona została przetłumaczona przez Cloud Translation API.

Integracja Pangle z określaniem stawek

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Pangle przy użyciu mediacji. Obejmuje on zarówno integrację z metodą kaskadową, jak i z metodą ustalania stawek. Przewodnik ten zawiera informacje o tym, jak dodać Pangle do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Pangle z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla Pangle ma te możliwości:

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

Wymagania

Android API na poziomie 23 lub wyższym

[Do określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj adaptera Pangle w wersji 5.5.0.4.0 lub nowszej (zalecana najnowsza wersja).

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie 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 uzupełnij resztę formularza. Następnie kliknij Prześlij.

Zanotuj identyfikator aplikacji.

Tworzenie miejsca docelowego reklamy

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

Określanie stawekWodospad

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

Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.

Wybierz Format reklamy i Nazwa miejsca docelowego reklamy, a jako Model cenowy wybierz Global CPM. Wypełnij resztę formularza i kliknij Prześlij.

Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.

Włączanie trybu testowego

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

Krok 2. Skonfiguruj zapotrzebowanie Pangle w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie Pangle w Firmach

Określanie stawekWodospad

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Kliknij kolejno Administracja > Firmy i na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Jako sieć reklamowa wybierz Pangle, wpisz unikalną nazwę i włącz zapośredniczenie.

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

Włączanie udostępniania bezpiecznych sygnałów

Określanie stawekWodospad

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange i sprawdź, czy opcja Udostępnianie bezpiecznych sygnałów jest włączona. Kliknij Zapisz.

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawekWodospad

Kliknij Zasoby reklamowe > Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Pangle DSP i włącz przełącznik Włącz integrację aplikacyjną.

Kliknij Zapisz.

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK

Określanie stawekWodospad

Kliknij Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne ustaw przełącznik Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku SDK Bidding.

Kliknij Zapisz.

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek Pangle

Określanie stawekWodospad

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz Pangle.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostek reklamowych

Określanie stawekWodospad

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę dla Pangle.

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

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. Następnie wpisz identyfikator aplikacji i identyfikator miejsca docelowego reklamy uzyskane w poprzedniej sekcji. Na koniec kliknij Zapisz.

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

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

Wybierz firmę utworzoną dla Pangle w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, jako Platforma wybierz Android, a jako Stan wybierz Aktywny.

Wpisz identyfikator aplikacji i identyfikator miejsca docelowego reklamy uzyskane w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

Krok 3. Zaimportuj pakiet SDK i adapter Pangle

Integracja z Android Studio (zalecana)

W pliku settings.gradle.kts na poziomie projektu dodaj te repozytoria:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

Następnie w pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera Pangle:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.0.0")
    implementation("com.google.ads.mediation:pangle:6.5.0.4.1")
}

Integracja ręczna

Pobierz najnowszą wersję pakietu Pangle SDK na Androida i wyodrębnij plik open_ad_sdk.aar z folderu pobranej archiwum. Następnie dodaj go do projektu.
Przejdź do elementów adaptera Pangle w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar z adapterem Pangle i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Zaciemnianie kodu ProGuard

Jeśli używasz narzędzia ProGuard do zaciemnienia kodu na Androida, postępuj zgodnie z instrukcjami podanymi w dokumentacji Pangle, aby upewnić się, że kod pakietu SDK Pangle nie jest zaciemniony.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrujesz urządzenie testowe w Ad Managerze i włączysz tryb testowy w interfejsie Pangle.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Pangle, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Pangle (określanie stawek) i Pangle (kaskada).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

Adapter Pangle zwraca reklamy natywne jako obiekty NativeAd. Wypełnia ona te pola: NativeAd.

Pole	Komponenty zawsze uwzględniane przez adapter Pangle
Nagłówek
Obraz	1
Treść
Ikona
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena
Reklamodawca

¹ W przypadku reklam natywnych adapter Pangle nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego. Zamiast tego adapter wypełnia poleMediaViewfilmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Pangle, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo.getAdapterResponses() w ramach tych klas:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

Oto kody i odpowiednie komunikaty z adaptera Pangle, które pojawiają się, gdy nie udaje się załadować reklamy:

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	Brakująca lub nieprawidłowa odpowiedź na zapytanie o stawkę.
-1-60000	com.pangle.ads	Pakiet SDK Pangle zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Pangle.