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, która obejmuje integrację z kaskadą i licytacją. 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

¹ Integracja z kaskadą jest w ramach zamkniętych testów beta.

² Integracja określania stawek w przypadku tego formatu jest dostępna w ramach otwartych testów beta.

Wymagania

poziom interfejsu API 21 lub nowszy,
[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
Przeczytaj Przewodnik 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.

Zapisz identyfikator aplikacji.

Tworzenie miejsca docelowego reklamy

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

Określanie stawek

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.

Wodospad

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 stawek

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

Wodospad

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

Jako sieci reklamowej 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 stawek

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.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek Pangle

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz Pangle.

Włącz opcje Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostek reklamowych

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę 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.

Wodospad

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:23.6.0")
    implementation("com.google.ads.mediation:pangle:6.3.0.4.0")
}

Integracja ręczna

Pobierz najnowszą wersję pakietu Pangle SDK na Androida i wyodrębnij z pobranego folderu z archiwum plik open_ad_sdk.aar, a 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 zaciemniania 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.

Weryfikowanie 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 w przypadku 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 towarzyszące im komunikaty, które pojawiają się w adapterze Pangle, 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 stawki.
-1-60000	com.pangle.ads	Pakiet SDK Pangle zwrócił błąd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Pangle.