Integracja Meta Audience Network z określaniem stawek

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z Meta Audience Network za pomocą zapośredniczenia, w tym integracji z określaniem stawek. Dowiesz się z niego, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Meta Audience Network z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla Meta Audience Network ma te funkcje:

Integracja
Określanie stawek
Kaskadowe 1
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

1 W 2021 r. sieć Meta Audience Network przeszła na wyłącznie określanie stawek.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

  • Android API na poziomie 24 lub wyższym.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej Meta

Zarejestruj się i zaloguj na stronie Business Manager Start.

Kliknij kolejno Rozpocznij i Utwórz nowe konto.

Wypełnij wymagane pola informacjami o firmie i kliknij Dalej.

Tworzenie usługi

Po wypełnieniu wymaganych informacji pojawi się prośba o utworzenie usługi dla aplikacji. Wpisz wybraną nazwę usługi dla aplikacji i kliknij Dalej.

Następnie wybierz platformę, na której chcesz zarabiać.

Dodaj szczegóły aplikacji i kliknij Dalej.

Skonfiguruj konto płatności, klikając Dodaj nowe konto płatności. Przekierujemy Cię na nową stronę, na której możesz podać dane do płatności. Wypełnij niezbędne pola, a następnie kliknij Dalej.

Jako platformę zapośredniczenia wybierz Google Ad Managera, a następnie kliknij Utwórz miejsce docelowe.

Wybierz format, wypełnij formularz i kliknij Utwórz.

Zanotuj identyfikator miejsca docelowego.

Kliknij Gotowe.

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 znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

Informacje o wdrażaniu app-ads.txt w Meta Audience Network znajdziesz w artykule Identyfikowanie autoryzowanych sprzedawców za pomocą pliku app-ads.txt.

Włączanie trybu testowego

Szczegółowe instrukcje włączania reklam testowych Meta Audience Network znajdziesz w przewodniku po testowaniu implementacji Audience Network.

Krok 2. Skonfiguruj popyt Meta Audience Network w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Włączanie udostępniania bezpiecznych sygnałów

Kliknij kolejno Administracja i Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz opcję Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

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

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Facebook i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

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

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 określania stawek przez pakiet SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek Meta

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Wybierz Meta jako licytującego.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Konfigurowanie mapowania jednostki reklamowej

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę w Meta Audience Network.

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 docelowego uzyskany w poprzedniej sekcji.

Jeśli konfigurujesz mapowanie jednostek reklamowych na potrzeby reklamy pełnoekranowej z nagrodą w interfejsie Ad Managera, wybierz format Z nagrodą i użyj identyfikatora miejsca docelowego reklamy pełnoekranowej z nagrodą.

Na koniec kliknij Zapisz.

Dodawanie Meta do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Meta 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 i adapter Meta Audience Network

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

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:facebook:6.22.0.1")
}

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:facebook:6.22.0.1'
}

Integracja ręczna

Krok 4. Wdróż ustawienia prywatności w pakiecie Meta Audience Network SDK

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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.

Firma Meta nie jest zarejestrowana na globalnej liście dostawców IAB Europe. Zamiast tego musisz użyć specyfikacji technicznej Udzielenie dodatkowej zgody. Więcej informacji znajdziesz w artykule Składniki specyfikacji „Udzielenie dodatkowej zgody”. Specyfikacja dotycząca udzielenia dodatkowej zgody działa w połączeniu z Zasadami IAB Europe dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF) w wersji 2. Ta specyfikacja umożliwia Tobie, platformom do zarządzania zgodą użytkowników (CMP) i partnerom zbieranie oraz przesyłanie dodatkowych sygnałów dotyczących zgody w przypadku firm, które są zarejestrowane na liście dostawców technologii reklamowych Google (ATP), ale nie są jeszcze zarejestrowane na globalnej liście dostawców IAB Europe.

Postępuj zgodnie ze wskazówkami podanymi w dokumentacji Meta dotyczącej RODO i reklam Meta.

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 amerykańskich przepisach stanowych o ochronie danych osobowych 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 ł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.

Aby dowiedzieć się, jakie masz opcje przetwarzania danych użytkowników z Kalifornii, zapoznaj się z dokumentacją firmy Meta.

Krok 5. Dodaj wymagany kod

Integracja z siecią Meta Audience Network nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w usłudze Ad Manager i włączono tryb testowy w interfejsie Meta Audience Network.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Meta Audience Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Reklamy natywne

Niektóre komponenty reklamy natywnej w sieci Meta Audience Network nie są mapowane w stosunku 1:1 na komponenty reklamy natywnej w Google. Takie komponenty są przekazywane z powrotem do wydawcy w pakiecie za pomocą metody getExtras() w NativeAd. Adapter obsługuje przekazywanie tych komponentów:

Parametry i wartości żądania
FacebookMediationAdapter.KEY_ID Ciąg znaków. Unikalny identyfikator reklamy natywnej
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET Ciąg znaków. Kontekst społecznościowy reklamy

Oto przykładowy kod pokazujący, jak wyodrębnić te zasoby:

Przykład:

Java

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
  // ...
}

Kotlin

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  val socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Używanie reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej Meta Audience Network wymaga renderowania zasobu MediaView. Jeśli planujesz renderować reklamy natywne bez tego komponentu, użyj formatu banera natywnego Meta Audience Network.

Aby zamiast tego używać natywnych banerów reklamowych Meta Audience Network, podczas konfigurowania Meta Audience Network musisz wybrać format Native Banner, a adapter automatycznie wczyta odpowiedni format reklamy natywnej.

Renderowanie reklam

Adapter sieci odbiorców zwraca reklamy natywne jako obiektyNativeAd. Wypełnia te pola dla NativeAd.

Pole Wypełniane przez adapter Meta Audience Network
Nagłówek
Obraz 1
Treść
Ikona aplikacji
Wezwanie do działania
Nazwa reklamodawcy
Ocena w gwiazdkach
Sklep
Cena

1 Adapter Meta Audience Network nie zapewnia bezpośredniego dostępu do głównego komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia element MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Poniższa tabela pokazuje, kiedy Google Mobile Ads SDK (Legacy) rejestruje wyświetlenia reklam i kliknięcia reklam natywnych.

Rejestrowanie wyświetleń Nagrywanie kliknięć
1 piksel komponentu reklamy natywnej Meta Audience Network na ekranie + wymagania dotyczące renderowania komponentu Wywołanie zwrotne pakietu SDK Meta Audience Network

Meta Audience Network ma określone wymagania dotyczące renderowania komponentów, które muszą zostać spełnione, aby wyświetlenie zostało uznane za prawidłowe. Zależą one od tego, czy podczas konfigurowania Meta Audience Network wybrano format Natywny czy Baner natywny.

Format natywny Meta Audience Network Wymagany komponent Wymagana klasa renderowania
Natywna Widok multimediów MediaView
Baner natywny Ikona aplikacji ImageView

Zapisywanie w pamięci podręcznej na Androidzie 9

Począwszy od Androida 9 (poziom interfejsu API 28), obsługa tekstu nieszyfrowanego jest domyślnie wyłączona, co wpływa na funkcję buforowania multimediów w pakiecie SDK Meta Audience Network i może mieć negatywny wpływ na wrażenia użytkowników oraz przychody z reklam. Aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji, postępuj zgodnie z dokumentacją Meta.

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci Audience Network, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo.getAdapterResponses()  tych klas:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

Oto kody i towarzyszące im komunikaty, które adapter Audience Network wyświetla, gdy nie uda się wczytać reklamy:

Kod błędu Przyczyna
101 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
102 Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez sieć Meta Audience Network.
103 Wydawca musi żądać reklam w kontekście Activity.
104 Nie udało się zainicjować pakietu SDK Meta Audience Network.
105 Wydawca nie poprosił o wyświetlanie ujednoliconych reklam natywnych.
106 Wczytana reklama natywna jest innym obiektem niż oczekiwany.
107 Użyty obiekt Context jest nieprawidłowy.
108 W załadowanej reklamie brakuje wymaganych komponentów reklamy natywnej.
109 Nie udało się utworzyć reklamy natywnej na podstawie danych o stawce.
110 Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej ani reklamy z nagrodą.
111 Podczas tworzenia obiektu Meta Audience Network AdView wystąpił wyjątek.
1000-9999 Meta Audience Network zwróciła błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network.

Lista zmian adaptera zapośredniczenia Meta Audience Network na Androida

Następna wersja

  • Oczyszczanie komponentów reklam natywnych podczas wczytywania i ścieżek błędów mapowania.
  • Zastąp NativeAdMapper.destroy(), aby wyczyścić cykl życia reklamy natywnej.

Wersja 6.22.0.1

  • Przypnij zależność Kotlin adaptera do wersji 1.9.0 (minimalna wersja Kotlin obsługiwana przez pakiet SDK nowej generacji do reklam mobilnych Google).
  • Zaktualizowano raportowanie wyświetleń reklam natywnych, gdy Meta rejestruje wyświetlenia reklam natywnych.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.5.0.
  • Pakiet SDK Meta Audience Network w wersji 6.22.0.

Wersja 6.22.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.22.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.3.0.
  • Pakiet SDK Meta Audience Network w wersji 6.22.0.

Wersja 6.21.0.4

  • Mapuje parametr AgeRestrictedTreatment na ustawienia Meta Audience Network dotyczące treści bez ograniczeń wiekowych.
  • Rozwiązaliśmy problem z wyciekiem pamięci w przypadku reklam pełnoekranowych.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
  • Pakiet SDK Meta Audience Network w wersji 6.21.0.

Wersja 6.21.0.3

  • Zaktualizowano implementację reklam natywnych, aby korzystała ze zaktualizowanego interfejsu API NativeAdMapper.
  • Po wywołaniu metody untrackView zniszcz obiekty NativeAdBase i MediaView, aby zwolnić zasoby.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
  • Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 0.25.0-beta01.
  • Pakiet SDK Meta Audience Network w wersji 6.21.0.

Wersja 6.21.0.2

  • Dodano właściwość umożliwiającą utworzenie adaptera z zależnością od pakietu SDK nowej generacji do reklam mobilnych Google.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
  • Pakiet SDK Meta Audience Network w wersji 6.21.0.

Wersja 6.21.0.1

  • Dodano obsługę przekazywania parametru pakietu SDK do tagForUnderAgeOfConsentreklam mobilnych Google do pakietu SDK Meta Audience Network.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
  • Pakiet SDK Meta Audience Network w wersji 6.21.0.

Wersja 6.21.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.21.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
  • Pakiet SDK Meta Audience Network w wersji 6.21.0.

Wersja 6.20.0.2

  • Usunięto odwołania na poziomie klasy do obiektów Context, aby rozwiązać problemy z wyciekiem pamięci.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
  • Pakiet SDK Meta Audience Network w wersji 6.20.0.

Wersja 6.20.0.1

  • Usunięto sprawdzanie, które powodowało niepowodzenie inicjowania, jeśli nie było identyfikatorów miejsc docelowych. Usunęliśmy to, aby umożliwić działanie RTB, nawet jeśli wydawca nie zdefiniuje mapowań jednostek reklamowych.
  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.20.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.6.0.
  • Meta Audience Network SDK w wersji 6.20.0.

Wersja 6.20.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.20.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.2.0.
  • Pakiet SDK Meta Audience Network w wersji 6.20.0.

Wersja 6.19.0.1

  • Zaktualizowano minimalny wymagany poziom interfejsu Android API do 23.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 24.0.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
  • Wersja pakietu Meta Audience Network SDK 6.19.0.

Wersja 6.19.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.19.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.6.0.
  • Wersja pakietu Meta Audience Network SDK 6.19.0.

Wersja 6.18.0.0

  • Zweryfikowano zgodność z pakietem SDK Meta Audience Network w wersji 6.18.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.3.0.
  • Wersja pakietu SDK Meta Audience Network 6.18.0.

Wersja 6.17.0.0

  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 23.0.0.
  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.17.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 23.0.0.
  • Pakiet SDK Meta Audience Network w wersji 6.17.0.

Wersja 6.16.0.0

  • Zaktualizowano adapter, aby wywoływał metodę MediationInterstitialAdCallback#onAdFailedToShow() w sytuacji, gdy pakiet SDK Meta zgłosi, że nie udało się wyświetlić reklamy pełnoekranowej.
  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.16.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.3.0.
  • Pakiet SDK Meta Audience Network w wersji 6.16.0.

Wersja 6.15.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.15.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 22.2.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.2.0.
  • Meta Audience Network SDK w wersji 6.15.0.

Wersja 6.14.0.0

  • Zweryfikowano zgodność z pakietem SDK Meta Audience Network w wersji 6.14.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Wersja pakietu SDK Meta Audience Network 6.14.0.

Wersja 6.13.7.1

  • Zaktualizowano adapter, aby używał nowej klasy VersionInfo.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 22.0.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Pakiet SDK Meta Audience Network w wersji 6.13.7.

Wersja 6.13.7.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.13.7.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Pakiet SDK Meta Audience Network w wersji 6.13.7.

Wersja 6.12.0.0

  • Zweryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.12.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 21.2.0.
  • Zmieniono nazwę adaptera na „Meta Audience Network”.
  • Usunięto integrację kaskadową.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.2.0.
  • Pakiet SDK Meta Audience Network w wersji 6.12.0.

Wersja 6.11.0.1

  • Zaktualizowano compileSdkVersion i targetSdkVersion do interfejsu API na poziomie 31.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 21.0.0.
  • Zaktualizowano minimalny wymagany poziom interfejsu API Androida do 19.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.0.0.
  • Wersja pakietu SDK Facebooka 6.11.0.

Wersja 6.11.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.11.0.
  • Dodaliśmy komunikaty ostrzegawcze dotyczące wycofania zapośredniczenia kaskadowego. Więcej informacji znajdziesz na blogu Meta.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
  • Pakiet SDK Facebooka w wersji 6.11.0.

Wersja 6.10.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 6.10.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
  • Wersja pakietu SDK Facebooka 6.10.0.

Wersja 6.8.0.1

  • Dodaliśmy obsługę przekazywania wywołań zwrotnych dotyczących kliknięć i wyświetleń w reklamach z ustalaniem stawek.
  • Dodaliśmy obsługę przekazywania wywołania zwrotnego onAdFailedToShow(), gdy reklamy pełnoekranowe z ustalaniem stawek nie mogą się wyświetlić.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 20.6.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.6.0.
  • Wersja pakietu SDK Facebooka 6.8.0.

Wersja 6.8.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.8.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.4.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.4.0.
  • Pakiet SDK Facebooka w wersji 6.8.0.

Wersja 6.7.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 6.7.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.3.0.
  • Wersja pakietu SDK Facebooka 6.7.0.

Wersja 6.6.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.6.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.3.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.3.0.
  • Wersja pakietu SDK Facebooka 6.6.0.

Wersja 6.5.1.1

  • Naprawiliśmy błąd wprowadzony w wersji 6.5.1.0, który powodował, że zamiast rzeczywistych reklam zwracane były reklamy testowe.
  • Zaktualizowano adapter, aby korzystał z nowego interfejsu API AdError.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.2.0.
  • Wersja pakietu SDK Facebooka 6.5.1.

Wersja 6.5.1.0 (wycofana)

  • Wykryliśmy i potwierdziliśmy problem z wersją 6.5.1.0. Zalecamy uaktualnienie do wersji 6.5.1.1.
  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.5.1.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 20.2.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.2.0.
  • Wersja pakietu SDK Facebooka 6.5.1.

Wersja 6.5.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.5.0.
  • Rozwiązaliśmy problem, który powodował, że reklamy natywne nie zawierały zdjęcia w tle z Facebooka.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.1.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
  • Pakiet SDK Facebooka w wersji 6.5.0.

Wersja 6.4.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 6.4.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 20.0.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 20.0.0.
  • Wersja pakietu SDK Facebooka 6.4.0.

Wersja 6.3.0.1

  • Rozwiązaliśmy problem, który powodował zgłaszanie błędu ClassCastException podczas renderowania reklam natywnych w aplikacjach, które nie używają ImageView do renderowania komponentów z obrazem.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.7.0.
  • Pakiet SDK Facebooka w wersji 6.3.0.

Wersja 6.3.0.0

  • Sprawdzona zgodność z pakietem Facebook SDK w wersji 6.3.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.7.0.
  • Wersja pakietu SDK Facebooka 6.3.0.

Wersja 6.2.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.2.1.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.7.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.7.0.
  • Wersja pakietu SDK Facebooka 6.2.1.

Wersja 6.2.0.1

  • Usunęliśmy obsługę wycofanego formatu NativeAppInstallAd. Aplikacje powinny wysyłać żądania dotyczące ujednoliconych reklam natywnych.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.6.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.6.0.
  • Wersja pakietu SDK Facebooka 6.2.0.

Wersja 6.2.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.2.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.5.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.5.0.
  • Pakiet SDK Facebooka w wersji 6.2.0.

Wersja 6.1.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 6.1.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.4.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.4.0.
  • Wersja pakietu SDK Facebooka 6.1.0.

Wersja 6.0.0.0

  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 6.0.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.3.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.3.0.
  • Wersja pakietu SDK Facebooka: 6.0.0.

Wersja 5.11.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.11.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
  • Wersja pakietu SDK Facebooka: 5.11.0.

Wersja 5.10.1.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.10.1.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
  • Pakiet SDK Facebooka w wersji 5.10.1.

Wersja 5.10.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.10.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
  • Wersja pakietu SDK Facebooka 5.10.0.

Wersja 5.9.1.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.9.1.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
  • Pakiet SDK Facebooka w wersji 5.9.1.

Wersja 5.9.0.2

  • Dodaliśmy obsługę reklam pełnoekranowych z nagrodą.
  • Zaktualizowano adapter, aby obsługiwał żądania śródtekstowych banerów adaptacyjnych.
  • Rozwiązaliśmy problem, który powodował, że banery reklamowe z licytacją zawsze renderowały się na całą szerokość.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.2.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
  • Pakiet SDK Facebooka w wersji 5.9.0.

Wersja 5.9.0.1

  • Adapter przekazuje teraz błąd, jeśli pakiet SDK FAN napotka błąd podczas wyświetlania reklamy pełnoekranowej lub reklamy z nagrodą.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
  • Pakiet SDK Facebooka w wersji 5.9.0.

Wersja 5.9.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.9.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
  • Wersja pakietu SDK Facebooka 5.9.0.

Wersja 5.8.0.2

  • Naprawiliśmy nieprawidłowe odwołanie do zmiennej, które w określonych sytuacjach powodowało awarię podczas wczytywania reklam natywnych.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
  • Wersja pakietu SDK Facebooka 5.8.0.

Wersja 5.8.0.1

  • Dodano dodatkowe opisowe kody błędów i przyczyny niepowodzeń wczytywania lub wyświetlania adaptera.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 19.1.0.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.1.0.
  • Wersja pakietu SDK Facebooka 5.8.0.

Wersja 5.8.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.8.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 19.0.1.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 19.0.1.
  • Pakiet SDK Facebooka w wersji 5.8.0.

Wersja 5.7.1.1

  • Dodaliśmy obsługę błędów adaptera Facebook Audience Network.
  • Dodano opisowe kody błędów i przyczyny niepowodzeń wczytywania lub wyświetlania adaptera.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Pakiet SDK Facebooka w wersji 5.7.1.

Wersja 5.7.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 5.7.1.
  • Dodaliśmy obsługę natywnych banerów reklamowych Facebooka podczas korzystania z określania stawek.
  • Reklamy natywne używają teraz zasobu „Drawable” jako komponentu ikony.

Zaprojektowano i przetestowano z użyciem:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Pakiet SDK Facebooka w wersji 5.7.1.

Wersja 5.7.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.7.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Wersja pakietu SDK Facebooka 5.7.0.

Wersja 5.6.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 5.6.1.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.3.0.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.3.0.
  • Pakiet SDK Facebooka w wersji 5.6.1.

Wersja 5.6.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.6.0.
  • Zaktualizowano adapter Facebooka, aby używać AdChoicesView.

Zbudowano i przetestowano z:

  • Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
  • Pakiet SDK Facebooka w wersji 5.6.0.

Wersja 5.5.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.5.0.

Wersja 5.4.1.1

  • Rozwiązaliśmy problem, który powodował awarię po usunięciu reklam natywnych.

Wersja 5.4.1.0

  • Zweryfikowana zgodność z pakietem Facebook SDK w wersji 5.4.1.
  • Dodaliśmy obsługę natywnych banerów reklamowych na Facebooku w przypadku zapośredniczenia kaskadowego.
    • Używaj setNativeBanner() z klasy FacebookExtras, aby wysyłać żądania dotyczące banerów reklam natywnych.
  • Rozwiązaliśmy problem, który powodował niepowodzenie żądań inteligentnych banerów reklamowych.
  • Rozwiązaliśmy problem, który powodował, że w niektórych przypadkach, gdy aplikacja działała w tle podczas odtwarzania filmu, reklamy wideo z nagrodą nie przekazywały zdarzenia onAdClosed().
  • Przeniesiono adapter do domeny AndroidX.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 18.1.1.

Wersja 5.4.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.4.0.

Wersja 5.3.1.2

  • Naprawiliśmy błąd, który powodował, że nie można było zainicjować określania stawek na Facebooku z powodu braku identyfikatorów miejsc docelowych.

Wersja 5.3.1.1

  • Zaktualizowano śledzenie wyświetleń natywnych reklam RTB.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 17.2.1.

Wersja 5.3.1.0

  • Dodano do adaptera możliwość określania stawek w przypadku banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 5.3.1.

Wersja 5.3.0.0

  • Zaktualizowano nazwę usługi zapośredniczenia w przypadku reklam mobilnych Google.
  • Dodaliśmy wersję adaptera do wywołania inicjowania.
  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 5.3.0.

Wersja 5.2.0.2

  • Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.

Wersja 5.2.0.1

  • Zaktualizowany adapter obsługujący nowy interfejs Rewarded API w ramach otwartej wersji beta.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 17.2.0.

Wersja 5.2.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 5.2.0.

Wersja 5.1.1.1

  • Zaktualizowano adapter, aby wypełniał nazwę reklamodawcy w ujednoliconych reklamach natywnych.

Wersja 5.1.1.0

  • Zastąpiono widok Informacja widokiem AdOptions.
  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 5.1.1.

Wersja 5.1.0.1

  • Rozwiązaliśmy problem z błędem ANR spowodowanym przez „getGMSVersionCode()”.

Wersja 5.1.0.0

  • Zainicjuj pakiet SDK Facebooka dla każdego formatu reklamy.

Wersja 5.0.1.0

  • Zweryfikowana zgodność z pakietem Facebook SDK w wersji 5.0.1.

Wersja 5.0.0.1

  • Zaktualizowano adapter, aby tworzył obiekt reklamy z nagrodą w momencie żądania reklamy.

Wersja 5.0.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 5.0.0.

Wersja 4.99.3.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.99.3.

Wersja 4.99.1.1

  • Naprawiliśmy błąd, który powodował, że ikona Informacja nie wyświetlała się w ujednoliconych reklamach natywnych.
  • Naprawiliśmy błąd, który powodował, że adapter zgłaszał wyjątek podczas próby pobrania obrazów.

Wersja 4.99.1.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.99.1.

Wersja 4.28.2.1

  • Zaktualizowano adapter, aby wywoływał zdarzenie reklamy onRewardedVideoComplete().

Wersja 4.28.2.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.28.2.

Wersja 4.28.1.1

  • Rozwiązaliśmy problem, który powodował, że kliknięcia nie były rejestrowane w przypadku ujednoliconych reklam natywnych.

Wersja 4.28.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.28.1.

Wersja 4.28.0.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.28.0.

Wersja 4.27.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.27.1.

Wersja 4.27.0.0

  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 4.27.0.

Wersja 4.26.1.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.26.1.
  • Zaktualizowano projekt Adaptera dla Androida Studio 3.0

Wersja 4.26.0.0

  • Dodaliśmy obsługę reklam wideo z nagrodą.
  • Dodaliśmy obsługę natywnych reklam wideo.
  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.26.0.

Wersja 4.25.0.0

  • Rozwiązaliśmy problem polegający na tym, że zwracane były banery o nieprawidłowym rozmiarze.
  • Zaktualizowaliśmy śledzenie wyświetleń przez adapter w przypadku reklam natywnych, aby rejestrować wyświetlenia poszczególnych komponentów za pomocą pakietu SDK Facebooka, a nie wyświetlenia całej reklamy. Oznacza to, że kliknięcia tła (lub „pustego miejsca”) reklamy natywnej nie będą już powodować przejść na stronę docelową.
  • Sprawdzona zgodność z pakietem SDK Facebooka w wersji 4.25.0.

Wersja 4.24.0.0

  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 4.24.0.

Wersja 4.23.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.23.0.

Wersja 4.22.1.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.22.1.

Wersja 4.22.0.0

  • Zaktualizowano adapter, aby był zgodny z pakietem SDK Facebooka w wersji 4.22.0.

Wersja 4.21.1.0

  • Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 4.21.1.

Wersja 4.21.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.21.0.

Wersja 4.20.0.0

  • Zaktualizowaliśmy minimalny obsługiwany poziom interfejsu Android API do 14+.
  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 4.20.0.

Wersja 4.19.0.0

  • Potwierdzona zgodność z pakietem SDK Facebooka w wersji 4.19.0.

Wersja 4.18.0.0

  • Zweryfikowano zgodność z pakietem SDK Facebooka w wersji 4.18.0.

Wersja 4.17.0.0

  • Dodaliśmy obsługę reklam natywnych.

Wersja 4.15.0.0

  • Zmieniono system nazewnictwa wersji na [wersja pakietu SDK FAN].[wersja poprawki adaptera].
  • Zaktualizowano minimalną wymaganą wersję pakietu FAN SDK do 4.15.0.
  • Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 9.2.0.
  • Naprawiliśmy błąd polegający na tym, że wywołania zwrotne kliknięć Facebooka w przypadku reklam pełnoekranowych nie były przekazywane prawidłowo.
  • Adapter przekazuje teraz też wywołanie zwrotne onAdLeftApplication, gdy użytkownik kliknie reklamę.

Wersja 1.2.0

  • Naprawiliśmy błąd, dzięki czemu AdSize.SMART_BANNER jest teraz prawidłowym rozmiarem.

Wersja 1.1.0

  • Dodaliśmy obsługę formatu o pełnej szerokości x 250, gdy żądanie dotyczyło formatu AdSize.MEDIUM_RECTANGLE

Wersja 1.0.1

  • Dodaliśmy obsługę AdSize.SMART_BANNER.

Wersja 1.0.0

  • Pierwsza wersja