Integracja BidMachine z zapośredniczeniem

Wybierz platformę: Android Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads 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 iOS.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia BidMachine ma te funkcje:

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

Wymagania

• iOS w wersji 13.0 lub nowszej.

• Nowości na kanale Google Mobile Ads 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.

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

Wypełnij formularz i kliknij Zapisz.

Na koniec zanotuj identyfikator 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

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

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

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

Konfigurowanie określania stawek w BidMachine

Konfigurowanie mapowania jednostki reklamowej

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

Używanie menedżera pakietów Swift

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 3.6.0.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

1. W Xcode kliknij File > Add Package Dependencies... (Plik > Dodaj zależności pakietu…).

2. W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. W sekcji Reguła zależności wybierz Gałąź.

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

1. Pobierz najnowszą wersję pakietu BidMachine SDK na iOS i połącz wszystkie pliki .xcframework i pakiety w projekcie.

2. Pobierz najnowszą wersję adaptera BidMachine, korzystając z linku do pobierania w dzienniku zmian, i połącz ją z projektem.BidMachineAdapter.xcframework

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

Wdrażanie SKAdNetwork

Postępuj zgodnie z dokumentacją BidMachine, 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 Ad Managerze.

Aby włączyć tryb testowy BidMachine, postępuj zgodnie z instrukcjami w dokumentacji BidMachine dla 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).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

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

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 GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMediationAdapterBidMachine

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

Historia zmian adaptera mediacji BidMachine na iOS

Wersja 3.7.0.0

• Sprawdzona zgodność z pakietem BidMachine SDK w wersji 3.7.0.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
• Wersja pakietu SDK BidMachine 3.7.0.

Wersja 3.6.1.1

• Adapter przekazuje teraz flagę ageRestrictedTreatment pakietu SDK do reklam mobilnych Google do interfejsu API COPPA pakietu SDK BidMachine.
• Uaktualnij adapter BidMachine i testy jednostkowe do Swift 6.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
• BidMachine SDK w wersji 3.6.1.

Wersja 3.6.1.0

• Sprawdzona zgodność z pakietem SDK BidMachine w wersji 3.6.1.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
• BidMachine SDK w wersji 3.6.1.

Wersja 3.6.0.0

• Zweryfikowana zgodność z wersją 3.6.0 pakietu SDK BidMachine.
• Przebudowano wczytywanie banerów reklamowych BidMachine i obsługę obrazów reklam natywnych.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
• Wersja pakietu SDK BidMachine 3.6.0.

Wersja 3.5.1.2

• Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
• Wersja pakietu SDK BidMachine 3.5.1.

Wersja 3.5.1.1

• Zaktualizowano minimalną wersję iOS dla CocoaPods do 13.0.
• Dodano obsługę przekazywania parametru tagForUnderAgeOfConsent pakietu SDK do reklam mobilnych Google do pakietu SDK BidMachine.
• Zmodyfikowane BidMachineAdDelegatesekcje dotyczące zgodności, aby dostosować je do działania wywołania zwrotnego pakietu BidMachine SDK.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
• Wersja pakietu SDK BidMachine 3.5.1.

Wersja 3.5.1.0

• Sprawdzona zgodność z pakietem BidMachine SDK w wersji 3.5.1.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Wersja pakietu SDK BidMachine 3.5.1.

Wersja 3.5.0.0

• Zweryfikowana zgodność z pakietem SDK BidMachine w wersji 3.5.0.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.12.0.
• Wersja pakietu SDK BidMachine 3.5.0.

Wersja 3.4.0.2

• Dodano obsługę kaskadowego wyświetlania banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
• Usunęliśmy statyczną właściwość isTestMode z BidMachineAdapterExtras.
• Dodaliśmy weryfikację rozmiaru banera w przypadku kaskadowych banerów reklamowych.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.12.0.
• BidMachine SDK 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.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
• BidMachine SDK w wersji 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.
• Sprawdzona zgodność z pakietem BidMachine SDK w wersji 3.4.0.

Zaprojektowane i przetestowane z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.8.0.
• BidMachine SDK w wersji 3.4.0.