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 używać pakietu Google Mobile Ads SDK (Legacy) do wczytywania i wyświetlania reklam z Meta Audience Network za pomocą zapośredniczenia, w tym integracji z określaniem stawek. Dowiesz się z niego, 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 funkcje:

Integracja
Określanie stawek
Kaskadowe ¹
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

¹ W 2021 r. sieć Meta Audience Network przeszła na wyłącznie określanie stawek.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

Android z interfejsem API na poziomie 24 lub wyższym.

Adapter Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecamy najnowszą wersję).

Najnowsza wersja Google Mobile Ads SDK (Legacy).
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie Meta Audience Network

Zarejestruj się i zaloguj na stronie głównej Business Managera.

Kliknij Rozpocznij, a następnie 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 odpowiednią 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 podać dane do płatności. Podaj niezbędne informacje, a następnie kliknij Dalej.

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

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

Zanotuj identyfikator miejsca docelowego.

Kliknij Gotowe.

Zaktualizuj plik app-ads.txt

Authorized Sellers for Apps (czyli plik 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 nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w Meta Audience Network, zapoznaj się z artykułem Identyfikowanie autoryzowanych sprzedawców za pomocą pliku app-ads.txt.

Włączanie trybu testowego

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

Krok 2. Skonfiguruj oferty reklamowe Meta Audience Network w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Włącz udostępnianie bezpiecznych sygnałów

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

Udostępnianie bezpiecznego sygnału w pytaniach o stawkę

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Facebook i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Kliknij Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek Meta

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz Meta.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Konfigurowanie mapowania jednostki reklamowej

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę dla Meta Audience Network.

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

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

Jeśli konfigurujesz mapowanie jednostek reklamowych na potrzeby reklamy pełnoekranowej z nagrodą w interfejsie Ad Managera, wybierz format Z nagrodą i użyj identyfikatora miejsca docelowego reklamy pełnoekranowej z nagrodą.

Na koniec kliknij Zapisz.

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

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA, aby dodać Meta do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Integracja z Android 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. Skonfiguruj ustawienia prywatności w pakiecie SDK Meta Audience Network

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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.

Firma Meta nie jest zarejestrowana na globalnej liście dostawców IAB Europe. Zamiast tego musisz używać specyfikacji technicznej Udzielenie dodatkowej zgody. Więcej informacji znajdziesz w artykule Składniki specyfikacji „Udzielenie dodatkowej zgody”. Specyfikacja dotycząca udzielenia 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, platformom do zarządzania zgodą użytkowników (CMP) i partnerom zbieranie oraz przesyłanie dodatkowych sygnałów dotyczących zgody w przypadku firm, które są zarejestrowane na liście dostawców technologii reklamowych Google (ATP), ale nie są jeszcze zarejestrowane na globalnej liście dostawców IAB Europe.

Postępuj zgodnie ze wskazówkami podanymi w dokumentacji Meta dotyczącej RODO i reklam Meta.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych o ochronie 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 łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

Aby dowiedzieć się, jakie masz opcje przetwarzania danych użytkowników z Kalifornii, zapoznaj się z dokumentacją firmy Meta.

Krok 5. Dodaj wymagany kod

Integracja z Meta Audience Network nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

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

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Meta Audience Network, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Reklamy natywne

Niektóre komponenty reklam natywnych Meta Audience Network nie są mapowane jeden do jednego na komponenty reklam natywnych 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 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);
  // ...
}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

Używanie reklam natywnych Meta Audience Network bez obiektu MediaView

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

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

renderowanie reklam

Adapter Audience Network zwraca reklamy natywne jako obiekty NativeAd. Wypełnia te pola w przypadku NativeAd.

Pole	Wypełniane 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 komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Poniższa tabela pokazuje, kiedy Google Mobile Ads SDK (Legacy) rejestruje wyświetlenia reklam i kliknięcia reklam natywnych.

Rejestrowanie wyświetleń	Nagrywanie kliknięć
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, które muszą zostać spełnione, aby wyświetlenie zostało uznane za prawidłowe. Zależą one od tego, czy podczas konfigurowania Meta Audience Network wybrano format Natywny czy Baner natywny.

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

Zapisywanie w pamięci podręcznej na Androidzie 9

Od Androida 9 (poziom interfejsu API 28) obsługa tekstu nieszyfrowanego jest domyślnie wyłączona, co wpływa na działanie 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ą Meta.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Audience Network, możesz sprawdzić błąd w odpowiedzi na reklamę, używając ResponseInfo.getAdapterResponses() w tych klasach:

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

Oto kody i towarzyszące im komunikaty, które adapter Audience Network wyświetla, 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 Meta Audience Network.
103	Wydawca musi żądać reklam w kontekście `Activity`.
104	Nie udało się zainicjować pakietu SDK Meta Audience Network.
105	Wydawca nie wysłał żądania 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 danych o stawce.
110	Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej ani reklamy z nagrodą.
111	Podczas tworzenia obiektu Meta Audience Network `AdView` został zgłoszony wyjątek.
1000-9999	Meta Audience Network zwróciła błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network.

Lista zmian adaptera zapośredniczenia Meta Audience Network na Androida