Integracja pakietu BIGO Ads SDK z zapośredniczeniem

Wybierz platformę: Android Android iOS Unity

Z tego przewodnika dowiesz się, jak używać GMA Next-Gen SDK do wczytywania i wyświetlania reklam z pakietu SDK BIGO Ads za pomocą zapośredniczenia AdMob, w tym integracji z określaniem stawek. Dowiesz się, jak dodać pakiet SDK BIGO Ads do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK BIGO Ads i adapter z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla pakietu SDK BIGO Ads ma te możliwości:

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

¹ Integracja z określaniem stawek jest w fazie zamkniętych testów beta. Aby uzyskać dostęp, skontaktuj się z menedżerem konta.

Wymagania

• Android API w wersji 24 lub nowszej

• Najnowszy GMA Next-Gen SDK

• Wykonaj wszystkie czynności opisane w przewodniku dla początkujących dotyczącym zapośredniczenia

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu SDK BIGO Ads

Zaloguj się w panelu BIGO Ads.

Tworzenie aplikacji

Otwórz kartę Zasoby reklamowe i w tabeli Aplikacje i witryny kliknij przycisk + Dodaj.

Wypełnij resztę formularza i kliknij Prześlij.

Zanotuj identyfikator aplikacji.

Ważne: po utworzeniu nowej aplikacji zostanie ona oznaczona jako W trakcie sprawdzania. Zanim przejdziesz do następnych kroków, musisz sprawdzić aplikację.

Tworzenie boksu reklamowego

Gdy aplikacja zostanie sprawdzona, otwórz tabelę Boksy reklamowe i kliknij przycisk + Dodaj.

W polu Typ aukcji wybierz Określanie stawek przez serwer, wypełnij resztę formularza i kliknij Prześlij.

Zanotuj identyfikator boksu.

Zaktualizuj plik 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 utracie przychodów z reklam, użyj pliku app-ads.txt. Jeśli jeszcze tego nie zrobisz, skonfiguruj plik app-ads.txt dla swojej aplikacji.

Aby zaimplementować app-ads.txt w pakiecie SDK BIGO Ads, otwórz kartę APP-ads.txt w panelu Dashboard i postępuj zgodnie z instrukcjami na tej karcie.

Krok 2. Skonfiguruj popyt pakietu SDK BIGO Ads w interfejsie AdMob

Skonfiguruj ustawienia zapośredniczenia dla jednostki reklamowej

Musisz dodać pakiet SDK BIGO Ads do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie pakietu SDK BIGO Ads jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a następnie 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 1 z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Teraz powinna się wyświetlić karta jednostek reklamowych z wybranymi jednostkami:

Dodaj pakiet SDK BIGO Ads jako źródło 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 SDK BIGO Ads.



Kliknij Potwierdzam i akceptuję, a potem Dalej.



Jeśli masz już mapowanie dla pakietu SDK BIGO Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.



Następnie wpisz identyfikator boksu uzyskany w poprzedniej sekcji. Potem kliknij Gotowe.

Ważne: identyfikator aplikacji musi być powiązany z aplikacją docelową w interfejsie pakietu SDK BIGO Ads.

Dodaj BIGO TECHNOLOGY PTE LTD do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Ważne: aby skonfigurować zgodę użytkownika z UE, RODO, amerykańskie przepisy stanowe i platformę do wyświetlania wiadomości dla użytkowników, musisz mieć uprawnienie Zarządzanie kontem. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

Aby dodać BIGO TECHNOLOGY PTE LTD do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK BIGO Ads i adapter

Uwaga:brak integracji zgodnych wersji pakietu SDK BIGO Ads i pakietu SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

Integracja z Androidem Studio (zalecane)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bigo:5.9.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")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bigo:5.9.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. Zaimplementuj ustawienia prywatności w pakiecie SDK BIGO Ads

Aby przestrzegać polityki Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji swoim użytkownikom z Europejskiego Obszaru Gospodarczego, Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na korzystanie z plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać zgodę użytkowników na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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). Twoim obowiązkiem jest sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia. Google nie może automatycznie przekazywać wyboru zgody użytkownika do takich sieci.

Pakiet SDK BIGO Ads automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą , w tym pakiet SDK UMP. Więcej informacji znajdziesz w przewodniku integracji pakietu SDK BIGO Ads dotyczącym RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do wycofania zgody na „sprzedaż” swoich „danych osobowych” (definicje poszczególnych terminów zostały określone w ustawie). W tym celu sprzedający ma obowiązek umieścić na swojej stronie głównej dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google jest w stanie zastosować to ustawienie do każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować 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ść.

Poniższy przykładowy kod pokazuje, jak przekazać flagę zgody do pakietu SDK BIGO Ads. Wywołaj tę metodę przed wysłaniem żądania reklamy za pomocą GMA Next-Gen SDK.

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

Kotlin

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

Więcej informacji znajdziesz w przewodniku integracji pakietu SDK BIGO Ads dotyczącym ustawy CCPA.

Krok 5. Dodaj wymagany kod

Do integracji z pakietem SDK BIGO Ads nie jest potrzebny żaden dodatkowy kod.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w AdMob.

BIGO Ads udostępnia testowe identyfikatory aplikacji i identyfikatory boksu reklamowego na Android które ułatwiają testowanie i integrację.

**Ważne:** przed opublikowaniem aplikacji wyłącz tryb testowy w AdMob i pakiecie SDK BIGO Ads.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK BIGO Ads, włącz testowanie pojedynczych źródeł reklam w inspektorze reklam, używając źródła reklam BIGO Ads SDK (określanie stawek).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

Adapter pakietu SDK BIGO Ads zwraca reklamy natywne jako NativeAd obiekty. Wypełnia on te pola w przypadku obiektu NativeAd.

Pole	Zasoby zawsze uwzględniane przez adapter pakietu SDK BIGO Ads
Nagłówek
Obraz
Treść
Ikona
Wezwanie do działania
Ocena w gwiazdkach
Magazyn
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 za pomocą ResponseInfo.getAdSourceResponses() w tych klasach:

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

Oto kody i towarzyszące im komunikaty zwracane przez adapter pakietu SDK BIGO Ads, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
101	com.google.mediation.bigoadapter	Brakujący lub pusty identyfikator boksu Bigo.
1000–1100	Wysłane przez pakiet SDK BIGO Ads	Pakiet SDK BIGO Ads zwrócił błąd. Więcej informacji znajdziesz w dokumentacji pakietu SDK BIGO Ads.

Dziennik zmian adaptera zapośredniczenia Bigo na Androida

Następna wersja

• Mapuje AgeRestrictedTreatment na interfejs API COPPA firmy Bigo.

Wersja 5.9.0.0

• Sprawdzono zgodność z pakietem SDK Bigo Ads w wersji 5.9.0.

Kompilacja i testowanie:

• Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
• Pakiet SDK nowej generacji do reklam mobilnych Google w wersji 1.0.1.
• Pakiet SDK Bigo Ads w wersji 5.9.0.

Wersja 5.8.0.0

• Dodano właściwość umożliwiającą utworzenie adaptera z zależnością pakietu SDK nowej generacji do reklam mobilnych Google.
• Sprawdzono zgodność z pakietem SDK Bigo Ads w wersji 5.8.0.

Kompilacja i testowanie:

• Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
• Pakiet SDK Bigo Ads w wersji 5.8.0.

Wersja 5.7.1.0

• Sprawdzono zgodność z pakietem SDK Bigo Ads w wersji 5.7.1.

Kompilacja i testowanie:

• Pakiet SDK do reklam mobilnych Google w wersji 25.0.0.
• Pakiet SDK Bigo Ads w wersji 5.7.1.

Wersja 5.7.0.0

• Dodano obsługę przekazywania parametru tagForUnderAgeOfConsent pakietu SDK do reklam mobilnych Google do pakietu SDK Bigo Ads.
• Sprawdzono zgodność z pakietem SDK Bigo Ads w wersji 5.7.0.

Kompilacja i testowanie:

• Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
• Pakiet SDK Bigo Ads w wersji 5.7.0.

Wersja 5.5.2.0

• Dodano obsługę formatów reklam banerowych, pełnoekranowych, z nagrodą i natywnych.
• Sprawdzono zgodność z pakietem SDK Bigo Ads w wersji 5.5.2.

Kompilacja i testowanie:

• Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
• Pakiet SDK Bigo Ads w wersji 5.5.2.