Podziel się opinią o pakiecie SDK nowej generacji do reklam mobilnych Google na kanale #gma-next-gen-sdk na serwerze społeczności Google Advertising and Measurement na Discordzie.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Integracja BidMachine z zapośredniczeniem

Wybierz platformę: Android

Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z BidMachine przy użyciu mediacji, w tym integracji z licytowaniem. Wyjaśnia, jak dodać BidMachine do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter BidMachine z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia BidMachine ma te funkcje:

Integracja
Określanie stawek
Wodospad	¹
Formaty
Przy otwarciu aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

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

Wymagania

Android w wersji API 24 lub nowszej

[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera BidMachine w wersji 3.4.0.1 lub nowszej (zalecana jest najnowsza wersja).

Nowości na kanale GMA Next-Gen SDK
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.

Tworzenie miejsca docelowego

Na koniec zanotuj identyfikator miejsca docelowego.

Szczegóły miejsca docelowego

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 jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

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

Zaloguj się na konto Ad Managera.

Dodawanie BidMachine w sekcji Firmy

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Wodospad

Kliknij kolejno Administracja > Firmy, a potem na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz BidMachine jako sieć reklamową, wpisz niepowtarzalną nazwę i włącz zapośredniczanie.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włącz udostępnianie bezpiecznych sygnałów

Określanie stawek

Otwórz Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, a następnie przejrzyj i włącz opcję Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawek

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj BidMachineToken i włącz Włącz integrację aplikacji.

Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie określania stawek w BidMachine

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz BidMachine.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę, która ma korzystać z BidMachine.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz Identyfikator źródła i Identyfikator miejsca docelowego uzyskane w poprzedniej sekcji.

Na koniec kliknij Zapisz.

Wodospad

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby BidMachine. Jako typ integracji wybierz Zapośredniczenie mobilne SDK, jako platformę wybierz Android, a jako stan wybierz Aktywny.

Wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji oraz wartość domyślnego CPM. Kliknij Zapisz.

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

Aby dodać BidMachine do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, 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

Integracja z Androidem Studio (zalecana)

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bidmachine:3.7.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Zakręcony

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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 zapośredniczenia. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

BidMachine automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO, która jest ustawiana przez platformy do zarządzania zgodą użytkowników, w tym UMP SDK. Więcej informacji znajdziesz w sekcji RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące ochrony prywatności 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 stanowymi 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 zapośredniczenia. 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 sekcji GPP.

Krok 5. Dodaj wymagany kod

Integracja z BidMachine nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

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

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

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).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

Adapter BidMachine zwraca reklamy natywne jako obiekty.NativeAd Wypełnia te pola w przypadku NativeAd:

Pole	Zasoby zawsze uwzględniane przez adapter BidMachine
Nagłówek
Obraz
Treść
Ikona
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena
Reklamodawca

Kody błędów

Jeśli adapter nie otrzyma reklamy z BidMachine, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z tych klas:ResponseInfo.getAdSourceResponses()

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

Oto kody i komunikaty wyświetlane przez adapter BidMachine, gdy nie uda się wczytać reklamy:

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.

Historia zmian adaptera mediacji BidMachine na Androida