Integracja BidMachine z zapośredniczeniem

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

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Flutter Plugin wczytywać i wyświetlać reklamy z BidMachine przy użyciu zapośredniczenia AdMob, w tym integracji z określaniem 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 funkcje:

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

1 Integracja kaskadowa jest dostępna w ramach zamkniętych testów beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

  • Najnowsza wersja Google Mobile Ads Flutter Plugin.
  • Flutter w wersji 3.7.0 lub nowszej.
  • Wdrażanie na Androidzie
    • Android w wersji API 24 lub nowszej.
  • Wdrażanie 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 Pierwsze kroki.
  • 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

Wyświetli się lista wszystkich Twoich miejsc docelowych. Aby utworzyć nową 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

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, na panelu kliknij kartę app-ads.txt. Następnie skopiuj listę i dodaj 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 i adapter BidMachine

Integracja za pomocą pub.dev

Dodaj do pliku pubspec.yaml pakietu to zależności z najnowszymi wersjami pakietu BidMachine SDK i adaptera:

dependencies:
  gma_mediation_bidmachine: ^1.5.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki do mediacji reklam mobilnych Google dla BidMachine, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie odwołaj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

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

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

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

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z platformy 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ę przypisać żądanego rozmiaru reklamy do 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 licytowania 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 do tego dojść.
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 do tego dojść.
107 com.google.mediation.bidmachine Nie udało się wczytać jednego ze źródeł obrazów reklamy natywnej.
108 com.google.mediation.bidmachine BidMachine nie obsługuje tego rozmiaru reklamy banerowej.

Historia zmian adaptera do zapośredniczenia BidMachine Flutter

Wersja 1.5.0

Wersja 1.4.2

Wersja 1.4.1

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