Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z pakietu BIGO Ads SDK przy użyciu zapośredniczenia AdMob, w tym integracji z licytowaniem. Zawiera on informacje o tym, jak dodać pakiet BIGO Ads SDK do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet BIGO Ads SDK i adapter z aplikacją na iOS.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia dla pakietu BIGO Ads SDK ma te funkcje:
| Integracja | |
|---|---|
| Określanie stawek | 1 |
| Wodospad | |
| Formaty | |
| Przy otwarciu aplikacji | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Reklama pełnoekranowa z nagrodą | |
| Natywna | |
1 Integracja określania stawek jest w fazie zamkniętych testów beta. Aby poprosić o 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 pakietu BIGO Ads SDK
Zaloguj się w panelu BIGO Ads.
Tworzenie aplikacji
Otwórz kartę Asortyment i w tabeli Aplikacje i witryny kliknij przycisk + Dodaj.
Wypełnij pozostałe pola formularza i kliknij Prześlij.
Zanotuj identyfikator aplikacji.
Tworzenie boksu reklamowego
Gdy Twoja prośba zostanie rozpatrzona, otwórz tabelę Miejsca na reklamy i kliknij przycisk + Dodaj.
W sekcji Typ aukcji wybierz Licytowanie na serwerze, wypełnij pozostałe pola formularza i kliknij Prześlij.
Zanotuj identyfikator slota.
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 zaimplementować app-ads.txt w przypadku pakietu BIGO Ads SDK, na panelu kliknij kartę APP-ads.txt i postępuj zgodnie z instrukcjami na tej karcie.
Krok 2. Skonfiguruj popyt na pakiet SDK BIGO Ads w interfejsie AdMob
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać pakiet BIGO Ads SDK do konfiguracji zapośredniczenia w przypadku jednostki reklamowej.
Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie pakietu BIGO Ads SDK jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie pakietu SDK BIGO Ads jako źródła reklam
Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz BIGO Ads SDK.
Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z pakietem BIGO Ads SDK.
Kliknij Potwierdzam i akceptuję, a potem Dalej.
Jeśli masz już mapowanie pakietu SDK do reklam BIGO, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.
Dodawanie firmy BIGO TECHNOLOGY PTE LTD do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi
Aby dodać BIGO TECHNOLOGY PTE LTD 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 BIGO Ads i adapter
CocoaPods
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationBigo'W wierszu poleceń uruchom:
pod install --repo-update
Krok 4. Wdróż ustawienia prywatności w pakiecie BIGO Ads 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.
Pakiet BIGO Ads SDK automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO, która została ustawiona przez platformy do zarządzania zgodą użytkowników, w tym UMP SDK. Więcej informacji znajdziesz w przewodniku po integracji pakietu BIGO Ads SDK dotyczącym GDPR.
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.
Poniższy przykładowy kod pokazuje, jak przekazać flagę zgody do pakietu SDK BIGO Ads. Wywołaj tę metodę przed wysłaniem żądania reklam za pomocą funkcji Google Mobile Ads SDK.
Swift
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];
Więcej informacji znajdziesz w przewodniku po integracji pakietu BIGO Ads SDK dotyczącym CCPA.
Krok 5. Dodaj wymagany kod
Wdrażanie SKAdNetwork
Postępuj zgodnie z dokumentacją pakietu SDK BIGO Ads, 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.
BIGO Ads udostępnia testowe identyfikatory aplikacji i identyfikatory miejsc na reklamy na iOS, aby ułatwić testowanie i integrację.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu BIGO Ads SDK, włącz testowanie pojedynczych źródeł reklam w inspektorze reklam, korzystając ze źródeł reklam BIGO Ads SDK (licytowanie).
Kroki opcjonalne
Reklamy natywne
Renderowanie reklam
Adapter pakietu SDK BIGO Ads zwraca reklamy natywne jako obiekty
GADNativeAd. Wypełnia te polaGADNativeAd.
| Pole | Komponenty zawsze dołączane przez adapter pakietu BIGO Ads SDK |
|---|---|
| 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 pakietu SDK BIGO Ads, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:
GADMediationAdapterBigo
Oto kody i komunikaty wyświetlane przez adapter pakietu SDK BIGO Ads, gdy nie uda się wczytać reklamy:
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | W konfiguracji serwera brakuje wymaganego identyfikatora aplikacji. |
| 102 | com.google.ads.mediation.bigo | Nieprawidłowa konfiguracja reklamy. |
| 103 | com.google.ads.mediation.bigo | Nie udało się wyświetlić reklamy. |
| 104 | com.google.ads.mediation.bigo | Nieobsługiwany rozmiar banera. |
| 105 | com.google.ads.mediation.bigo | Bigo załadowało baner reklamowy, ale brakuje wyświetlenia reklamy. |
| 1000-1100 | Wysyłane przez pakiet SDK BIGO Ads | Pakiet SDK reklam BIGO zwrócił błąd. Więcej informacji znajdziesz w dokumentacji pakietu SDK reklam BIGO. |
Dziennik zmian adaptera mediacji BIGO Ads na iOS
Wersja 5.2.1.0
- Sprawdzona zgodność z pakietem SDK BIGO Ads w wersji 5.2.1.
- Aby korzystać z nowych interfejsów API związanych z ochroną prywatności, zaktualizuj minimalną zależność pakietu SDK do reklam mobilnych Google do wersji 13.3.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
- BIGO Ads SDK w wersji 5.2.1.
Wersja 5.2.0.0
- Sprawdzona zgodność z pakietem BIGO Ads SDK w wersji 5.2.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.4.0.
- BIGO Ads SDK w wersji 5.2.0.
Wersja 5.1.2.1
- Adapter przekazuje teraz flagę
ageRestrictedTreatmentpakietu SDK do reklam mobilnych Google do interfejsu API COPPA pakietu SDK do reklam BIGO.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
- BIGO Ads SDK w wersji 5.1.2.
Wersja 5.1.2.0
- Sprawdzona zgodność z pakietem SDK BIGO Ads w wersji 5.1.2.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
- BIGO Ads SDK w wersji 5.1.2.
Wersja 5.1.1.0
- Sprawdzona zgodność z pakietem SDK BIGO Ads w wersji 5.1.1.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
- BIGO Ads SDK w wersji 5.1.1.
Wersja 5.1.0.1
- Zaktualizowaliśmy adapter, aby zapobiegać niepowodzeniom żądań reklam, gdy baner reklamowy jest wczytywany z nieobsługiwanym rozmiarem reklamy.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
- BIGO Ads SDK w wersji 5.1.0.
Wersja 5.1.0.0
- Sprawdzona zgodność z pakietem BIGO Ads SDK w wersji 5.1.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
- BIGO Ads SDK w wersji 5.1.0.
Wersja 5.0.6.2
- Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
- BIGO Ads SDK w wersji 5.0.6.
Wersja 5.0.6.1
- Zaktualizowano minimalną wersję iOS w CocoaPods do
13.0.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
- BIGO Ads SDK w wersji 5.0.6.
Wersja 5.0.6.0
- Pierwsza wersja!
- Dodaliśmy obsługę określania stawek w przypadku formatów reklam wyświetlanych przy otwarciu aplikacji, banerów (w tym MREC), reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
- Sprawdzona zgodność z pakietem SDK BIGO Ads w wersji 5.0.6.
Zaprojektowano i przetestowano z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
- BIGO Ads SDK w wersji 5.0.6.