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 przy użyciu zapośredniczenia, w tym integracji ustalania stawek. Znajdziesz w nim informacje o tym, jak dodać Meta Audience Network do konfiguracji zapośredniczenia w jednostce reklamowej oraz jak zintegrować pakiet SDK i adapter Meta Audience Network z aplikacją 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

poziom interfejsu API 21 lub nowszy,

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

Krok 1. Skonfiguruj ustawienia 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.

Zanotuj 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

Zaloguj się na konto Ad Managera.

Włączanie udostępniania bezpiecznych sygnałów

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange i sprawdź, czy opcja Udostępnianie bezpiecznych sygnałów jest włączona. Kliknij Zapisz.

Konfigurowanie określania stawek za pomocą Meta

Ad Manager 360

Kliknij kolejno Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz Meta.

Włącz opcje Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Ad Manager

Kliknij kolejno Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz Meta.

Kliknij Nawiąż relację online teraz. Następnie w oknie kliknij Tak, zgadzam się, aby przejść do witryny Facebooka i rozpocząć proces rejestracji.

Zaloguj się na konto Business Manager.

Wybierz swoją firmę.

Po wybraniu firmy pojawi się ten komunikat. Kliknij Wróć do Menedżera reklam.

Włącz opcje Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Konfigurowanie mapowania jednostek reklamowych

Kliknij kolejno Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę Meta.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych Aplikacja mobilna, a jako Typ zasobów reklamowych – Aplikacja mobilna. Następnie wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji. Na koniec kliknij Zapisz.

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 Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia RODO i Ustawienia dotyczące 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 implementacje, zależności i konfiguracje. 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 Meta Audience Network i dodaj go do projektu.

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

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

Przepisy stanowe w USA 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 przypadku 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 zapewnić 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

Upewnij się, że zarejestrujesz urządzenie testowe w Ad Managerze i włączysz tryb testowy w interfejsie sieci 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 za pomocą źródeł reklam Meta Audience Network (z określaniem 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 ona te pola w przypadku NativeAd.

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

¹ Adapter sieci 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.

Nagranie wyświetlenia	Kliknij nagrywanie.
Element natywnych reklam Meta Audience Network o wymiarach 1 piksel 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 działanie funkcji 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 odpowiadają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 wysłał żądania ujednoliconych reklam natywnych.
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 stawce.
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ł błąd związany z SDK. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją Audience Network.