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. Wyjaśniamy w nim, 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 możliwości:

¹ W 2021 r. sieć Meta Audience Network przeszła na model tylko z licytowaniem.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Android w wersji API 24 lub nowszej.

• Adapter sieci Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja).

• Najnowsza wersja Google Mobile Ads SDK (Legacy).

• Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie Meta Audience Network

Zarejestruj się i zaloguj na stronie Business Manager Start.

Kliknij Rozpocznij, a potem 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 odpowiednią 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. Podaj niezbędne informacje, 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 oferty reklamowe Meta Audience Network w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

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

Kliknij Administracja > 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 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 licytowania w 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.

Jako licytującego wybierz Meta.

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ę dla 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 firmy Meta do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i  Ustawienia dotyczące przepisów stanowych w USA, aby dodać Meta do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Integracja z Androidem Studio (zalecana)

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

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

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

• Pobierz najnowszą wersję pakietu SDK Meta Audience Network na Androida. Wyodrębnij plik AudienceNetwork.aar z folderu AudienceNetwork/bin i dodaj go do projektu.

• Otwórz artefakty adaptera Meta Audience Network w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera Meta Audience Network i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

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.

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 w dokumentacji Meta dotyczącej RODO i reklam w 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 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.

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 reklam natywnych Meta Audience Network nie są mapowane jeden do jednego na komponenty reklam natywnych Google. Takie komponenty są przekazywane z powrotem do wydawcy w pakiecie za pomocą metody getExtras() w NativeAd. Adapter obsługuje przekazywanie tych komponentów:

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

Przykład:

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

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

Korzystanie z 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 reklamy banera natywnego Meta Audience Network.

Jeśli zamiast tego chcesz używać natywnych banerów reklamowych Meta Audience Network, podczas konfigurowania Meta Audience Network musisz wybrać formatNative Banner. Wtedy adapter automatycznie wczyta odpowiedni format reklamy natywnej.

Renderowanie reklam

Adapter sieci odbiorców zwraca reklamy natywne jako obiektyNativeAd. Wypełnia te polaNativeAd:

¹ 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 MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Tabela poniżej zawiera informacje o tym, kiedy Google Mobile Ads SDK (Legacy) rejestruje wyświetlenia reklam natywnych i kliknięcia.

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.

Zapisywanie w pamięci podręcznej na Androidzie 9

Od Androida 9 (poziom interfejsu API 28) obsługa tekstu jawnego jest domyślnie wyłączona, co wpłynie na funkcjonalność buforowania multimediów w pakiecie SDK Meta Audience Network i może mieć 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 Audience Network, możesz sprawdzić błąd w odpowiedzi na żądanie reklamy, używając metody ResponseInfo.getAdapterResponses() w tych klasach:

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:

Lista zmian adaptera zapośredniczenia Meta Audience Network na Androida

Wersja 6.22.0.1

• Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalnej wersji Kotlina obsługiwanej przez pakiet GMA NextGen SDK).
• Zaktualizowano, aby raportować wyświetlenie reklamy natywnej, gdy Meta rejestruje wyświetlenie reklam natywnych.

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.5.0.
• Meta Audience Network SDK w wersji 6.22.0.

Wersja 6.22.0.0

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

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.3.0.
• Pakiet SDK Meta Audience Network w wersji 6.22.0.

Wersja 6.21.0.4

• Mapuje ustawienia AgeRestrictedTreatment na ustawienia treści bez ograniczeń wiekowych w Meta Audience Network.
• 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.
• Usuń NativeAdBase i MediaView, gdy wywoływana jest funkcja untrackView, aby zwolnić zasoby.

Zaprojektowano i przetestowano z użyciem:

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

Zaprojektowano i przetestowano z użyciem:

• 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

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

Zaprojektowano i przetestowano z użyciem:

• 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 test, który powodował 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.
• Pakiet SDK Meta Audience Network 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.
• Meta Audience Network SDK 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

• Zweryfikowana 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.
• Pakiet SDK Meta Audience Network w wersji 6.18.0.

Wersja 6.17.0.0

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

Zbudowano i przetestowano z:

• 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

• Zweryfikowano 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.
• Pakiet SDK Meta Audience Network w wersji 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 wersji 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 21.5.0.

Zaprojektowano i przetestowano z użyciem:

• 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 Meta Audience Network SDK 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.
• Zaktualizowaliśmy minimalny wymagany poziom interfejsu API Androida do 19.

Zbudowano i przetestowano z:

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

Zbudowano i przetestowano z:

• 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 nie uda się wyświetlić reklam pełnoekranowych z określaniem stawek.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 20.6.0.

Zbudowano i przetestowano z:

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 6.7.0.0

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

Zbudowano i przetestowano z:

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

Wersja 6.6.0.0

• * Zweryfikowano 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.

Zbudowano i przetestowano z:

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

Zaprojektowano i przetestowano z użyciem:

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

Zbudowano i przetestowano z:

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

Wersja 6.5.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 20.1.0.
• Wersja pakietu SDK Facebooka 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 wersji 20.0.0.

Zbudowano i przetestowano z:

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

Wersja 6.3.0.1

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 6.3.0.0

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

Zaprojektowano i przetestowano z użyciem:

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

Zbudowano i przetestowano z:

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

Wersja 6.2.0.1

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

Zbudowano i przetestowano z:

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

Wersja 6.2.0.0

• Zweryfikowano 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 6.1.0.0

• Zweryfikowana zgodność z pakietem SDK Facebooka w wersji 6.1.0.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 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

• Zweryfikowana zgodność z pakietem Facebook SDK 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.
• Wersja pakietu SDK Facebooka 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.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 19.2.0.
• Wersja pakietu SDK Facebooka 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 określaniem stawek zawsze renderowały się na pełną 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.
• Wersja pakietu SDK Facebooka 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.
• Pakiet SDK Facebooka w wersji 5.9.0.

Wersja 5.8.0.2

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

Zbudowano i przetestowano z:

• 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 19.1.0.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 5.8.0.0

• Zweryfikowana 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.
• Dodaliśmy opisowe kody błędów i przyczyny niepowodzenia wczytywania/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ę reklam typu baner natywny na Facebooku 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

• Sprawdzona 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

• Zweryfikowano 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.

Zaprojektowano i przetestowano z użyciem:

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

Wersja 5.6.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 18.2.0.
• Wersja pakietu SDK Facebooka 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ń reklamy w inteligentnym banerze.
• Rozwiązaliśmy problem polegający na tym, że w niektórych przypadkach reklamy wideo z nagrodą nie przekazywały zdarzenia onAdClosed(), gdy aplikacja była w tle podczas odtwarzania filmu.
• Przeniesiono adapter do: 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ń reklam RTB w formacie natywnym.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 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.
• Dodano wersję adaptera do wywołania inicjowania.
• Zweryfikowana 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

• Zaktualizowano adapter, aby obsługiwał nowy interfejs API reklam z nagrodą w otwartej wersji beta.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do wersji 17.2.0.

Wersja 5.2.0.0

• Potwierdzona 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.
• Sprawdzona zgodność z pakietem Facebook SDK 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

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

Wersja 5.0.0.1

• Zaktualizowaliśmy adapter, aby obiekt reklamy z nagrodą był tworzony 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 polegający na tym, że w przypadku ujednoliconych reklam natywnych nie wyświetlała się ikona Informacja.
• Usunęliśmy błąd polegający na tym, że podczas próby pobrania obrazów adapter zgłaszał wyjątek.

Wersja 4.99.1.0

• Zweryfikowana 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

• Zweryfikowano 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

• Zweryfikowana 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, który powodował zwracanie banerów o nieprawidłowym rozmiarze.
• Zaktualizowano śledzenie widoku w przypadku reklam natywnych w adapterze, aby rejestrować poszczególne wyświetlenia komponentów w pakiecie SDK Facebooka, a nie cały widok reklamy. Oznacza to, że kliknięcia tła (lub „pustego miejsca”) reklamy natywnej nie będą już powodować przejść na stronę docelową.
• Potwierdzona 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

• Zweryfikowana 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

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

Wersja 4.21.0.0

• Zweryfikowana 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

• Zweryfikowana 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, który powodował, że wywołania zwrotne kliknięć reklam pełnoekranowych na Facebooku nie były prawidłowo przekazywane.
• 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