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

Integracja Meta Audience Network z określaniem stawek

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Meta Audience Network za pomocą zapośredniczenia AdMob, które obejmuje integracje 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 z aplikacją. iOS

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
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

docelowa wersja iOS: 10.0 lub nowsza,
adapter Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja);
Najnowsza wersja pakietu SDK Meta Audience Network zwykle wymaga najnowszej wersji Xcode

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 na reklamy z sieci Audience Network w AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać sieć Meta Audience Network do konfiguracji pośrednictwa dla 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 zapośredniczenia 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 następnie 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 w interfejsie AdMob zgodnych z RODO i przepisami stanowymi w USA, wykonaj czynności opisane w sekcji Ustawienia dotyczące RODO i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Za pomocą CocoaPods (zalecane)

Dodaj ten wiersz do pliku Podfile projektu:
```
pod 'GoogleMobileAdsMediationFacebook'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Meta Audience Network na iOS i w swoim projekcie połącz go z usługą FBAudienceNetwork.framework.
Pobierz najnowszą wersję adaptera Meta Audience Network, korzystając z linku do pobrania w Changelog i linku MetaAdapter.framework w projekcie.

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 Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej podmiotu sprzedającego dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik po przepisach stanowych 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

Błędy kompilacji

Swift

Integracja z Swift nie wymaga dodatkowego kodu.

Objective-C

W przypadku adaptera Meta Audience Network w wersji 6.9.0.0 lub nowszej musisz wykonać czynności opisane poniżej, aby dodać ścieżki Swift do ustawień kompilacji celu uniknięcia błędów kompilacji.

Dodaj te ścieżki do ustawień kompilacji w sekcji Ścieżki w bibliotece:

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(SDKROOT)/usr/lib/swift

Dodaj tę ścieżkę do Ustawień kompilacji w sekcji Ścieżki wyszukiwania ścieżki wykonania:

/usr/lib/swift

Śledzenie reklam włączone

Jeśli aplikacja jest przeznaczona na iOS 14 lub nowszy, Meta Audience Network wymaga, abyś wyraźnie ustawił flagę Advertising Tracking Enabled za pomocą tego kodu:

Swift

// Set the flag as true
FBAdSettings.setAdvertiserTrackingEnabled(true)

Objective-C

// Set the flag as true.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

Integracja z SKAdNetwork

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Zarejestruj urządzenie testowe w AdMob i włącz 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 za pomocą źródeł reklam Meta Audience Network (z określaniem stawek).

Kroki opcjonalne:

Reklamy natywne

Niektóre komponenty reklam natywnych w sieci Meta Audience Network nie są mapowane jeden do jednego na komponenty reklam natywnych w Google. Takie zasoby są przekazywane wydawcy w usłudze extraAssets w usługach GADNativeAd. Adapter obsługuje przekazywanie tych komponentów:

Parametry i wartości żądania
`GADFBSubtitle`	String. Podtytuł reklamy
`GADFBSocialContext`	String. kontekst społeczny reklamy,

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

Swift

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

Korzystanie z reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej w sieci Meta Audience Network wymaga renderowania zasobu GADMediaView . Jeśli planujesz renderowanie reklam natywnych bez tego zasobu, użyj natywnego banera formatu reklamy 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 GADNativeAd . Wypełnia te opisy pól w reklamach natywnych w GADNativeAd.

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 GADMediaView 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	`GADMediaView`
Baner natywny	Ikona aplikacji	`UIImageView`

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 GADResponseInfo.adNetworkInfoArray w ramach tych klas:

GADMAdapterFacebook
GADMediationAdapterFacebook

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	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 sterujący widokiem głównym banera reklamowego to `nil`.
106	Nie udało się zainicjować pakietu SDK 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.

Meta Audience Network: Zapośredniczenie na iOS – lista zmian

Wersja 6.16.0.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.16.0. Built and tested with:
Pakiet SDK do reklam mobilnych Google w wersji 11.11.0.
Pakiet SDK Meta Audience Network w wersji 6.16.0.

Wersja 6.15.2.1

Zaktualizowaliśmy komponent CFBundleShortVersionString, tak aby zawierał 3 elementy zamiast 4.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
Pakiet SDK Meta Audience Network w wersji 6.15.2.

Wersja 6.15.2.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.15.2.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.8.0.
Pakiet SDK Meta Audience Network w wersji 6.15.2.

Wersja 6.15.1.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.15.1.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
Wersja SDK Meta Audience Network 6.15.1.

Wersja 6.15.0.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.15.0.
Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
Uwzględnij Info.plist w ramach MetaAdapter.xcframework.
Usunięto przestarzałe metody delegowania willBackgroundApplication z renderowania banerów i interaktywnych reklam w wyświetlaczu.
Wycofana metoda GADMobileAds.sharedInstance.sdkVersion została zastąpiona metodą GADMobileAds.sharedInstance.versionNumber.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
Wersja SDK Meta Audience Network 6.15.0.

Wersja 6.14.0.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.14.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.9.0.
Meta Audience Network SDK w wersji 6.14.0.

Wersja 6.12.0.2

Usunięto wszystkie weryfikacje stawek w adapterze.
Usunięto obsługę architektury armv7.
Teraz wymaga co najmniej iOS 11.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
Pakiet SDK Meta Audience Network w wersji 6.12.0.

Wersja 6.12.0.1

Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
Pakiet SDK Meta Audience Network w wersji 6.12.0.

Wersja 6.12.0.0

Usunięto obsługę kaskady z adaptera.
Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.12.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.11.0.
Pakiet SDK Meta Audience Network w wersji 6.12.0.

Wersja 6.11.2.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.11.2.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.7.0.
Pakiet SDK Meta Audience Network w wersji 6.11.2.

Wersja 6.11.1.0

Weryfikowana zgodność z pakietem SDK Meta Audience Network w wersji 6.11.1.
W logach adaptera występuje teraz nazwa „Meta Audience Network”.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
Pakiet SDK Meta Audience Network w wersji 6.11.1.

Wersja 6.11.0.0

Zweryfikowana zgodność z pakietem FAN SDK 6.11.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.4.0.
Pakiet SDK FAN w wersji 6.11.0.

Wersja 6.10.0.0

Zweryfikowana zgodność z FAN SDK w wersji 6.10.0.
Dodano obsługę przekazywania wywołań zwrotnych kliknięć i wyświetleń w reklamach z ustalaniem stawek.
Dodaliśmy komunikaty ostrzegawcze dotyczące wycofania kaskadowego zapośredniczenia. Więcej informacji znajdziesz na blogu Meta Audience Network.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.3.0.
Wersja pakietu SDK FAN 6.10.0.

Wersja 6.9.0.1

Wersja zweryfikowana pod kątem zgodności z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
Wersja pakietu SDK FAN 6.9.0.