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

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 Ad Manager interfejsie

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 sekcji Ustawienia 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

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

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

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 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 pola w przypadku 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 główny widoku banera reklamowego to `nil`.
106	Nie udało się zainicjować pakietu SDK Meta Audience Network.
1000-9999	Meta Audience Network zwróciła 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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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