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

Zintegruj Pangle z ustalaniem stawek

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Pangle za pomocą mediacji, w obrębie kaskady i integracji określania stawek. Omawiamy, jak dodać Pangle do konfiguracji zapośredniczenia jednostki reklamowej oraz integracji pakietu Pangle SDK i adaptera Android do aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Pangle ma te funkcje:

Integracja
Określanie stawek
Wodospad	¹
Formaty
Reklama przy otwarciu aplikacji	²
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

¹ Integracja kaskadowa jest zamkniętych testów beta.

² Integracja określania stawek ten format jest w fazie zamkniętych testów beta.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
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.

Zanotuj identyfikator aplikacji swojej aplikacji.

Tworzenie miejsca docelowego reklamy

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

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.

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.

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 Ad Manager interfejsie użytkownika

Zaloguj się na konto Ad Managera.

Dodaj Pangle do firm

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Przejdź do sekcji Administracja > Firmy i kliknij przycisk Nowa firma na karcie Wszystkie firmy. Kliknij Sieć reklamowa.

Jako Sieć reklamowa wybierz Pangle, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

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

Włącz udostępnianie bezpiecznych sygnałów

Ustalanie stawek

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Save (Zapisz).

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj Pangle określanie stawek

Ustalanie stawek

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

Jako licytującego wybierz Pangle.

Przesuń przełącznik obok opcji 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

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj mapowanie jednostki reklamowej

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę, dla której chcesz utworzyćPangle .

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

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna i kliknij Aplikacja mobilna. Następnie wpiszApp ID and Ad Placement ID otrzymane 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ę, dla której utworzyliśmy Pangle w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, Android jako Platformę i Aktywne jako Stan.

Wpisz wartość App ID and Ad Placement IDuzyskaną 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: 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 elementy zależności i konfiguracje wdrożenia. Użyj najnowszych wersji Pakiet SDK i adapter Pangle:

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

Integracja ręczna

Pobierz najnowszą wersję Pangle SDK na Androida i wyodrębnij fragment open_ad_sdk.aar z pobranego folderu archiwum i dodaj ją do projektu.
Przejdź do Artefakty adaptera Pangle w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz Pangle .aar adaptera i dodaj go do projektu.

Krok 4. Dodaj wymagany kod

Zaciemnianie kodu ProGuard

Jeśli używasz ProGuard do zaciemniania kodu Androida, postępuj zgodnie z instrukcjami podanymi w Dokumentacja Pangle aby mieć pewność, że kod pakietu SDK Pangle nie jest zaciemniony.

Krok 5. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager 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.

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

Adapter Pangle zwraca reklamy natywne jako NativeAd obiektów. Zawiera te dane pola dla NativeAd

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

¹ Adapter Pangle nie zapewnić bezpośredni dostęp do głównego komponentu z obrazem swoich reklam natywnych. Zamiast tego makro adapter wypełnia MediaView. z filmem lub obrazem.

Kody błędów

Jeśli adapter nie odbierze reklamy z Pangle, możesz sprawdzić bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

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

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter Pangle, gdy nie można wczytać 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 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.