Integracja BidMachine z zapośredniczeniem

Wybierz platformę: Android (beta) Nowość Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Unity Plugin wczytywać i wyświetlać reklamy z BidMachine przy użyciu zapośredniczenia AdMob, a także jak korzystać z integracji z licytowaniem. Wyjaśnia, jak dodać BidMachine do konfiguracji mediacji 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 funkcje:

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

1 Integracja określania stawek jest w fazie zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

2 Format reklamy natywnej jest w wersji alfa. Wszystkie inne obsługiwane formaty reklam są w wersji beta. Poproś o dostęp menedżera konta.

Wymagania

  • Nowości na kanale Google Mobile Ads Unity Plugin
  • Unity w wersji 2019.4 lub nowszej
  • Wdrażanie na Androidzie
    • Android API na poziomie 23 lub wyższym
  • Wdrażanie 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 artykule Pierwsze kroki.
  • Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie BidMachine

Zaloguj się w panelu 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

Wyświetli się lista wszystkich Twoich miejsc docelowych. Aby utworzyć nowe miejsce docelowe, w oknie kliknij przycisk Dodaj miejsce docelowe.

Okno Edytuj źródło

Wypełnij formularz i kliknij Zapisz.

Android

Tworzenie miejsca docelowego na Androidzie

iOS

Tworzenie miejsca docelowego w aplikacji na iOS

Na koniec zanotuj identyfikator miejsca docelowego.

Android

Szczegóły miejsca docelowego na Androidzie

iOS

Szczegóły miejsca docelowego w iOS

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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

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

Krok 2. Skonfiguruj popyt BidMachine w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

Dodawanie BidMachine do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać BidMachine do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK BidMachine i adapter

OpenUPM-CLI

Jeśli masz zainstalowany OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę Google Mobile Ads BidMachine Mediation Plugin for Unity, uruchamiając to polecenie w katalogu głównym projektu:

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

OpenUPM

W edytorze projektu Unity wybierz Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Ustawienia menedżera pakietów Unity.

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

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

Szczegóły OpenUPM

Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Menedżera pakietów Unity, i w menu kliknij My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads BidMachine Mediation i kliknij Install (Zainstaluj).

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla BidMachine, korzystając z linku pobierania w dzienniku zmian, a następnie wyodrębnij plik GoogleMobileAdsBidMachineMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet) i znajdź pobrany plik GoogleMobileAdsBidMachineMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie kliknij Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie zależności w Androidzie) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager 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 BidMachine 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 stosowanie 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. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

BidMachine automatycznie odczytuje zgodę użytkowników w zakresie RODO ustawioną przez platformy do zarządzania zgodą użytkowników, w tym pakiet UMP SDK. Więcej informacji znajdziesz w przewodniku BidMachine dotyczącym RODO w przypadku Android i iOS.

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 stanów USA dotyczącymi ochrony 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.

BidMachine automatycznie odczytuje zgodę GPP ustawioną przez platformy do zarządzania zgodą, w tym UMP SDK. 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

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob.

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

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z BidMachine, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam BidMachine (ustalanie stawek).

Kody błędów

Jeśli adapter nie otrzyma reklamy z BidMachine, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo w tych klasach:

Android

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

iOS

GADMediationAdapterBidMachine

Oto kody i komunikaty wyświetlane 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ę zmapować żądanego rozmiaru reklamy na bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine Wygasło załadowane żądanie reklamy BidMachine.
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ł onAdLoaded() wywołanie zwrotne z null danymi reklamy.

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 do określania stawek nie zostało zrealizowane, 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 wczytania reklamy.
104 com.google.mediation.bidmachine Pakiet SDK BidMachine zwrócił reklamę inną niż banerową do metody delegowania BidMachineAdProtocol didLoadAd reklamy banerowej. Nigdy nie powinno się to zdarzyć.
105 com.google.mediation.bidmachine Reklama pełnoekranowa nie jest gotowa do wyświetlenia.
106 com.google.mediation.bidmachine Pakiet SDK Bid Machine zwrócił reklamę inną niż natywna do metody delegowania BidMachineAdProtocol didLoadAd reklamy natywnej. Nigdy nie powinno się to zdarzyć.
107 com.google.mediation.bidmachine Nie udało się wczytać jednego ze źródeł obrazu reklamy natywnej.

Historia zmian wtyczki do zapośredniczenia BidMachine Unity

Wersja 1.0.1

Wersja 1.0.0