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

Integracja Pangle z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Pangle za pomocą Zapośredniczenie AdMob, 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ą
Pełnoekranowa z nagrodą
Natywna

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

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

Musisz dodać Pangle do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Pangle jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Pangle jako źródło reklam

Ustalanie stawek

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij Pangle.

Kliknij Jak podpisać umowę partnerską i zawrzeć umowę partnerską z firmąPangle.

Kliknij Potwierdzam i akceptuję, a następnie kliknij Dalej.

Jeśli masz już mapowanie Pangle, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane App ID and Ad Placement IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Ważne: App ID musi być powiązany z aplikacją docelową, tak jak w interfejsiePangle .

Wodospad

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Pangle.

Kliknij Pangle. Następnie wpisz wartość eCPM dlaPangle i kliknij Dalej.

Jeśli masz już mapowanie Pangle, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane App ID and Ad Placement IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

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

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.