Integracja PubMatic z zapośredniczeniem

Wybierz platformę: Android Nowy Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak wczytywać i wyświetlać reklamy z PubMatic za pomocą zapośredniczenia AdMob, w tym integracji z określeniem stawek.Google Mobile Ads Flutter Plugin Wyjaśniamy w nim, jak dodać PubMatic do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter PubMatic z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla PubMatic ma te możliwości:

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

1 Ten format jest w wersji beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

Krok 1. Skonfiguruj ustawienia w interfejsie PubMatic

Zarejestruj się lub zaloguj się na swoje konto PubMatic i kliknij kartę OpenWrap SDK.

Dodawanie nowej aplikacji

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

Panel aplikacji

Wybierz Platformę, a także Adres URL w sklepie z aplikacjami i Nazwę aplikacji dla swojej aplikacji.

Android

W sekcji Ścieżka integracji wybierz Flutter, a w sekcji Ścieżka integracji podrzędnej wybierz AdMob – określanie stawek przez pakiet SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

iOS

W sekcji Ścieżka integracji wybierz Flutter, a w sekcji Ścieżka integracji podrzędnej wybierz AdMob – określanie stawek przez pakiet SDK. Następnie kliknij przycisk Dodaj aplikację.

Formularz nowej aplikacji

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli 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, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, skonfiguruj plik app-ads.txt dla swojej aplikacji.

Zanim aplikacja zostanie ukończona, zobaczysz odpowiednie wpisy, które należy dodać do pliku app-ads.txt.

app-aps.txt

Więcej informacji o tym, jak wdrożyć app-ads.txt w PubMatic, znajdziesz w artykule Jak wdrożyć plik app-ads.txt.

Identyfikator profilu

Gdy utworzysz aplikację, otwórz kartę Aplikacje i zapisz 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 szczegółami jednostki reklamowej i kliknij Zapisz.

Formularz tworzenia jednostki reklamowej

Zapisz nowo utworzony Identyfikator jednostki reklamowej OpenWrap.

Identyfikator jednostki reklamowej w aplikacji

Uzyskaj identyfikator wydawcy

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

Identyfikator wydawcy

Krok 2. Skonfiguruj popyt PubMatic w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dla Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodaj PubMatic do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Aby dodać PubMatic do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter PubMatic

Integracja przez pub.dev

(Tylko Android) Dodaj te repozytoria do pliku build.gradle w katalogu android projektu:

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

Dodaj tę zależność z najnowszymi wersjami pakietu SDK i adaptera PubMatic OpenWrap SDK w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_pubmatic: ^2.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia Google Mobile Ads dla PubMatic OpenWrap SDK, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie dodaj do pliku pubspec.yaml tę zależność:

dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

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

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na korzystanie z plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać zgodę użytkowników na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

PubMatic automatically reads GDPR consent set by consent management platforms that support Google's Additional Consent specification, including the UMP SDK. Więcej informacji znajdziesz w artykule Przekazywanie zgody na wykorzystanie danych zgodnie z RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (definicje poszczególnych terminów zostały określone 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 „sprzedającego”. Przewodnik po zgodności z amerykańskimi przepisami stanowymi 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 łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z instrukcjami każdej z tych sieci, aby zapewnić zgodność.

PubMatic automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z CCPA ustawioną przez platformy zarządzania zgodą, które obsługują specyfikację dodatkowej zgody Google, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Ustawianie ciągu znaków CCPA.

Krok 5. Dodaj wymagany kod

Android

Do integracji z PubMatic nie jest wymagany żaden dodatkowy kod.

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją PubMatic's.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w AdMob.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK PubMatic OpenWrap, włącz testowanie pojedynczego źródła reklam w inspektorze reklam za pomocą źródła lub źródeł reklam PubMatic OpenWrap.

Kody błędów

Jeśli adapter nie otrzyma reklamy z PubMatic, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy za pomocą parametru ResponseInfo w tych klasach:

Android

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

iOS

GADMediationAdapterPubMatic

Oto kody i towarzyszące im komunikaty zwracane przez adapter PubMatic, gdy nie uda się wczytać reklamy:

Android

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

iOS

Kod błędu Domena Przyczyna
101 com.google.ads.mediation.pubmatic W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy.
102 com.google.ads.mediation.pubmatic Nie udało się zebrać sygnałów określania stawek, ponieważ w parametrach żądania określono wiele formatów, brak formatu lub format nieobsługiwany.
103 com.google.ads.mediation.pubmatic Nieprawidłowa konfiguracja reklamy do wczytywania reklamy.
104 com.google.ads.mediation.pubmatic Nie udało się wyświetlić reklamy pełnoekranowej, ponieważ nie była gotowa.
105 com.google.ads.mediation.pubmatic Nie udało się wyświetlić reklamy z nagrodą, ponieważ nie była gotowa.
106 com.google.ads.mediation.pubmatic Nie udało się wczytać jednego ze źródeł obrazów reklam natywnych.
1001–5002 Wysłane przez pakiet SDK PubMatic Pakiet SDK PubMatic zwrócił błąd. Więcej informacji znajdziesz w dokumentacji PubMatic.

Dziennik zmian adaptera zapośredniczenia Pubmatic Flutter

Wersja 2.0.0

Wersja 1.6.0

Wersja 1.5.0

Wersja 1.4.1

Wersja 1.4.0

Wersja 1.3.0

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0