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 Unity Plugin do wczytywania i wyświetlania reklam z BidMachine za pomocą zapośredniczenia AdMob, w tym integracji z określeniem stawek. Wyjaśniamy, jak dodać BidMachine do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter BidMachine z aplikacją Unity.

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ą

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

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te wymagania:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Edytor Unity w wersji 2019.4 lub nowszej.
  • Aby wdrożyć aplikację na Androida:
    • Android w wersji API 23 lub nowszej.
  • Aby wdrożyć aplikację na iOS:
    • iOS w wersji 13.0 lub nowszej.
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Więcej informacji znajdziesz w przewodniku dla początkujących .
  • Skonfiguruj zapośredniczenie AdMob.

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, w oknie kliknij przycisk Dodaj miejsce docelowe.

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 rozporządzeniami europejskimi i przepisami stanowymi USA w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych USA.

Krok 3. Zaimportuj pakiet SDK i adapter BidMachine

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI , możesz zainstalować wtyczkę zapośredniczenia reklam mobilnych Google dla środowiska Unity w projekcie, uruchamiając to polecenie w katalogu głównym projektu:

openupm add com.google.ads.mobile.mediation.bidmachine

OpenUPM

W edytorze projektu Unity otwórz ustawienia Menedżera pakietów Unity, klikając kolejno Edit > Project Settings > Package Manager.

Na karcie Scoped Registries (Rejestry w zakresie) dodaj OpenUPM jako rejestr w zakresie, podając te informacje:

  • Nazwa: OpenUPM
  • URL: https://package.openupm.com
  • Zakresy: com.google

Szczegóły OpenUPM

Następnie otwórz Menedżera pakietów Unity, klikając kolejno Window (Okno) > Package Manager (Menedżer pakietów), i w menu wybierz My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads BidMachine Mediation (Zapośredniczenie reklam mobilnych Google w BidMachine) i kliknij Install (Zainstaluj).

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla BidMachine, korzystając z linku do pobierania w dzienniku zmian , i wypakuj plik GoogleMobileAdsBidMachineMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity kliknij kolejno Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet) i znajdź pobrany plik GoogleMobileAdsBidMachineMediation.unitypackage. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Import (Importuj).

Importowanie z Unity

Następnie kliknij kolejno Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie problemów z Androidem) > Force Resolve (Wymuś rozwiązanie). Biblioteka Menedżera zależności zewnętrznych od nowa rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

Wymuś rozwiązanie

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 stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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” (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 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 instrukcjami 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 z 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 za pomocą źródła lub źródeł reklam BidMachine (określanie stawek).

Kody błędów

Jeśli adapter nie otrzyma reklamy z BidMachine, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy 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łów.
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 wtyczki zapośredniczenia BidMachine dla środowiska Unity

Wersja 1.4.2

Wersja 1.4.1

Wersja 1.4.0

Wersja 1.3.0

Wersja 1.2.1

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.2

Wersja 1.0.1

Wersja 1.0.0