Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Meta Audience Network z wykorzystaniem zapośredniczenia, w tym integracji określania stawek. Opisano w nim, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować tę sieć i dostosować ją do Flutter aplikacji.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla Meta Audience Network ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Kaskada 1 | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Pełnoekranowa z nagrodą |
1 Meta Audience Network zaczęła określać stawki tylko w 2021 r.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Flutter w wersji 3.7.0 lub nowszej
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Docelowe wdrożenie systemu iOS w wersji 10.0 lub nowszej
- Najnowsza wersja pakietu Meta Audience Network SDK 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.
- Wykonaj czynności opisane w przewodniku dla początkujących po zapośredniczeniu.
Krok 1. Skonfiguruj konfiguracje w interfejsie Meta Audience Network
Zarejestruj się i zaloguj się na stronie startowej platformy Business Manager.
Kliknij Rozpocznij, a następnie Utwórz nowe konto.
Wypełnij wymagane pola informacjami o firmie i kliknij Dalej.
Tworzenie usługi
Gdy podasz wymagane informacje, pojawi się prośba o utworzenie usługi dla aplikacji. Wpisz odpowiednią nazwę usługi i kliknij Dalej.
Następnie wybierz platformę, na której chcesz zarabiać.
Dodaj szczegóły aplikacji i kliknij Dalej.
Android
iOS
Kliknij Dodaj nowe konto płatności, aby skonfigurować konto płatności. Przekierujemy Cię na nową stronę, na której możesz podać dane do płatności. Podaj wymagane informacje i kliknij Dalej.
Wybierz Google AdMob jako platformę zapośredniczenia, a następnie kliknij Utwórz miejsce docelowe.
Wybierz format, wypełnij formularz i kliknij Utwórz.
Zapisz Identyfikator miejsca docelowego.
Kliknij Gotowe.
Włącz tryb testowy
Szczegółowe instrukcje, jak włączyć reklamy testowe Meta Audience Network, znajdziesz w przewodniku po implementacji sieci odbiorców.
Krok 2. Skonfiguruj oferty reklamowe Meta Audience Network w AdMob interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Androida.
iOS
Instrukcje znajdziesz w kroku 2 przewodnika po iOS.
Dodaj Facebook do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi
Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Facebook do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet SDK Meta Audience Network i adapter
Integracja za pomocą pub.dev
Dodaj tę zależność do najnowszych wersji 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 zapośredniczenia reklam mobilnych Google dla Meta Audience Network, wyodrębnij pobrany plik i dodaj do projektu Flutter wyodrębniony folder wtyczki (wraz z jego zawartością). Następnie odwołaj się do wtyczki w pliku pubspec.yaml
, dodając tę zależność:
dependencies:
gma_mediation_meta:
path: path/to/local/package
Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK Meta Audience Network
Zgoda użytkowników z UE a RODO
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.
Zapoznaj się z wytycznymi firmy Meta, aby dowiedzieć się więcej o reklamach w wynikach RODO i metadanych.
Amerykańskie przepisy stanowe o ochronie prywatności
Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.
Jeśli jesteś użytkownikiem z Kalifornii, zapoznaj się z opcjami przetwarzania danych firmy Meta.
Krok 5. Dodaj wymagany kod
Android
Integracja z Meta Audience Network nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją Meta Audience Network, aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Śledzenie reklam włączone
Jeśli tworzysz wersję do systemu iOS 14 lub nowszego, zapoznaj się z instrukcjami na stronie Meta Audience Network, aby dowiedzieć się, jak ustawić flagę śledzenia reklam.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Meta Audience Network interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyMeta Audience Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Meta Audience Network (Bidding) źródeł reklam.
Kroki opcjonalne:
Buforowanie na Androidzie 9
Android
Począwszy od Androida 9 (poziom interfejsu API 28) obsługa tekstu zwykłego jest domyślnie wyłączona, co wpływa na działanie buforowania multimediów w pakiecie Meta Audience Network SDK i może mieć wpływ na wrażenia użytkowników i przychody z reklam. Postępuj zgodnie z dokumentacją Meta, aby zaktualizować konfigurację zabezpieczeń sieci w swojej aplikacji.
iOS
Opcja niedostępna w przypadku integracji z iOS.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Audience Network, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, używając ResponseInfo
w tych klasach:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Meta Audience Network, gdy reklama się nie wczytuje:
Android
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 Meta Audience Network. |
103 | Wydawca musi zażądać reklam z kontekstem Activity . |
104 | Nie udało się zainicjować pakietu SDK Meta Audience Network. |
105 | Wydawca nie zażądał ujednoliconych reklam natywnych. |
106 | Wczytana reklama natywna ma inny obiekt niż oczekiwano. |
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 z ładunku stawki. |
110 | Pakiet SDK Meta Audience Network SDK nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą. |
111 | Podczas tworzenia obiektu Meta Audience Network AdView został zgłoszony wyjątek. |
1000-9999 | Sieć Meta Audience Network zwróciła błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network. |
iOS
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 Meta Audience Network. |
103 | Nie udało się zainicjować obiektu reklamowego Meta Audience Network. |
104 | Pakiet SDK Meta Audience Network SDK nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą. |
105 | Kontroler widoku głównego banera reklamowego to nil . |
106 | Nie udało się zainicjować pakietu SDK Meta Audience Network. |
1000-9999 | Sieć Meta Audience Network zwróciła błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network. |
Dziennik zmian adaptera zapośredniczenia sieci Flutter Meta Audience
1.0.1
- Dodano klasę dart, aby umożliwić prawidłową analizę zgodności z platformami hostów.
- Zweryfikowana zgodność z adapterem Meta Android w wersji 6.17.0.0
- Zweryfikowana zgodność z adapterem Meta iOS w wersji 6.15.0.0
- Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.1.0.
1.0.0
- Pierwsza wersja.
- Zweryfikowana zgodność z adapterem Meta Android w wersji 6.17.0.0
- Zweryfikowana zgodność z adapterem Meta iOS w wersji 6.15.0.0
- Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.0.0.