Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Meta Audience Network za pomocą zapośredniczenia obejmującego integrację określania stawek. Dowiesz się z niego, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować tę sieć i dostosować ją do aplikacji Unity .
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia Ad Manager do Meta Audience Network zapewnia:
Integracja | |
---|---|
Ustalanie stawek | |
Kaskada 1 | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano | |
Pełnoekranowa z nagrodą |
1 W 2021 r. platforma Meta Audience Network była jej określaniem stawek tylko.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity w wersji 5.6 lub nowszej
- Wtyczka zapośredniczenia do reklam mobilnych Google dla Meta Audience Network 2.11.0 (zalecana najnowsza wersja)
- Aby wdrożyć to na Androidzie:
- Interfejs API Androida na poziomie 21 lub wyższym
- Aby wdrożyć w iOS:
- Cel wdrożenia iOS w wersji 10.0 lub nowszej
- Najnowszy pakiet Meta Audience Network SDK 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.
- Wykonaj czynności opisane w przewodniku dla początkujących zapośredniczenia
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika 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 żądania Meta Audience Network w Ad Manager 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.
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 Ad Manager UI.
Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla MetaAudience Network z linku pobierania w dzienniku zmian i wyodrębnij GoogleMobileAdsFacebookMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i znajdź pobrany plik GoogleMobileAdsFacebookMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Wybierz Zasoby > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie.
Biblioteka programu do rozpoznawania usług Unity Play wykonuje wtedy proces rozwiązywania zależności od zera i kopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji w Unity.
Krok 4. Wdróż 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.
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 wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.
W przypadku użytkowników z Kalifornii zapoznaj się z opcjami przetwarzania danych dostępnymi w 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 kreacje na iOS 14 lub nowszego, zapoznaj się z instrukcjami Meta Audience Network dotyczącymi ustawiania flagi śledzenia reklam.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager 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:
Pamięć podręczna na Androidzie 9
Android
Począwszy od Androida 9 (poziom interfejsu API 28) obsługa tekstu jawnego jest domyślnie wyłączona, co wpłynie na działanie buforowania multimediów przez pakiet SDK Meta Audience Network i może wpłynąć na wrażenia użytkowników oraz 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 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 pasuje do rozmiaru banera obsługiwanego przez Meta Audience Network. |
103 | Wydawca musi wysyłać żądania 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 jest innym obiektem niż oczekiwano. |
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 pełnoekranowej lub z nagrodą. |
111 | Podczas tworzenia obiektu Meta Audience Network AdView zostaje 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 reklamy Meta Audience Network. |
104 | Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej lub z nagrodą. |
105 | Główny kontroler widoku 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. |
Historia zmian wtyczki zapośredniczenia Unity w Meta Audience Network
Wersja 3.12.1
- Obsługuje adapter Androida Meta Audience Network w wersji 6.17.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.15.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google 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 systemu iOS Meta Audience Network w wersji 6.15.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 3.11.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.15.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.14.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.5.1.
Wersja 3.10.0
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Obsługuje adapter Androida Meta Audience Network w wersji 6.14.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.12.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 3.9.1
- Obsługuje adapter Androida Meta Audience Network w wersji 6.12.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.12.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 3.9.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.12.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.12.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 3.8.0
- Zmieniono nazwę wtyczki zapośredniczenia Unity na „Meta Audience Network”.
- Obsługuje adapter Androida Meta Audience Network w wersji 6.11.0.1.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.11.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google 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 systemu iOS Meta Audience Network w wersji 6.10.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.6.1
- Obsługuje adapter Androida Meta Audience Network w wersji 6.8.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.9.0.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 3.6.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.8.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network w wersji 6.6.0.0.
Wersja 3.3.2
- Obsługuje adapter Androida Meta Audience Network w wersji 6.5.1.1.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.5.1.0.
Wersja 3.3.1
- Obsługuje adapter Androida Meta Audience Network w wersji 6.5.1.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.5.1.0.
Wersja 3.3.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.4.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.4.1.0.
Wersja 3.2.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.2.0.1.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.2.1.0.
Wersja 3.1.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.2.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.2.0.0.
Wersja 3.0.0
- Obsługuje adapter Androida Meta Audience Network w wersji 6.1.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 6.0.0.0.
Wersja 2.12.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.11.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.10.1.0.
Wersja 2.11.1
- Obsługuje adapter Androida Meta Audience Network w wersji 5.10.1.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.10.1.0.
Wersja 2.11.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.10.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network w wersji 5.9.0.1.
Wersja 2.9.2
- Obsługuje adapter Androida Meta Audience Network w wersji 5.9.0.2.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.9.0.1.
Wersja 2.9.1
- Obsługuje adapter Androida Meta Audience Network w wersji 5.9.0.1.
- Obsługuje adapter systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network 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 systemu iOS Meta Audience Network w wersji 5.8.0.1.
Wersja 2.7.1 (wycofana, użyj 2.8.0 lub nowszej)
- Obsługuje adapter Androida Meta Audience Network w wersji 5.7.1.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.7.1.1.
Wersja 2.7.0 (wycofana, użyj 2.8.0 lub nowszej)
- Obsługuje adapter Androida Meta Audience Network w wersji 5.7.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.7.0.0.
Wersja 2.6.1 (wycofana, użyj 2.8.0 lub nowszej)
- Obsługuje adapter Androida Meta Audience Network w wersji 5.6.1.0.
- Obsługuje adapter systemu iOS Meta Audience Network w wersji 5.6.1.0.
Wersja 2.6.0
- Obsługuje adapter Androida Meta Audience Network w wersji 5.6.0.0.
- Obsługuje adapter systemu iOS Meta Audience Network 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
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji 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
- Wyeliminowaliśmy potencjalny konflikt z wtyczką zapośredniczenia Unity Ads 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.