Integracja Meta Audience Network z określaniem stawek

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads Unity Plugin wczytywać i wyświetlać reklamy z Meta Audience Network przy użyciu mediacji, w tym integracji określania stawek. Wyjaśniamy w nim, jak dodać Meta Audience Network do konfiguracji mediacji jednostki reklamowej i jak zintegrować Meta Audience Network oraz adapter z aplikacją Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla sieci Meta Audience Network ma te możliwości:

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 przeszła na model tylko z licytowaniem.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

  • Najnowsza wersja Google Mobile Ads Unity Plugin.
  • Edytor Unity w wersji 5.6 lub nowszej.
  • Wtyczka do zapośredniczenia reklam mobilnych Google w sieci reklamowej Meta Audience Network w wersji 2.11.0 (zalecana jest najnowsza wersja).
  • Wdrażanie na Androidzie
    • Android w wersji API 24 lub nowszej.
  • Wdrażanie na iOS
    • iOS w wersji 15.0 lub nowszej.
    • Najnowszy pakiet SDK Meta Audience Network zwykle wymaga najnowszej wersji Xcode.
  • Działający projekt Unity skonfigurowany za pomocą Google Mobile Ads Unity Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Unity Plugin.
  • Skonfiguruj zapośredniczenie AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej Meta

Zarejestruj się i zaloguj na stronie Business Manager Start.

Kliknij Rozpocznij, a potem Utwórz nowe konto.

Wypełnij wymagane pola informacjami o firmie i kliknij Dalej.

Tworzenie usługi

Po wypełnieniu wymaganych informacji pojawi się prośba o utworzenie usługi dla aplikacji. Wpisz wybraną nazwę usługi dla aplikacji 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 wpisać dane do płatności. Wypełnij niezbędne pola, a następnie kliknij Dalej.

Jako platformę zapośredniczenia wybierz Google AdMob, a następnie kliknij Utwórz miejsce docelowe.

Wybierz format, wypełnij formularz i kliknij Utwórz.

Zanotuj identyfikator miejsca docelowego.

Kliknij Gotowe.

Aktualizowanie pliku app-ads.txt

Plik Authorized Sellers for Apps app-ads.txt to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Informacje o wdrażaniu app-ads.txt w Meta Audience Network znajdziesz w artykule Identyfikowanie autoryzowanych sprzedawców za pomocą pliku app-ads.txt.

Włączanie trybu testowego

Szczegółowe instrukcje włączania reklam testowych w Meta Audience Network znajdziesz w przewodniku po testowaniu implementacji Audience Network.

Krok 2. Skonfiguruj popyt z Meta Audience Network w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

Dodawanie Meta do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Meta do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

OpenUPM-CLI

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

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

OpenUPM

W edytorze projektu Unity kliknij Edit (Edytuj) > Project Settings (Ustawienia projektu) > Package Manager (Menedżer pakietów), aby otworzyć Ustawienia menedżera pakietów Unity.

Na karcie Scoped Registries (Rejestry o ograniczonym zakresie) dodaj OpenUPM jako rejestr o ograniczonym zakresie, podając te informacje:

  • Nazwa: OpenUPM
  • URL: https://package.openupm.com
  • Zakresy: com.google

Szczegóły OpenUPM

Następnie kliknij Window (Okno) > Package Manager (Menedżer pakietów), aby otworzyć Menedżera pakietów Unity, i w menu kliknij My Registries (Moje rejestry).

Rejestry Unity

Wybierz pakiet Google Mobile Ads MetaAudienceNetwork Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

Pakiet Unity

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Meta Audience Network, korzystając z linku do pobierania w dzienniku zmian, a następnie wyodrębnij GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage. Sprawdź, czy wszystkie pliki są zaznaczone, i kliknij Importuj.

Importowanie z Unity

Następnie wybierz Assets (Zasoby) > External Dependency Manager (Menedżer zależności zewnętrznych) > Android Resolver (Rozwiązywanie zależności w Androidzie) > Force Resolve (Wymuś rozwiązanie). Biblioteka External Dependency Manager od początku rozwiąże zależności i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android w aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wdróż ustawienia prywatności w pakiecie Meta Audience Network SDK

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Szwajcarii i Wielkiej Brytanii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych form lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Informacje o RODO i reklamach Meta znajdziesz w wskazówkach Meta.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 Twoim łańcuchu zapośredniczenia. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

W przypadku użytkowników z Kalifornii zapoznaj się z opcjami przetwarzania danych 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 w projekcie.

Śledzenie reklam włączone

Jeśli tworzysz aplikację 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

Upewnij się, że zarejestrowano urządzenie testowe w AdMob i włączono 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, korzystając ze źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Pamięć podręczna na Androidzie 9

Android

Od Androida 9 (interfejs API na poziomie 28) obsługa tekstu jawnego jest domyślnie wyłączona, co wpłynie na funkcjonalność buforowania multimediów w pakiecie SDK Meta Audience Network i może mieć wpływ na wrażenia użytkowników oraz przychody z reklam. Postępuj zgodnie z dokumentacją Mety, aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji.

iOS

Nie dotyczy 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 żądanie reklamy, korzystając z ResponseInfo w tych klasach:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Oto kody i komunikaty towarzyszące, które są zwracane przez adapter sieci Meta Audience Network, gdy nie uda się 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 sieć 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 poprosił o wyświetlanie ujednoliconych reklam natywnych.
106 Wczytana reklama natywna jest innym obiektem niż oczekiwany.
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 na podstawie ładunku stawki.
110 SDK sieci Meta Audience Network nie udało się wyświetlić reklamy pełnoekranowej lub z nagrodą.
111 Podczas tworzenia obiektu Meta Audience Network AdView wystąpił wyjątek.
1000-9999 Meta Audience Network zwróciła błąd specyficzny dla pakietu 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 sieć Meta Audience Network.
103 Nie udało się zainicjować obiektu reklamy Meta Audience Network.
104 SDK sieci Meta Audience Network nie udało się 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 Meta Audience Network zwróciła błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network.

Dziennik zmian wtyczki zapośredniczenia Unity dla Meta Audience Network

Wersja 3.20.1

Wersja 3.20.0

Wersja 3.19.0

Wersja 3.18.7

Wersja 3.18.6

Wersja 3.18.5

Wersja 3.18.4

Wersja 3.18.3

Wersja 3.18.2

Wersja 3.18.1

Wersja 3.18.0

Wersja 3.17.3

Wersja 3.17.2

Wersja 3.17.1

Wersja 3.17.0

Wersja 3.16.0

Wersja 3.15.0

Wersja 3.14.0

Wersja 3.13.1

Wersja 3.13.0

Wersja 3.12.2

Wersja 3.12.1

Wersja 3.12.0

Wersja 3.11.0

Wersja 3.10.0

Wersja 3.9.1

Wersja 3.9.0

Wersja 3.8.0

Wersja 3.7.0

Wersja 3.6.1

Wersja 3.6.0

Wersja 3.5.0

Wersja 3.4.0

Wersja 3.3.2

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.0

Wersja 3.0.0

Wersja 2.12.0

Wersja 2.11.1

Wersja 2.11.0

Wersja 2.10.0

Wersja 2.9.2

Wersja 2.9.1

Wersja 2.9.0

Wersja 2.8.1

Wersja 2.8.0

Wersja 2.7.1 (wersja wycofana, używaj wersji 2.8.0 lub nowszej)

Wersja 2.7.0 (wersja wycofana, używaj wersji 2.8.0 lub nowszej)

Wersja 2.6.1 (wersja wycofana, używaj wersji 2.8.0 lub nowszej)

Wersja 2.6.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

  • Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API w ramach otwartych testów 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

  • Rozwiązaliś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 Facebook Android SDK w wersji 4.28.1.
  • Obsługuje pakiet Facebook iOS SDK w wersji 4.28.1.

Wersja 1.0.0

  • Pierwsza wersja!
  • Obsługuje pakiet Facebook Android SDK w wersji 4.27.0.
  • Obsługuje pakiet Facebook iOS SDK w wersji 4.27.1.