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 mediacji, w tym integracji z licytowaniem. Opisujemy w nim, jak dodać pakiet BIGO Ads SDK do konfiguracji mediacji 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.3 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 jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.
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 BIGO Ads SDK w interfejsie Ad Managera
Zaloguj się na konto Ad Managera.
Dodawanie pakietu BIGO Ads SDK 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 BIGO Ads SDK jako Sieć reklamową, wpisz unikalną Nazwę i włącz Zapośredniczanie.
Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.
Włączanie udostępniania bezpiecznych sygnałów
Określanie stawek
Otwórz Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, przejrzyj opcję Udostępnianie bezpiecznych sygnałów i włącz ją. 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 BIGO TECHNOLOGY PTE LTD i włącz opcję 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 przez pakiet SDK BIGO Ads
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 BIGO Ads SDK.
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ę dla pakietu BIGO Ads SDK.
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 miejsca uzyskany w poprzedniej sekcji.
Na koniec kliknij Zapisz.
Wodospad
Kliknij kolejno Wyświetlanie > Grupy zysku i przycisk Nowa grupa zysku. Wybierz Aplikacja mobilna.
Przewiń w dół i kliknij Dodaj partnera zysku.
Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby pakietu SDK BIGO Ads. Jako Rodzaj integracji wybierz Zapośredniczenie mobilne SDK, jako Platformę wybierz iOS, a jako Stan wybierz Aktywny.
Wpisz wartość uzyskaną w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.
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 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 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 Ad Managerze.
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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane 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.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
- BIGO Ads SDK w wersji 5.0.6.