Integracja Meta Audience Network z określaniem stawek

Uwaga: sieć Facebook Audience Network została zastąpiona przez sieć Meta Audience Network. Więcej informacji znajdziesz w ogłoszeniu meta.

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

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do Meta Audience Network zapewnia:

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

¹ W 2021 r. platforma Meta Audience Network była jej określaniem stawek tylko.

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 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 konfiguracje 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 informacjami 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.

Uwaga: format banera w sieci Meta Audience Network obsługuje format wyświetlania średniego prostokąta i banery o zmiennej szerokości o wysokości 50, 90 lub 250 pikseli.

Zanotuj identyfikator miejsca docelowego.

Kliknij Gotowe.

Włączanie trybu testowego

Szczegółowe instrukcje, jak włączyć reklamy testowe Meta Audience Network, znajdziesz w przewodniku po implementacji reklam Meta Audience Network.

Krok 2. Skonfiguruj żądania Meta Audience Network w interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA

Wykonaj czynności opisane w sekcji Ustawienia dotyczące RODO i Ustawienia dotyczące amerykańskich przepisów stanowych, aby dodać Meta do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Uwaga: brak zgodności zgodnych wersji pakietu Meta Audience Network i pakietu SDK do reklam mobilnych Google może spowodować problemy z kompilacją.

OpenUPM-CLI

Ważne: jeśli przechodzisz z interfejsu .unitypackage na interfejs OpenUPM-CLI, musisz ręcznie odinstalować zasoby ze starej lokalizacji, usuwając wszystkie pliki z folderu Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork.

Jeśli masz zainstalowany interfejs OpenUPM-CLI, możesz zainstalować w swoim projekcie wtyczkę Meta Audience Network do reklam mobilnych Google dla Unity, uruchamiając to polecenie z katalogu głównego projektu:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

Ważne: jeśli przechodzisz z poziomu .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji, usuwając wszystkie pliki z foldera Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork.

W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć ustawienia menedżera pakietów Unity.

Na karcie 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 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.

Zapoznaj się ze wskazówkami metadanymi dotyczącymi RODO i reklam w Meta.

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

Postępuj zgodnie z dokumentacją Meta Audience Network, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

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

Ważne: podczas testowania upewnij się, że na urządzeniu testowym masz zainstalowaną aplikację Facebook i zarejestruj się za pomocą prawidłowego konta Facebook. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Meta.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy w przypadku AdMob i 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 (Określanie 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. Spowoduje to zmiany w funkcjonalności buforowania multimediów w pakiecie SDK sieci Audience Network firmy Meta, co może mieć wpływ na wrażenia użytkowników i przychody z reklam. Aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji, postępuj zgodnie z dokumentacją Meta.

iOS

Opcja niedostępna w przypadku integracji z iOS.

Kody błędów

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

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 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	W wczytanej reklamie brakuje wymaganych komponentów reklamy natywnej.
109	Nie udało się utworzyć reklamy natywnej na podstawie zestawu stawek.
110	Pakiet SDK Meta Audience Network nie wyświetlił reklamy przejściowej ani reklamy z nagrodą.
111	Podczas tworzenia obiektu Meta Audience Network AdView zostaje zgłoszony wyjątek.
1000-9999	Meta Audience Network zwróciła 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	Główny kontroler widoku banera reklamowego to nil.
106	Nie udało się zainicjować pakietu SDK Meta Audience Network.
1000-9999	Meta Audience Network zwróciła błąd związany z SDK. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Audience Network.

Zmiana w adapterze zapośredniczenia Fluttera dla Meta Audience Network

Następna wersja

• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.1.0

• Zweryfikowano zgodność z adapterem platformy Meta na Androida 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
• Zweryfikowano zgodność z adapterem platformy Meta na Androida 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.