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ą Flutter .
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
- Flutter 3.7.0 lub nowszy
- 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 Flutter 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.
Wpisz w wymaganych polach informacje o firmie 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 partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA Facebook
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
Integracja przez pub.dev
Dodaj te zależności z najnowszymi wersjami pakietuMeta Audience Network SDK i adaptera w pliku pubspec.yaml
pakietu:
dependencies:
gma_mediation_meta: ^1.0.0
Integracja ręczna
Pobierz najnowszą wersję wtyczki do zapośredniczenia reklam mobilnych Google dla Meta Audience Network, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml
, dodając tę zależność:
dependencies:
gma_mediation_meta:
path: path/to/local/package
Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Meta Audience Network
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 przez każdą z nich. 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 dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu 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 lub 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 lub reklamy z nagrodą. |
105 | Element sterujący widokiem głównym 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. |
Meta Audience Network: log zmian adaptera zapośredniczenia Fluttera
Następna wersja
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.
1.1.0
- Weryfikowana zgodność z adapterem Meta Android w wersji 6.17.0.0
- Weryfikowana zgodność z adapterem Meta iOS w wersji 6.15.2.0
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.
1.0.1
- Dodano klasę dart, aby umożliwić prawidłową analizę zgodności z platformami hosta
- Weryfikowana zgodność z adapterem Meta Android w wersji 6.17.0.0
- Weryfikowana zgodność z adapterem Meta iOS w wersji 6.15.0.0
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Weryfikowana zgodność z adapterem Meta Android w wersji 6.17.0.0
- Weryfikowana zgodność z adapterem Meta iOS w wersji 6.15.0.0
- Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.