Integracja BidMachine 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 BidMachine za pomocą zapośredniczenia AdMob, w tym integracji określania stawek. Wyjaśniamy w nim, jak dodać BidMachine do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter BidMachine z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

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

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

1 Integracja wodospadu jest dostępna w zamkniętej wersji beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

  • Najnowsza Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 lub nowszy
  • Aby wdrożyć na Androidzie:
    • Android API w wersji 23 lub nowszej
  • Aby wdrożyć na iOS:
    • iOS w wersji 13.0 lub nowszej
  • Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w przewodniku dla początkujących.
  • Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia Get started guide

Krok 1. Skonfiguruj ustawienia w interfejsie BidMachine

Zaloguj się na panel konta BidMachine.

Tworzenie nowych miejsc docelowych

Otwórz kartę Źródło i w tabeli Źródła kliknij przycisk Edytuj.

Panel Źródła

Zobaczysz listę wszystkich miejsc docelowych. Aby utworzyć nowe miejsce docelowe, kliknij przycisk Dodaj miejsce docelowe w oknie.

Okno Edytuj źródło

Jako Typ miejsca docelowego wybierz Określanie stawek. Wypełnij formularz i kliknij Zapisz.

Android

Tworzenie miejsca docelowego na Androida

iOS

Tworzenie miejsca docelowego na iOS

Na koniec zanotuj identyfikator miejsca docelowego.

Android

Szczegóły miejsca docelowego na Androidzie

iOS

Szczegóły miejsca docelowego w iOS

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.

Aby wdrożyć app-ads.txt w BidMachine, na panelu otwórz kartę app-ads.txt z Dashboard. Następnie skopiuj listę i dołącz ją do pliku app-ads.txt w swojej witrynie.

Krok 2. Skonfiguruj popyt BidMachine w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

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

Aby dodać BidMachine do listy partnerów reklamowych zgodnych z przepisami europejskimi i amerykańskimi 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 BidMachine

Integracja przez pub.dev

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

dependencies:
  gma_mediation_bidmachine: ^1.4.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia Google Mobile Ads dla BidMachine, 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_bidmachine:
    path: path/to/local/package

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

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.

BidMachine automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy zarządzania zgodą , w tym pakiet SDK UMP. Więcej informacji znajdziesz w przewodniku BidMachine dotyczącym RODO na Android i iOS.

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” (zgodnie z definicjami tych terminów 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 dotyczący 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 jest w stanie zastosować to ustawienie 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 wytycznymi każdej z tych sieci, aby zapewnić zgodność.

BidMachine automatycznie odczytuje zgodę GPP ustawioną przez platformy zarządzania zgodą , w tym pakiet SDK UMP. Więcej informacji znajdziesz w przewodniku BidMachine dotyczącym GPP na Android i iOS.

Krok 5. Dodaj wymagany kod

Android

Integracja z BidMachine nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją BidMachine dotyczącą obsługi SKAdNetwork.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w AdMob.

Aby włączyć tryb testowy w BidMachine, postępuj zgodnie z instrukcjami w dokumentacji BidMachine na Android i iOS.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z BidMachine, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, używając BidMachine (określanie stawek) źródła reklam.

Kody błędów

Jeśli adapter nie otrzyma reklamy z BidMachine, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na reklamę za pomocą ResponseInfo w tych klasach:

Android

io.bidmachine
com.google.ads.mediation.bidmachine

iOS

GADMediationAdapterBidMachine

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

Android

Kod błędu Domena Przyczyna
100 com.google.ads.mediation.bidmachine Otrzymano nieprawidłowy lub pusty identyfikator miejsca docelowego.
101 com.google.ads.mediation.bidmachine Błąd podczas zbierania sygnałów: nie znaleziono konfiguracji danych sygnału.
102 com.google.ads.mediation.bidmachine Podczas zbierania sygnałów otrzymano nieprawidłowy format reklamy.
103 com.google.ads.mediation.bidmachine Nie udało się przypisać żądanego rozmiaru reklamy do bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine Załadowane żądanie reklamy BidMachine wygasło.
105 com.google.ads.mediation.bidmachine Nie udało się wyświetlić reklamy pełnoekranowej.
106 com.google.ads.mediation.bidmachine Pakiet SDK BidMachine zwrócił wywołanie zwrotne onAdLoaded() z danymi reklamy null.

iOS

Kod błędu Domena Przyczyna
101 com.google.mediation.bidmachine W konfiguracji serwera brakuje wymaganego identyfikatora wydawcy.
102 com.google.mediation.bidmachine Żądanie zbierania sygnałów określania stawek nie powiodło się, ponieważ parametry RTB nie zawierają formatu reklamy lub określony format nie jest obsługiwany.
103 com.google.mediation.bidmachine Nieprawidłowa konfiguracja reklamy do wczytywania reklamy.
104 com.google.mediation.bidmachine Pakiet SDK BidMachine zwrócił reklamę inną niż banerowa do metody delegata BidMachineAdProtocol didLoadAd reklamy banerowej. Nigdy nie powinno do tego dojść.
105 com.google.mediation.bidmachine Reklama pełnoekranowa nie jest gotowa do wyświetlenia.
106 com.google.mediation.bidmachine Pakiet SDK BidMachine zwrócił reklamę inną niż natywna do metody delegata BidMachineAdProtocol didLoadAd reklamy natywnej. Nigdy nie powinno do tego dojść.
107 com.google.mediation.bidmachine Nie udało się wczytać jednego ze źródeł obrazów reklamy natywnej.

Dziennik zmian adaptera zapośredniczenia BidMachine Flutter

Wersja 1.4.0

Wersja 1.3.2

Wersja 1.3.1

Wersja 1.3.0

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.0