Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Meta Audience Network za pomocą zapośredniczenia. Omówiono też integracje licytacji. Przewodnik zawiera informacje o dodawaniu Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz o integrowaniu Meta Audience Network i adaptera z aplikacją Unity .
Obsługiwane integracje i formaty reklam
AdMob Zastosowanie zapośredniczenia w przypadku sieci Meta Audience Network:
Integracja | |
---|---|
Określanie stawek | |
Kaskada 1 | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą |
1 W 2021 r. sieć Meta Audience Network stała się siecią tylko do licytowania.
Wymagania
- Najnowsza wersja pakietu SDK do reklam mobilnych Google
- Unity w wersji 5.6 lub nowszej
- Wtyczka reklam mobilnych Google do zapośredniczenia w Meta Audience Network w wersji 2.11.0 (zalecana najnowsza wersja)
- Aby wdrożyć na Androidzie:
- poziom interfejsu API 21 lub nowszy,
- Aby wdrożyć aplikację na iOS:
- docelowa wersja iOS: 10.0 lub nowsza,
- Najnowsza wersja pakietu SDK Meta Audience Network zwykle wymaga najnowszej wersji Xcode.
- działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
- Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.
Krok 1. Skonfiguruj ustawienia w interfejsie Meta Audience Network
Zarejestruj się i zaloguj na stronie początkowej Business Managera.
Kliknij kolejno Rozpocznij i Utwórz nowe konto.
Wypełnij wymagane pola danymi swojej firmy i kliknij Dalej.
Tworzenie usługi
Gdy wypełnisz wymagane informacje, pojawi się prośba o utworzenie usługi dla aplikacji. Wpisz jej nazwę i kliknij Dalej.
Następnie wybierz platformę, na której chcesz zarabiać.
Dodaj szczegóły aplikacji i kliknij Dalej.
Android
iOS
Skonfiguruj konto płatności, klikając Dodaj nowe konto płatności. Przekierujemy Cię na nową stronę, na której możesz podać informacje o płatności. Podaj niezbędne informacje, a potem kliknij Dalej.
Jako platformę pośrednictwa wybierz Google AdMob, a potem kliknij Utwórz miejsce docelowe.
Wybierz format, wypełnij formularz i kliknij Utwórz.
Zanotuj identyfikator miejsca docelowego.
Kliknij Gotowe.
Włączanie trybu testowego
Szczegółowe instrukcje dotyczące włączania testowych reklam w sieci Audience Network znajdziesz w przewodniku Testowanie implementacji Audience Network.
Krok 2. Skonfiguruj zapotrzebowanie na reklamy z sieci Audience Network w AdMob interfejsie
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.
iOS
Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym iOS.
Dodawanie Facebook do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA
Aby dodać Meta do listy partnerów reklamowych w interfejsie AdMob zgodnych z RODO i przepisami stanowymi w USA, wykonaj czynności opisane w sekcji Ustawienia dotyczące RODO i Ustawienia dotyczące przepisów stanowych w USA.
Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network
OpenUPM-CLI
Jeśli masz zainstalowane OpenUPM-CLI, możesz zainstalować w projekcie wtyczkę do zapośredniczenia Google Mobile Ads w Meta Audience Network w Unity, uruchamiając w katalogu głównym projektu podane niżej polecenie:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.
Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakres:
com.google
Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.
Wybierz pakiet Google Mobile Ads Meta Audience Network Mediation i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Meta Audience Network z linku do pobrania w Changelog i rozpakuj plik zipGoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązanie Androida > Wymuś rozwiązanie. Biblioteka menedżera zależności zewnętrznej wykona rozwiązanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
Twojej aplikacji Unity.
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Audience Network firmy Meta
Zgoda użytkowników z UE i RODO
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.
Aby dowiedzieć się więcej o RODO i reklamach w Meta, zapoznaj się z wskazówkami tej firmy.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.
W przypadku użytkowników z Kalifornii zapoznaj się z opcjami przetwarzania danych w Meta.
Krok 5. Dodaj wymagany kod
Android
Integracja z siecią Meta Audience Network nie wymaga dodatkowego kodu.
iOS
Integracja z SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją Audience Network.
Śledzenie reklam włączone
Jeśli aplikacja jest przeznaczona na iOS 14 lub nowszy, zapoznaj się z instrukcjami Meta Audience Network dotyczącymi ustawiania flagi śledzenia reklam.
Krok 6. Przetestuj implementację
Włączanie reklam testowych
Zarejestruj urządzenie testowe w AdMob i włącz tryb testowy w interfejsie Meta Audience Network.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z Meta Audience Network, włącz testowanie pojedynczego źródła reklam w inspektorze reklam za pomocą źródeł reklam Meta Audience Network (z określaniem stawek).
Kroki opcjonalne:
Pamięć podręczna w Androidzie 9
Android
Od Androida 9 (poziom interfejsu API 28) obsługa tekstu zwykłego jest domyślnie wyłączona, co wpłynie na działanie funkcji buforowania multimediów w pakiecie Audience Network SDK firmy Meta 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.
iOS
Nie dotyczy integracji z iOS.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Audience Network, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z elementu ResponseInfo
w ramach tych klas:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Oto kody i dodatkowe komunikaty zwracane przez adapter sieci Meta Audience Network, gdy nie udaje się załadować reklamy:
Android
Kod błędu | Przyczyna |
---|---|
101 | nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
102 | Żądany rozmiar reklamy nie jest zgodny z obsługiwanym przez sieć Meta Audience Network rozmiarem banera. |
103 | Wydawca musi poprosić o reklamy z kontekstem Activity . |
104 | Nie udało się zainicjować pakietu SDK Meta Audience Network. |
105 | Wydawca nie wysłał żądania ujednoliconych reklam natywnych. |
106 | Wczytana reklama natywną jest innym obiektem niż oczekiwany. |
107 | Użyty obiekt Context jest nieprawidłowy. |
108 | Załadowana reklama nie zawiera wymaganych komponentów reklam natywnych. |
109 | Nie udało się utworzyć reklamy natywnej na podstawie danych o stawce. |
110 | Pakiet SDK Meta Audience Network nie wyświetlił reklamy przejściowej ani reklamy z nagrodą. |
111 | Wyjątek wywołany podczas tworzenia obiektu AdView sieci Meta Audience Network. |
1000-9999 | Meta Audience Network zwrócił błąd związany z SDK. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Audience Network. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego). |
102 | Żądany rozmiar reklamy nie jest zgodny z obsługiwanym przez sieć Meta Audience Network rozmiarem banera. |
103 | Nie udało się zainicjować obiektu reklamy Meta Audience Network. |
104 | Pakiet SDK Meta Audience Network nie wyświetlił reklamy przejściowej ani reklamy z nagrodą. |
105 | Element główny widoku banera reklamowego to nil . |
106 | Nie udało się zainicjować pakietu SDK Meta Audience Network. |
1000-9999 | Meta Audience Network zwrócił błąd związany z SDK. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Audience Network. |
Informacje o zmianach w pliku z aktualizacjami wtyczki zapośredniczenia Meta Audience Network dla Unity
Wersja 3.14.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.18.0.
- Obsługuje adapter iOS Meta Audience Network w wersji 6.16.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 3.13.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.18.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.15.2.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.3.0.
Wersja 3.13.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.18.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.15.2.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 3.12.2
- Obsługuje adapter Androida Meta Audience Network w wersji 6.17.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.15.2.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.2.0.
Wersja 3.12.1
- Obsługuje adapter Androida Meta Audience Network w wersji 6.17.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.15.1.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.1.0.
Wersja 3.12.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.17.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.15.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 9.0.0.
Wersja 3.11.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.15.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.14.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.5.1.
Wersja 3.10.0
- Treść adaptera została przeniesiona do
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Obsługuje adapter Meta Audience Network na Androida w wersji 6.14.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.12.0.1.
- Została ona utworzona i przetestowana z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 8.1.0.
Wersja 3.9.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.12.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.12.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.4.1.
Wersja 3.9.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.12.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.12.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.3.0.
Wersja 3.8.0
- Zmieniliśmy nazwę wtyczki do zapośredniczenia Unity na „Meta Audience Network”.
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.11.0.1.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.11.1.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.2.
Wersja 3.7.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.10.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.10.0.0.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 3.6.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.8.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.9.0.1.
- Skompilowano i przetestowano z użyciem wtyczki reklam mobilnych Google dla środowiska Unity w wersji 7.0.0.
Wersja 3.6.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.8.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.8.0.0.
Wersja 3.5.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.7.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.7.0.0.
Wersja 3.4.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.6.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.6.0.0.
Wersja 3.3.2
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.5.1.1.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.5.1.0.
Wersja 3.3.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.5.1.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.5.1.0.
Wersja 3.3.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.4.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.4.1.0.
Wersja 3.2.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.2.0.1.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.2.1.0.
Wersja 3.1.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.2.0.0.
- Obsługuje adapter iOS Meta Audience Network w wersji 6.2.0.0.
Wersja 3.0.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 6.1.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 6.0.0.0.
Wersja 2.12.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.11.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.10.1.0.
Wersja 2.11.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.10.1.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.10.1.0.
Wersja 2.11.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.10.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.10.0.0.
Wersja 2.10.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.9.1.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.9.0.1.
Wersja 2.9.2
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.9.0.2.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.9.0.1.
Wersja 2.9.1
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.9.0.1.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.9.0.1.
Wersja 2.9.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.9.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.9.0.0.
Wersja 2.8.1
- Obsługuje adapter Androida Meta Audience Network w wersji 5.8.0.1.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.8.0.2.
Wersja 2.8.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.8.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.8.0.1.
Wersja 2.7.1 (wycofana, użyj wersji 2.8.0 lub nowszej)
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.7.1.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.7.1.1.
Wersja 2.7.0 (wycofana, użyj wersji 2.8.0 lub nowszej)
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.7.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.7.0.0.
Wersja 2.6.1 (wycofana, użyj wersji 2.8.0 lub nowszej)
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.6.1.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.6.1.0.
Wersja 2.6.0
- Obsługuje adapter Meta Audience Network na Androida w wersji 5.6.0.0.
- Obsługuje adapter Meta Audience Network na iOS w wersji 5.6.0.0.
Wersja 2.5.1
- Obsługuje adapter Facebooka na Androida w wersji 5.5.0.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.5.1.0.
Wersja 2.5.0
- Obsługuje adapter Facebooka na Androida w wersji 5.5.0.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.5.0.0.
Wersja 2.4.1
- Obsługuje adapter Facebooka na Androida w wersji 5.4.1.1.
- Obsługuje adapter Facebooka na iOS w wersji 5.4.0.0.
Wersja 2.4.0
- Obsługuje adapter Facebooka na Androida w wersji 5.4.0.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.4.0.0.
Wersja 2.3.2
- Obsługuje adapter Facebooka na Androida w wersji 5.3.1.2.
- Obsługuje adapter Facebooka na iOS w wersji 5.3.2.0.
Wersja 2.3.1
- Obsługuje adapter Facebooka na Androida w wersji 5.3.1.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.3.2.0.
Wersja 2.3.0
- Obsługuje adapter Facebooka na Androida w wersji 5.3.0.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.3.0.0.
Wersja 2.2.0
- Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs API do reklam z nagrodą w ramach otwartych testów beta.
- Obsługuje adapter Facebooka na Androida w wersji 5.2.0.1.
- Obsługuje adapter Facebooka na iOS w wersji 5.2.0.1.
Wersja 2.1.1
- Obsługuje adapter Facebooka na Androida w wersji 5.1.0.1.
- Obsługuje adapter Facebooka na iOS w wersji 5.1.0.0.
Wersja 2.1.0
- Obsługuje adapter Facebooka na Androida w wersji 5.1.0.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.1.0.0.
Wersja 2.0.0
- Obsługuje adapter Facebooka na Androida w wersji 5.0.1.0.
- Obsługuje adapter Facebooka na iOS w wersji 5.0.1.0.
Wersja 1.2.1
- Obsługuje adapter Facebooka na Androida w wersji 4.99.3.0.
- Obsługuje adapter Facebooka na iOS w wersji 4.99.3.0.
Wersja 1.2.0
- Obsługuje adapter Facebooka na Androida w wersji 4.99.1.1.
- Obsługuje adapter Facebooka na iOS w wersji 4.99.2.0.
Wersja 1.1.3
- Obsługuje adapter Facebooka na Androida w wersji 4.28.2.1.
- Obsługuje adapter Facebooka na iOS w wersji 4.28.1.2.
Wersja 1.1.2
- Rozwiązaliśmy potencjalny konflikt z wtyczką zapośredniczoną Unity Ads dla Unity.
Wersja 1.1.1
- Obsługuje adapter Facebooka na Androida w wersji 4.28.2.0.
- Obsługuje adapter Facebooka na iOS w wersji 4.28.1.1.
Wersja 1.1.0
- Obsługuje pakiet SDK Facebooka na Androida w wersji 4.28.1.
- Obsługuje pakiet SDK Facebooka na iOS w wersji 4.28.1.
Wersja 1.0.0
- Pierwsza wersja
- Obsługuje pakiet SDK Facebooka na Androida w wersji 4.27.0.
- Obsługuje pakiet SDK Facebooka na iOS w wersji 4.27.1.