Ta strona została przetłumaczona przez Cloud Translation API.

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ą zapośredniczenia AdMob, w tym integracji ustalania stawek. Przewodnik zawiera informacje o dodawaniu Meta Audience Network do konfiguracji zapośredniczenia w jednostce reklamowej oraz o integrowaniu pakietu SDK i adaptera Meta Audience Network w aplikacji na Androida.

Obsługiwane integracje i formaty reklam

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

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

¹ W 2021 r. sieć Meta Audience Network stała się siecią tylko do licytowania.

Wymagania

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik dla początkujących na temat zapośredniczenia.

Android API na poziomie 21 lub wyższym

adapter Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja);

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.

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 żądania z sieci Meta Audience Network w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać sieć Meta Audience Network do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodawanie sieci Audience Network od Meta jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy mediów na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Karta Jednostki reklamowe powinna być teraz wypełniona wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie Meta Audience Network jako źródła reklam

Na karcie Ustalanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz Meta Audience Network.
Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo z ustalaniem stawek z Meta Audience Network.

Kliknij Potwierdź i zaakceptuj, a potem Dalej.

Jeśli masz już mapowanie dla sieci Meta Audience Network, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

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

Aby dodać Meta do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera sieci reklamowej Meta Audience Network:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Meta Audience Network na Androida. Wyodrębnij plik AudienceNetwork.aar w folderze AudienceNetwork/bin i dodaj go do projektu.
Otwórz elementy skompilowane dla adaptera Meta Audience Network w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera sieci Audience Network od Meta i dodaj go do projektu.

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.

Postępuj zgodnie z instrukcjami podanymi w dokumentacji Meta dotyczących RODO i reklam Meta.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na sprzedawcę obowiązek zapewnienia użytkownikom możliwości rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej „sprzedawcy” należy umieścić dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po przepisach stanowych 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ść.

Aby dowiedzieć się, jakie opcje przetwarzania danych są dostępne dla użytkowników w Kalifornii, postępuj zgodnie ze wskazówkami podanymi w dokumentacji Meta.

Krok 5. Dodaj wymagany kod

Do integracji z siecią Meta Audience Network nie jest potrzebny żaden dodatkowy kod.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Zarejestruj urządzenie testowe w AdMob i włącz tryb testowy w interfejsie sieci Meta 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:

Reklamy natywne

Niektóre komponenty reklam natywnych w Meta Audience Network nie są mapowane jeden do jednego na komponenty reklam natywnych w Google. Takie zasoby są przekazywane z powrotem do wydawcy w pakiecie za pomocą metody getExtras() w NativeAd. Adapter obsługuje przekazywanie tych komponentów:

Parametry i wartości żądania
`FacebookMediationAdapter.KEY_ID`	String. Unikalny identyfikator reklamy natywnej
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	String. Kontekst społeczny reklamy

Oto przykładowy kod, który pokazuje, jak wyodrębnić te zasoby:

Przykład:

Java

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Kotlin

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
   var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
   // ...
}

Korzystanie z reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej w sieci Meta Audience Network wymaga renderowania zasobu MediaView. Jeśli planujesz renderowanie reklam natywnych bez tego zasobu, użyj formatu reklamy natywnego banera w Meta Audience Network.

Aby zamiast tego używać natywnych banerów reklamowych Meta Audience Network, musisz wybrać format Native Banner podczas konfigurowania Meta Audience Network, a adapter automatycznie wczyta odpowiedni format reklamy natywnej.

Renderowanie reklam

Adapter Audience Network zwraca reklamy natywne jako obiekty NativeAd. Wypełnia on te pola reklam natywnych: NativeAd.

Pole	Wypełniony przez adapter Meta Audience Network
Nagłówek
Obraz	1
Treść
Ikona aplikacji
Wezwanie do działania
Nazwa reklamodawcy
Ocena w gwiazdkach
Sklep
Cena

¹ Adapter Meta Audience Network nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego w przypadku reklam natywnych. Zamiast tego adapter wypełnia pole MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

W tabeli poniżej podano, kiedy pakiet SDK do reklam mobilnych Google rejestruje wyświetlenia i kliknięcia reklam natywnych.

Rejestrowanie wyświetleń	Kliknij nagrywanie.
Element natywnych reklam Meta Audience Network o wymiarach 1 px na ekranie oraz wymagania dotyczące renderowania komponentu	wywołanie zwrotne pakietu SDK Meta Audience Network.

Aby wyświetlenie zostało uznane za prawidłowe, Meta Audience Network musi spełnić określone wymagania dotyczące renderowania komponentów, zależnie od tego, czy podczas konfigurowania Meta Audience Network wybrano format natywny czy baner natywny.

Format natywny Meta Audience Network	Wymagany zasób	Wymagana klasa renderowania
Natywna	Widok multimediów	`MediaView`
Baner natywny	Ikona aplikacji	`ImageView`

Pamięć podręczna w Androidzie 9

Począwszy od Androida 9 (poziom interfejsu API 28) obsługa tekstu zwykłego jest domyślnie wyłączona, co wpłynie na funkcjonalność buforowania multimediów w pakiecie Audience Network SDK firmy Meta i może mieć wpływ na wrażenia użytkowników oraz przychody z reklam. Aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji, postępuj zgodnie z dokumentacją Meta.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Audience Network, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji ResponseInfo.getAdapterResponses() w ramach tych klas:

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

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

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.