Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam z BidMachine za pomocą zapośredniczenia, które obejmuje integracje 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ą na iOS.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia BidMachine ma te możliwości:
| 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 zamkniętej wersji beta. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.
Wymagania wstępne
Zanim przejdziesz dalej, sprawdź te kwestie:
- iOS w wersji 13.0 lub nowszej.
Najnowsza wersja Google Mobile Ads SDK.
Krok 1. Skonfiguruj ustawienia w interfejsie BidMachine
Zaloguj się w panelu konta BidMachine.
Tworzenie nowych miejsc docelowych
Przejdź do karty Źródło i w tabeli Źródła kliknij przycisk Edytuj.
Wyświetli się lista wszystkich Twoich miejsc docelowych. Aby utworzyć nowe miejsce docelowe, kliknij w oknie przycisk Dodaj miejsce docelowe.
Jako Typ miejsca docelowego wybierz Określanie stawek. Wypełnij formularz i kliknij Zapisz.
Na koniec zanotuj identyfikator miejsca docelowego.
Aktualizowanie pliku 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 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 na potrzeby Ad Managera.
Aby wdrożyć app-ads.txt w przypadku BidMachine, otwórz kartę app-ads.txt w panelu. Następnie skopiuj listę i dodaj ją do pliku app-ads.txt w swojej witrynie.
Krok 2. Skonfiguruj oferty 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.
Kaskada
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średniczenie.
Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.
Włącz udostępnianie bezpiecznych sygnałów
Określanie stawek
Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.
Kaskada
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 BidMachine i włącz opcję Włącz integrację aplikacyjną.
Kliknij Zapisz.
Kaskada
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 Wyświetlanie > 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.
Kaskada
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.
Wybierz licytującego BidMachine.
Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.
Kliknij Gotowe.
Kaskada
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ę 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.
Kaskada
Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz Zasoby reklamowe i Aplikacja.
Przewiń do sekcji Partnerzy zysku i kliknij Dodaj partnera zapośredniczenia.
Wybierz firmę utworzoną dla BidMachine w poprzedniej sekcji. Wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platformę i Aktywny jako Stan.
Wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.
Dodawanie BidMachine do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA
Wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych, aby dodać BidMachine do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera.
Krok 3. Zaimportuj pakiet SDK i adapter BidMachine
Korzystanie z Swift Package Manager
Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 3.6.0.0.
Aby dodać do projektu zależność pakietu, wykonaj te czynności:
W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).
W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:
https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.gitW sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz
main.
Korzystanie z CocoaPods
Dodaj do pliku Podfile projektu ten wiersz:
pod 'GoogleMobileAdsMediationBidMachine'W wierszu poleceń uruchom:
pod install --repo-update
Integracja ręczna
Pobierz najnowszą wersję pakietu SDK BidMachine na iOS i połącz wszystkie pliki
.xcframeworki pakiety w projekcie.Pobierz najnowszą wersję adaptera BidMachine, korzystając z linku do pobrania w liście zmian, i połącz
BidMachineAdapter.xcframeworkw projekcie.
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), Szwajcarii i Wielkiej Brytanii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych form 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.
BidMachine automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą użytkowników, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule RODO.
amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe dotyczące prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja rezygnacji musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej „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ą użytkowników, w tym pakiet SDK UMP. Więcej informacji: GPP.
Krok 5. Dodaj wymagany kod
Wdrażanie SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją BidMachine.
Krok 6. Przetestuj implementację
Włączanie reklam testowych
Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.
Aby włączyć tryb testowy w BidMachine, postępuj zgodnie z instrukcjami podanymi w dokumentacji BidMachine dotyczącej iOS.
Sprawdzanie 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).
Kroki opcjonalne
Reklamy natywne
Renderowanie reklam
Adapter BidMachine zwraca reklamy natywne jako obiekty GADNativeAd. Wypełnia te pola dla GADNativeAd.
| 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ć błąd w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:
GADMediationAdapterBidMachine
Oto kody i powiązane z nimi komunikaty, które adapter BidMachine wyświetla, gdy nie uda się wczytać reklamy:
| 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. |
| 104 | com.google.mediation.bidmachine | Pakiet SDK BidMachine zwrócił reklamę inną niż baner reklamowy do metody delegowanej BidMachineAdProtocol didLoadAd banera reklamowego. 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 delegowanej 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 banera reklamowego. |
Historia zmian adaptera zapośredniczenia BidMachine na iOS
Wersja 3.8.2.0 (w toku)
Wersja 3.8.1.0
- Sprawdzona zgodność z pakietem BidMachine SDK w wersji 3.8.1.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.10.0.
- Pakiet SDK BidMachine w wersji 3.8.1.
Wersja 3.8.0.0
- Sprawdzona zgodność z wersją 3.8.0 pakietu SDK BidMachine.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 13.9.0.
- Wersja pakietu SDK BidMachine 3.8.0.
Wersja 3.7.1.1
- Zaktualizowaliśmy minimalną wersję pakietu SDK do reklam mobilnych Google na iOS do wersji
13.3, aby umożliwić korzystanie z wersji podrzędnych. - Zaktualizowaliśmy przekazywanie identyfikatora miejsca docelowego do pakietu SDK BidMachine podczas zbierania sygnałów i wczytywania reklam.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.8.0.
- Pakiet SDK BidMachine w wersji 3.7.1.
Wersja 3.7.1.0
- Zweryfikowano zgodność z pakietem SDK BidMachine w wersji 3.7.1.
- Żądania reklam z określaniem stawek stałych dla banerów nie przekazują prawidłowo rozmiaru reklamy.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
- BidMachine SDK w wersji 3.7.1.
Wersja 3.7.0.0
- Zweryfikowana zgodność z pakietem SDK BidMachine w wersji 3.7.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
- Pakiet SDK BidMachine w wersji 3.7.0.
Wersja 3.6.1.1
- Adapter przekazuje teraz flagę
ageRestrictedTreatmentpakietu SDK do reklam mobilnych Google do interfejsu API COPPA pakietu SDK BidMachine. - Uaktualnij adapter BidMachine i testy jednostkowe do wersji Swift 6.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
- Pakiet SDK BidMachine w wersji 3.6.1.
Wersja 3.6.1.0
- Sprawdzona zgodność z pakietem BidMachine SDK w wersji 3.6.1.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
- Pakiet SDK BidMachine w wersji 3.6.1.
Wersja 3.6.0.0
- Zweryfikowana zgodność z pakietem SDK BidMachine w wersji 3.6.0.
- Przebudowano wczytywanie banerów reklamowych BidMachine i obsługę obrazów reklam natywnych.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
- Pakiet SDK BidMachine w wersji 3.6.0.
Wersja 3.5.1.2
- Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
- Pakiet SDK BidMachine w wersji 3.5.1.
Wersja 3.5.1.1
- Zaktualizowano minimalną wersję iOS w CocoaPods do
13.0. - Dodano obsługę przekazywania parametru
tagForUnderAgeOfConsentpakietu SDK do reklam mobilnych Google do pakietu SDK BidMachine. - Zmodyfikowano sekcje dotyczące zgodności
BidMachineAdDelegate, aby dostosować je do działania wywołania zwrotnego pakietu BidMachine SDK.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
- Pakiet SDK BidMachine w wersji 3.5.1.
Wersja 3.5.1.0
- * Zweryfikowana zgodność z pakietem SDK BidMachine w wersji 3.5.1.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
- Pakiet SDK BidMachine w wersji 3.5.1.
Wersja 3.5.0.0
- Zweryfikowana zgodność z pakietem SDK BidMachine w wersji 3.5.0.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 12.12.0.
- Wersja pakietu BidMachine SDK 3.5.0.
Wersja 3.4.0.2
- Dodano obsługę kaskadową w przypadku formatów reklam banerowych, pełnoekranowych, z nagrodą i natywnych.
- Usunęliśmy właściwość statyczną
isTestModezBidMachineAdapterExtras. - Dodaliśmy weryfikację rozmiaru banera w przypadku banerów reklamowych wyświetlanych w kaskadzie.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 12.12.0.
- Pakiet SDK BidMachine w wersji 3.4.0.
Wersja 3.4.0.1
- Tryb testowy jest teraz dostępny w Objective-C za pomocą właściwości
GADMediationAdapterBidMachineExtras.isTestMode.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
- Wersja pakietu SDK BidMachine 3.4.0.
Wersja 3.4.0.0
- Pierwsza wersja.
- Dodano obsługę określania stawek w przypadku formatów reklam banerowych, pełnoekranowych, z nagrodą i natywnych.
- Zweryfikowano zgodność z pakietem SDK BidMachine w wersji 3.4.0.
Zbudowano i przetestowano z:
- Pakiet SDK do reklam mobilnych Google w wersji 12.8.0.
- Pakiet SDK BidMachine w wersji 3.4.0.