Pakiet SDK do reklam mobilnych Google jest w trybie konserwacji. Aby korzystać z najnowszych aktualizacji i funkcji, migrate na pakiet SDK nowej generacji do reklam mobilnych Google i go skonfiguruj.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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 SDK (Legacy) wczytywać i wyświetlać reklamy z sieci Meta Audience Network przy użyciu zapośredniczenia AdMob, w tym integracji określania stawek. Wyjaśniamy w nim, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki 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 przeszła na model tylko z licytowaniem.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź, czy:

Android w wersji API 24 lub nowszej.

Adapter sieci Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja).

Najnowsza wersja Google Mobile Ads SDK (Legacy).
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.

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

Musisz dodać Meta Audience Network do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie sieci reklamowej Meta Audience Network 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, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

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

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

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

W sekcji Źródła reklam odszukaj kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz Meta Audience Network.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z Meta Audience Network.

Kliknij Potwierdzam i akceptuję, a potem Kontynuuj.

Jeśli masz już mapowanie dla 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 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

Integracja z Androidem Studio (zalecana)

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji:

Kotlin

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

Zakręcony

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:facebook:6.22.0.1'
}

Integracja ręczna

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

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

Zgoda użytkowników z UE i RODO

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.

Meta nie jest zarejestrowana na globalnej liście dostawców IAB Europe. Zamiast tego musisz użyć specyfikacji technicznej Udzielenie dodatkowej zgody. Więcej informacji znajdziesz w sekcji Składniki specyfikacji „Udzielenie dodatkowej zgody”. Specyfikacja dotycząca udzielania dodatkowej zgody działa w połączeniu z Zasadami IAB Europe dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF) w wersji 2. Ta specyfikacja umożliwia Tobie, Twoim platformom do zarządzania zgodą użytkowników (CMP) i partnerom zbieranie i przesyłanie dodatkowych sygnałów zgody w przypadku firm, które są wymienione na liście dostawców technologii reklamowych Google, ale nie są jeszcze częścią globalnej listy dostawców IAB Europe.

Postępuj zgodnie ze wskazówkami w dokumentacji Meta dotyczącej RODO i reklam w 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.

Postępuj zgodnie z wytycznymi zawartymi w dokumentacji Meta dotyczącymi opcji przetwarzania danych użytkowników z Kalifornii.

Krok 5. Dodaj wymagany kod

Integracja z siecią Meta Audience Network nie wymaga dodatkowego kodu.

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:

Reklamy natywne

Niektóre komponenty reklamy natywnej w sieci Meta Audience Network nie są mapowane w stosunku 1:1 na komponenty reklamy natywnej w Google. Takie komponenty 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`	Ciąg znaków. Unikalny identyfikator reklamy natywnej.
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	Ciąg znaków. kontekst społecznościowy reklamy,

Oto przykładowy kod pokazujący, jak wyodrębnić te komponenty:

Przykład:

Java

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

Kotlin

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

Korzystanie z reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej w sieci Meta Audience Network wymaga renderowania komponentu MediaView. Jeśli planujesz renderować reklamy natywne bez tego komponentu, użyj formatu reklamy banera natywnego Meta Audience Network.

Jeśli zamiast tego chcesz używać natywnych banerów reklamowych Meta Audience Network, podczas konfigurowania Meta Audience Network musisz wybrać formatNative Banner. Wtedy adapter automatycznie wczyta odpowiedni format reklamy natywnej.

Renderowanie reklam

Adapter sieci odbiorców zwraca reklamy natywne jako obiektyNativeAd. Zawiera te opisy pól reklam natywnych dla 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 sieci Meta Audience Network nie zapewnia bezpośredniego dostępu do głównego komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia element MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Tabela poniżej zawiera informacje o tym, kiedy Google Mobile Ads SDK (Legacy) rejestruje wyświetlenia i kliknięcia reklam natywnych.

Rejestrowanie wyświetleń	Kliknij nagranie.
1 piksel komponentu reklamy natywnej Meta Audience Network na ekranie + wymagania dotyczące renderowania komponentu	Wywołanie zwrotne pakietu SDK Meta Audience Network

Meta Audience Network ma określone wymagania dotyczące renderowania komponentów, aby wyświetlenie było uznawane za prawidłowe. Zależą one od tego, czy podczas konfigurowania Meta Audience Network wybrano format Reklama natywna czy Baner natywny.

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

Pamięć podręczna na Androidzie 9

Od Androida 9 (poziom interfejsu API 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. Aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji, postępuj zgodnie z dokumentacją Mety.

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.getAdapterResponses() tych klas:

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

Oto kody i komunikaty, które są zwracane przez adapter Audience Network, gdy nie uda się wczytać reklamy:

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.