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

Integracja Meta Audience Network z określaniem stawek

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Meta Audience Network za pomocą zapośredniczenia AdMob, obejmujących integracje określania 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 iOS aplikacją.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia dla Meta Audience Network ma te możliwości:

Integracja
Ustalanie stawek
Kaskada ¹
Formaty
Baner
Pełnoekranowa
Otrzymano
Pełnoekranowa z nagrodą
Natywna

¹ W 2021 r. platforma Meta Audience Network była jej określaniem stawek tylko.

Wymagania

Najnowszy pakiet SDK do reklam mobilnych Google
Wykonaj zapośredniczenie Przewodnik dla początkujących

Cel wdrożenia iOS w wersji 10.0 lub nowszej
Adapter Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja)
Najnowszy pakiet Meta Audience Network SDK zwykle wymaga najnowszej wersji Xcode

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Meta Audience Network

Zarejestruj się i zaloguj się na stronie startowej platformy Business Manager.

Kliknij Rozpocznij, a następnie Utwórz nowe konto.

Wypełnij wymagane pola informacjami o firmie i kliknij Dalej.

Tworzenie usługi

Gdy podasz wymagane informacje, pojawi się prośba o utworzenie usługi dla aplikacji. Wpisz odpowiednią nazwę usługi i kliknij Dalej.

Następnie wybierz platformę, na której chcesz zarabiać.

Dodaj szczegóły aplikacji i kliknij Dalej.

Kliknij Dodaj nowe konto płatności, aby skonfigurować konto płatności. Przekierujemy Cię na nową stronę, na której możesz podać dane do płatności. Podaj wymagane informacje i kliknij Dalej.

Wybierz Google AdMob jako platformę zapośredniczenia, a następnie kliknij Utwórz miejsce docelowe.

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

Zapisz Identyfikator miejsca docelowego.

Kliknij Gotowe.

Włącz tryb testowy

Szczegółowe instrukcje, jak włączyć reklamy testowe Meta Audience Network, znajdziesz w przewodniku po implementacji sieci odbiorców.

Krok 2. Skonfiguruj żądania Meta Audience Network w AdMob interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Meta Audience Network jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę zapośredniczenia 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ą istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj Meta Audience Network jako źródło reklam

Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie kliknij Meta Audience Network.

Kliknij Jak podpisać umowę partnerską i zawrzeć umowę partnerską z firmąMeta Audience Network.

Kliknij Potwierdzam i akceptuję, a następnie kliknij Dalej.

Jeśli masz już mapowanie Meta Audience Network, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Placement IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Dodaj Facebook do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Facebook do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Używanie CocoaPods (zalecane)

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

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Meta Audience Network SDK na iOS i połącz usługę FBAudienceNetwork.framework w swoim projekcie.
Pobierz najnowszą wersję adaptera Meta Audience Network z linku pobierania w dzienniku zmian i połącz MetaAdapter.framework w swoim projekcie.

Krok 4. Wdróż 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 dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

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

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi 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. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Aby dowiedzieć się więcej o opcjach przetwarzania danych dla użytkowników w Kalifornii, postępuj zgodnie ze wskazówkami zawartymi w dokumentacji Mety.

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ć poniższe czynności, aby dodać ścieżki Swift do ustawień kompilacji celu i uniknąć błędów kompilacji.

Dodaj te ścieżki do Ustawień kompilacji w sekcji Ścieżki wyszukiwania bibliotek:

$(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:

/usr/lib/swift

Śledzenie reklam włączone

Jeśli tworzysz kreacje na iOS 14 lub nowszego, Meta Audience Network wymaga wyraźnego ustawienia flagi Advertising Tracking Enabled (Włączone śledzenie reklam) za pomocą tego kodu:

Swift

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

Objective-C

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

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją Meta Audience Network, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Meta Audience Network interfejsie użytkownika.

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Reklamy natywne

Niektóre zasoby reklamy natywnej Meta Audience Network nie mapują zasobów reklamy natywnej w sposób jeden do jednego. Takie zasoby są przekazywane z powrotem do wydawcy we właściwości extraAssets elementu GADNativeAd. Obsługuje ona przekazywanie tych zasobów:

Parametry i wartości żądania
`GADFBSubtitle`	Ciąg znaków. Podtytuł reklamy
`GADFBSocialContext`	Ciąg znaków. Kontekst społecznościowy 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];

Używanie reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej Meta Audience Network wymaga wyrenderowania zasobu GADMediaView . Jeśli planujesz renderować reklamy natywne bez tego zasobu, pamiętaj o użyciu formatu reklamy banera natywnego firmy 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 sieci Audience Network zwraca swoje reklamy natywne jako obiekty GADNativeAd . Uzupełnia te pola: opisy pól reklam natywnych GADNativeAd

Pole	Wypełnianie 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 zasobu graficznego reklam natywnych. Zamiast tego adapter wypełnia GADMediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

W tabeli poniżej znajdziesz informacje o tym, kiedy wyświetlenia i kliknięcia reklam natywnych są rejestrowane przez pakiet SDK do reklam mobilnych Google.

Rejestrowanie wyświetleń	Nagrywanie kliknięć
1 piksel na ekranie zasobu reklamy natywnej Meta Audience Network + wymagania dotyczące renderowania zasobów	Wywołanie zwrotne pakietu SDK Meta Audience Network

Aby wyświetlenie zostało uznane za prawidłowe, sieć Meta Audience Network ma określone wymagania w zakresie renderowania zasobów. Zależy to od tego, czy podczas konfigurowania sieci Meta Audience Network wybrano format Natywna czy Baner natywny.

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci Audience Network, możesz sprawdzić podstawowy błąd w odpowiedzi za pomocą opcji GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMAdapterFacebook
GADMediationAdapterFacebook

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter Audience Network, gdy nie udało 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 wysyłać żądania reklam z kontekstem `Activity`.
104	Nie udało się zainicjować pakietu SDK Meta Audience Network.
105	Wydawca nie zażądał ujednoliconych reklam natywnych.
106	Wczytana reklama natywna jest innym obiektem niż oczekiwano.
107	Użyty obiekt `Context` jest nieprawidłowy.
108	W wczytanej reklamie brakuje wymaganych komponentów reklamy natywnej.
109	Nie udało się utworzyć reklamy natywnej na podstawie zestawu stawek.
110	Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej lub z nagrodą.
111	Podczas tworzenia obiektu Meta Audience Network `AdView` zostaje zgłoszony wyjątek.
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	Nie udało się zainicjować obiektu reklamy Meta Audience Network.
104	Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej lub z nagrodą.
105	Główny kontroler widoku banera reklamowego to `nil`.
106	Nie udało się zainicjować pakietu SDK Meta Audience Network.
1000-9999	Sieć Meta Audience Network zwróciła błąd związany z pakietem SDK. Więcej informacji znajdziesz w dokumentacji Meta Audience Network.

Dziennik zmian adaptera zapośredniczenia Meta Audience Network iOS

Wersja 6.15.1.0

Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.15.1.

Zaprojektowane i przetestowane:

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

Wersja 6.15.0.0

Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.15.0.
Teraz wymaga to systemu iOS w wersji co najmniej 12.0.
Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
Uwzględniono Info.plist w platformach MetaAdapter.xcframework.
Z mechanizmów renderowania banerów i reklam pełnoekranowych usunęliśmy wycofane metody przekazywania uprawnień willBackgroundApplication.
Zastąpiono wycofaną metodę GADMobileAds.sharedInstance.sdkVersion metodą GADMobileAds.sharedInstance.versionNumber.

Zaprojektowane i przetestowane:

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

Wersja 6.14.0.0

Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.14.0.

Zaprojektowane i przetestowane:

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

Wersja 6.12.0.2

Usunięto z adaptera wszystkie mechanizmy weryfikacji stawek.
Usunięto obsługę architektury armv7.
Teraz wymaga to systemu iOS w wersji co najmniej 11.0.
Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Zaprojektowane i przetestowane:

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

Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Zaprojektowane i przetestowane:

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 używał interfejsu API didRewardUser.
Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.12.0.

Zaprojektowane i przetestowane:

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

Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.11.2.

Zaprojektowane i przetestowane:

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

Zweryfikowano zgodność z pakietem SDK Meta Audience Network 6.11.1.
Dzienniki adaptera odnoszą się teraz do adaptera jako „Meta Audience Network”.

Zaprojektowane i przetestowane:

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

Potwierdzono zgodność z pakietem SDK FAN 6.11.0.

Zaprojektowane i przetestowane:

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

Wersja 6.10.0.0

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

Zaprojektowane i przetestowane:

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

Wersja 6.9.0.1

Zweryfikowano zgodność z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
Teraz wymaga pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Zaprojektowane i przetestowane:

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