Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału AdMob na Discordzie na serwerze społeczności Google Ads i pomiarów.

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

Integracja PubMatic z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z PubMatic przy użyciu mediacji AdMob, w tym integracji z licytowaniem. Wyjaśniamy w nim, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować PubMatic i adapter z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia PubMatic ma te funkcje:

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

Wymagania

Android API na poziomie 23 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google.
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie PubMatic

Zaloguj się na konto PubMatic i wybierz kartę OpenWrap SDK.

Dodawanie nowej aplikacji

Otwórz kartę Aplikacje i kliknij przycisk Dodaj aplikację.

Panel aplikacji

Wybierz platformę, a także adres URL sklepu z aplikacjami i nazwę aplikacji.

W sekcji Ścieżka integracji wybierz Android (Java / Kotlin) i jako Ścieżkę integracji podrzędnej wybierz AdMob – określanie stawek za pomocą pakietu SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Zanim aplikacja zostanie ukończona, wyświetlimy odpowiednie wpisy, które możesz dodać do app-ads.txt.

app-aps.txt

Więcej informacji o wdrażaniu app-ads.txt w przypadku PubMatic znajdziesz w artykule Jak wdrożyć plik app-ads.txt.

Identyfikator profilu

Po utworzeniu aplikacji otwórz kartę Aplikacje i zanotuj identyfikator profilu nowo utworzonej aplikacji.

Identyfikator profilu aplikacji

Utwórz jednostkę reklamową

Na karcie Jednostki reklamowe wybierz aplikację utworzoną w poprzedniej sekcji i kliknij przycisk Utwórz jednostkę reklamową.

Tworzenie jednostki reklamowej

Wypełnij formularz, wpisując szczegóły jednostki reklamowej, i kliknij Zapisz.

Formularz tworzenia jednostki reklamowej

Zapisz nowo utworzony identyfikator jednostki reklamowej OpenWrap.

Identyfikator jednostki reklamowej w aplikacji

Uzyskiwanie identyfikatora wydawcy

Otwórz panel informacyjny Analytics. Najedź kursorem na ikonę profilu i zanotuj swój identyfikator.

Identyfikator wydawcy

Krok 2. Skonfiguruj popyt PubMatic w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać pakiet SDK PubMatic OpenWrap do konfiguracji zapośredniczenia w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie pakietu PubMatic OpenWrap SDK jako źródła reklam.

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

Wpisz format reklamy i platformę, a potem kliknij Dalej.

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

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna wyświetlić się karta jednostek reklamowych z wybranymi jednostkami:

Dodawanie pakietu PubMatic OpenWrap SDK jako źródła reklam

Na karcie Ustalanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz PubMatic OpenWrap SDK.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie ustalania stawek za pomocą pakietu PubMatic OpenWrap SDK.

Kliknij Potwierdzam i wyrażam zgodę, a potem Dalej.

Jeśli masz już mapowanie pakietu PubMatic OpenWrap SDK, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator jednostki reklamowej OpenWrap uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

Dodawanie PubMatic do listy partnerów reklamowych wymaganych przez RODO i przepisy stanowe w USA

Aby dodać PubMatic do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i przepisy stanowe w USA w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter PubMatic

Integracja z Androidem Studio (zalecana)

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

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 PubMatic:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.7.0")
    implementation("com.google.ads.mediation:pubmatic:4.9.1.0")
}

Krok 4. Wdróż ustawienia prywatności w pakiecie PubMatic SDK

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji.

PubMatic automatycznie odczytuje zgodę na przetwarzanie danych zgodnie z GDPR ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielenia dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Przekazywanie sygnałów o zgodności z RODO i zgody wymaganej przez RODO.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

PubMatic automatycznie odczytuje sygnał zgody GPP ustawiony przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google o nazwie „Udzielenie dodatkowej zgody”, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Przekazywanie zgody użytkownika na potrzeby GPP.

Krok 5. Dodaj wymagany kod

Integracja z PubMatic nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK PubMatic OpenWrap, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam PubMatic (ustalanie stawek).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

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

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z PubMatic, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo.getAdapterResponses() w tych klasach:

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

Oto kody i komunikaty wyświetlane przez adapter PubMatic, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
101	com.google.ads.mediation.pubmatic	W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy.
102	com.google.ads.mediation.pubmatic	Nieprawidłowa konfiguracja reklamy do wczytania reklamy.
103	com.google.ads.mediation.pubmatic	Nie udało się wyświetlić reklamy, ponieważ nie była gotowa.
1001-5002	Wysłane przez pakiet SDK PubMatic	Pakiet SDK PubMatic zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic.