Integracja Meta Audience Network z określaniem stawek

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ą mediacji. Omawia on 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ą Unity.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Managera dla 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 stała się siecią tylko do licytowania.

Wymagania

  • Najnowsza wersja pakietu SDK do reklam mobilnych Google
  • Unity w wersji 5.6 lub nowszej
  • Wtyczka pośrednictwa reklam mobilnych Google dla Meta Audience Network w wersji 2.11.0 (zalecana najnowsza wersja)
  • Aby wdrożyć na Androidzie:
    • Android API na poziomie 21 lub wyższym
  • 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 Unity skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Przeczytaj przewodnik dla początkujących dotyczący 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 danymi swojej firmy 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.

Zapisz identyfikator miejsca docelowego.

Kliknij Gotowe.

Włączanie trybu testowego

Szczegółowe instrukcje dotyczące włączania testowych reklam w sieci Audience Network znajdziesz w przewodniku Testowanie implementacji Audience Network.

Krok 2. Skonfiguruj zapotrzebowanie sieci Meta Audience Network w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 w przewodniku dotyczącym Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dla iOS.

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

Wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA, aby dodać Meta do listy partnerów reklamowych w usłudze Ad Manager, którzy podlegają RODO i przepisom stanowym w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

OpenUPM-CLI

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

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

OpenUPM

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

Na karcie Scoped Registries (Rejestry ograniczone) dodaj OpenUPM jako rejestr ograniczony z tymi informacjami:

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

Szczegóły OpenUPM

Następnie kliknij Okno > Menedżer pakietów, aby otworzyć Menedżera pakietów Unity, a potem w menu kliknij Moje rejestry.

Rejestry Unity

Wybierz pakiet Google Mobile Ads Meta Audience Network Mediation i kliknij Zainstaluj.

Instalowanie z OpenUPM

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.

Importowanie z Unity

Następnie kliknij Zasoby > Menedżer zależności zewnętrznych > Rozwiązywanie problemów z Androidem > Wymuś rozwiązanie problemów. Biblioteka menedżera zależności zewnętrznej wykona rozwiązywanie zależności od podstaw i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android Twojej aplikacji Unity.

Wymuś rozwiązanie

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Meta Audience Network

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.

Aby dowiedzieć się więcej o RODO i reklamach w Mecie, zapoznaj się z wskazówkami tej firmy.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „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 dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku 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 zachować zgodność.

W przypadku użytkowników 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 z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją Audience Network.

Śledzenie reklam włączone

Jeśli tworzysz aplikację na iOS 14 lub nowszy, zapoznaj się z instrukcjami Audience Network firmy Meta dotyczącymi ustawiania flagi śledzenia reklam.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w Ad Managerze i włączyć tryb testowy w interfejsie Audience Network.

Weryfikacja 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 w postaci zwykłego tekstu jest domyślnie wyłączona. Spowoduje to zmianę działania funkcji buforowania multimediów w pakiecie Audience Network SDK 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

Nie dotyczy integracji z iOS.

Kody błędów

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

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Oto kody i towarzyszące im komunikaty o błędach generowane przez adapter sieci Audience Network Meta, gdy nie udaje się załadować reklamy:

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 poprosił o ujednoliconą reklamę natywną.
106 Wczytana reklama natywną jest innym obiektem niż oczekiwany.
107 Użyty obiekt Context jest nieprawidłowy.
108 Załadowana reklama nie zawiera wymaganych komponentów reklam natywnych.
109 Nie udało się utworzyć reklamy natywnej na podstawie danych o ofercie.
110 Pakiet SDK Meta Audience Network nie wyświetlił reklamy przejściowej ani reklamy z nagrodą.
111 Wyjątek wywołany podczas tworzenia obiektu AdView sieci Meta Audience Network.
1000-9999 Meta Audience Network zwróciła błąd związany ze środowiskiem 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 Element główny 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 ze środowiskiem SDK. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Audience Network.

Informacje o zmianach w pliku Meta Audience Network Unity Mediation Plugin

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 (wycofana, użyj wersji 2.8.0 lub nowszej)

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

Wersja 2.6.1 (wycofana, użyj 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 API do reklam z nagrodą 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ą do pośrednictwa Unity Ads dla 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 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.