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

Integracja Meta Audience Network z określaniem stawek

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z Meta Audience Network wykorzystujące Zapośredniczenie AdMob, dotyczące integracji określania stawek. Omawiamy, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej i integrowaniu odbiorców Meta Audience. Pakiet SDK sieci i adapter do aplikacji iOS .

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Wodospad ¹.
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

¹ Meta Audience Network stał się tylko określanie stawek w 2021 r.

Wymagania

Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ 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)
Najnowsza wersja pakietu SDK Meta Audience Network zwykle wymaga najnowszej wersji wersja Xcode

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

Click Get started then Create new account.

Fill out the required fields with your business details and click Next.

Create a property

After you've filled out the required information, you're prompted to create a property for your app. Enter the desired name of the property for your app and click Next.

Next, select your platform to monetize.

Add your app details and click Next.

Set up your payment account by clicking Add a new payment account. You will be redirected to a new page to enter your payment information. Fill out the necessary details, then click Next.

Select Google AdMob as the Mediation platform, then click Create placement.

Select a format, fill out the form and click Create.

Take note of the Placement ID.

Click Done.

Turn on test mode

See the Testing Audience Network Implementation guide for detailed instructions on how to enable Meta Audience Network test ads.

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 dla platformy iOS i połącz projekt FBAudienceNetwork.framework w swoim projekcie.
Pobierz najnowszą wersję adaptera Meta Audience Network ze link do pobierania w historii zmian. i połącz projekt 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

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

Postępuj zgodnie ze wskazówkami z dokumentacji Mety w związku z przepisami RODO i platformą Meta.

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj według wskazówek każdej z tych sieci, zgodność z przepisami.

Postępuj zgodnie ze wskazówkami w artykule Dokumentacja Mety dotyczące opcji przetwarzania danych w przypadku użytkowników w Kalifornii.

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 przestrzegać te czynności, by dodać ścieżki Swift do ustawień kompilacji celu. błędów kompilacji.

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

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

/usr/lib/swift

Śledzenie reklam włączone

Jeśli tworzysz kreacje na iOS 14 lub nowszego, Meta Audience Network wymaga ustawienie funkcji śledzenia reklam Włączono 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 Reklama natywna w Meta Audience Network zasoby nie są mapowane jeden do jednego na zasoby reklamy natywnej Google. Takie komponenty zostały przekazane z powrotem do wydawcy w usłudze extraAssets GADNativeAd. umożliwia przekazywanie następujących 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 renderowania GADMediaView. zasób. Jeśli planujesz renderować reklamy natywne bez tego komponentu, użyj tagu Meta Audience Network baner natywny format reklamy.

Aby zamiast tego używać natywnych banerów reklamowych Meta Audience Network, musisz wybrać Native Banner podczas konfigurowania Meta Audience Network oraz spowoduje automatyczne wczytanie odpowiedniego formatu reklamy natywnej.

Renderowanie reklam

Adapter sieci Audience Network zwraca swoje reklamy natywne jako GADNativeAd obiektów. Zawiera te dane Opisy pól reklam natywnych dla 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 komponentu z obrazem. dla swoich reklam natywnych. Zamiast tego adapter wypełnia pole GADMediaView. z filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Tabela poniżej zawiera informacje o tym, kiedy są rejestrowane wyświetlenia i kliknięcia reklamy natywnej za pomocą pakietu 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

Meta Audience Network ma określone wymagania renderowania zasobów, które pozwalają na wyświetlenie zostało uznane za prawidłowe w zależności od tego, czy została wybrana format natywny lub natywny baner podczas konfigurowania odbiorców Meta Audience, Sieć.

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 odbierze reklamy z sieci Audience Network, możesz sprawdzić bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji GADResponseInfo.adNetworkInfoArray. w następujących klasach:

GADMAdapterFacebook
GADMediationAdapterFacebook

Oto kody i powiązane z nimi komunikaty wysyłane przez Audience Network adaptera, gdy reklama nie wczytuje się:

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. Zobacz Dokumentacja 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.