Integracja PubMatic z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z PubMatic za pomocą zapośredniczenia, w tym integracji z określeniem stawek. Dowiesz się, 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 Ad Managera 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. Zamów dostęp do niego u menedżera konta.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Platforma Flutter w wersji 3.7.0 lub nowszej.
  • Aby wdrożyć aplikację na Androidzie:
    • Android w wersji 23 lub nowszej.
  • Aby wdrożyć aplikację na iOS:
    • iOS w wersji 13.0 lub nowszej.
  • Działający projekt Fluttera skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.
  • Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu SDK PubMatic OpenWrap

Zarejestruj się lub zaloguj się na swoje 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 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, utwórz plik app-ads.txt dla Ad Managera.

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 zaimplementować app-ads.txt w PubMatic, znajdziesz w artykule Jak zaimplementować 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.

Tworzenie formularza 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 zapotrzebowanie pakietu SDK PubMatic OpenWrap w interfejsie Ad Managera

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

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 w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_pubmatic: ^2.1.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla pakietu SDK PubMatic OpenWrap, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Fluttera. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając tę zależność:

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

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK PubMatic OpenWrap

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” („Proszę nie sprzedawać 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 ustawą CCPA ustawioną przez platformy zarządzania zgodą które obsługują specyfikację udzielenia 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

W przypadku 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ą pakietu SDK PubMatic OpenWrap.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w Ad Managerze.

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 dla Fluttera

Wersja 2.2.0 (w toku)

Wersja 2.1.0

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