Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Meta Audience Network, zapośredniczenia, obejmujące określanie stawek. integracje. Omawiamy, jak dodać Meta Audience Network do konfiguracji zapośredniczenia i integracji z Meta Audience Network oraz i adaptera Unity do aplikacji.
Obsługiwane integracje i formaty reklam
Adapter zapośredniczenia AdMob dla usługi Meta Audience Sieć ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad 1. | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Pełnoekranowa z nagrodą |
1 Meta Audience Network stał się tylko określanie stawek w 2021 r.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity w wersji 5.6 lub nowszej
- Wtyczka zapośredniczenia reklam mobilnych Google dla Meta Audience Network 2.11.0 (zalecana najnowsza wersja)
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 10.0 lub nowszej
- 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. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Wykonaj czynności opisane w przewodniku dla początkujących zapośredniczenia
Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Meta Audience Network
Krok 2. Skonfiguruj żądania 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
Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network
OpenUPM-CLI
Jeśli masz OpenUPM-CLI możesz zainstalować Google Mobile Ads Meta Audience Network, Wtyczka zapośredniczenia dla Unity, uruchamiając następujące polecenie w katalogu głównym projektu:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
W edytorze projektu Unity wybierz Edytuj > Ustawienia projektu > Menedżer pakietów, aby otworzyć plik Ustawienia menedżera pakietów Unity
Na karcie Rejestry o zakresie dodaj OpenUPM jako rejestr z zakresem następujące szczegóły:
- Nazwa:
OpenUPM
- Adres URL:
https://package.openupm.com
- Zakresy:
com.google
Następnie otwórz Okno > Menedżer pakietów, aby otworzyć plik Unity Package Manager oraz Z menu wybierz My Registries (Moje rejestry).
Wybierz pakiet zapośredniczenia sieci odbiorców w reklamach mobilnych Google i kliknij Zainstaluj.
Pakiet Unity
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla
Meta Audience Network z linku pobierania w
Historia zmian
i wyodrębnij
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
z kodu pocztowego
.
W edytorze projektów Unity wybierz Zasoby > Importuj pakiet >
Custom Package (Pakiet niestandardowy) i znajdź
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
pobranego pliku. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij
Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play >
Program do rozpoznawania Androida > Wymuś rozwiązanie. Program do rozpoznawania usług Unity Play
biblioteka rozpozna zależności od zera i skopiuje
zadeklarowano zależności w katalogu Assets/Plugins/Android
Aplikacja Unity.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Meta Audience Network
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Zapoznaj się ze wskazówkami Meta, aby uzyskać informacje na temat: RODO i reklamy w Meta.
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
W przypadku użytkowników z Kalifornii zapoznaj się z procedurą przetwarzania danych przez 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, sprawdź instrukcje dotyczące konfigurowania opcji śledzenia reklam Zgłoś.
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:
Pamięć podręczna na Androidzie 9
Android
Począwszy od Androida 9 (poziom interfejsu API 28) obsługa tekstu jawnego jest wyłączona przez domyślny, co wpłynie na działanie buforowania multimediów przez Meta Audience. pakietu SDK sieci, co może wpływać na wrażenia użytkowników i przychody z reklam. Obserwuj Meta dokumentacja , aby zaktualizować konfigurację zabezpieczeń sieci w Twojej aplikacji.
iOS
Opcja niedostępna w przypadku integracji z iOS.
Kody błędów
Jeśli adapter nie odbierze reklamy z sieci Audience Network, możesz sprawdzić
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w ramach tych zajęć:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Oto kody i powiązane z nimi wiadomości wysyłane przez odbiorców Meta Adapter sieciowy, który występuje, gdy nie można wczytać reklamy:
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. Zobacz Dokumentacja 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. Zobacz Dokumentacja 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.