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

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

Zintegruj PubMatic z określaniem stawek

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, 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 jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

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 Ad Managera

Zaloguj się na konto Ad Managera.

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

Otwórz Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, a następnie przejrzyj i włącz opcję Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

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

Kliknij Zasoby reklamowe > Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj PubMatic i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

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

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek w PubMatic

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

Kliknij Nowy licytujący.

Jako licytującego wybierz PubMatic.

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

Kliknij Gotowe.

Konfigurowanie mapowania jednostki reklamowej

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

Wybierz firmę PubMatic OpenWrap SDK.

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

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz identyfikator jednostki reklamowej OpenWrap uzyskany w poprzedniej sekcji.

Jeśli konfigurujesz mapowanie jednostek reklamowych na potrzeby reklamy pełnoekranowej z nagrodą w interfejsie Ad Managera, wybierz format Z nagrodą i użyj identyfikatora miejsca docelowego reklamy pełnoekranowej z nagrodą.

Na koniec kliknij Zapisz.

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 Ad Managera, 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 Ad Managerze.

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.