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

Zintegruj 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 mediacji, 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 Android .

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ą
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

Interfejs API Androida na poziomie 21 lub wyższym

Adapter Meta Audience Network w wersji 5.10.0.0 lub nowszej (zalecana najnowsza wersja)

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 Ad Manager interfejsie użytkownika

Zaloguj się na konto Ad Managera.

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

Kliknij Administracja > Ustawienia globalne Przejdź do Karta Ustawienia konta Ad Exchange, sprawdź ją i włącz Udostępnianie bezpiecznych sygnałów Kliknij Zapisz.

Skonfiguruj określanie stawek w metadanych

Ad Manager 360

Kliknij Wyświetlanie > Licytujący, a następnie kliknij Nowy licytujący w kolumnie Karta Określanie stawek przez pakiet SDK.

Jako licytującego wybierz Meta.

Włącz opcję 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 Wyświetlanie > Licytujący, a następnie kliknij Nowy licytujący w kolumnie Karta Określanie stawek przez pakiet SDK.

Jako licytującego wybierz Meta.

Kliknij Zarejestruj się online teraz. Następnie w oknie dialogowym kliknij Tak, zgadzam się. zostaną przekierowani do witryny Facebooka, aby rozpocząć proces rejestracji.

Zaloguj się przez swoje Konto Business Manager.

Wybierz swoją firmę.

Po wybraniu firmy pojawi się następujące okno dialogowe. Kliknij przycisk Wstecz do Ad Managera.

Włącz opcję 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.

Skonfiguruj mapowanie jednostek reklamowych

Kliknij Wyświetlanie > Licytujący i wybierz firmę Meta kartę Określanie stawek przez pakiet SDK.

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

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, a następnie Aplikacja mobilna jako typ zasobów reklamowych i aplikację mobilną. Następnie wpisz uzyskane w poprzedniej sekcji. Na koniec kliknij Zapisz.

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 Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK i adapter Meta Audience Network

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Użyj najnowszych wersji listy odbiorców Meta Pakiet SDK i adapter sieci:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:facebook:6.17.0.0")
}

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Meta Audience Network dla platformy na urządzeniu z Androidem. Rozpakuj AudienceNetwork.aar w folderze AudienceNetwork/bin i dodaj ją do projektu.
Przejdź do adaptera Meta Audience Network. artefakty w repozytorium Google Maven. Wybierz najnowszą wersję i pobierz platformę Meta pliku .aar adaptera Audience Network i dodaj go do projektu.

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 zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić 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

Do integracji Meta Audience Network nie jest wymagany żaden dodatkowy kod.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager 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 pakiecie, korzystając z metody getExtras() w narzędziu NativeAd. Przejściówka umożliwia przekazywanie tych zasobó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, który pokazuje, 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);
    // ...
}

Kotlin

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
   var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
   // ...
}

Używanie reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej Meta Audience Network wymaga renderowania MediaView 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 NativeAd obiektów. Zawiera te dane pola dla NativeAd

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 MediaView 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	`MediaView`
Baner natywny	Ikona aplikacji	`ImageView`

Pamięć podręczna na Androidzie 9

Począwszy od Androida 9 (poziom interfejsu API 28) obsługa niejawnego tekstu jest domyślnie wyłączona, co wpłynie na działanie buforowania multimediów przez Meta Audience. pakietu SDK sieci, co może wpływać na wrażenia użytkowników i przychody z reklam. Obserwuj Dokumentacja Mety , aby zaktualizować konfigurację zabezpieczeń sieci w Twojej aplikacji.

Kody błędów

Jeśli adapter nie odbierze reklamy z sieci Audience Network, możesz sprawdzić bazowy błąd w odpowiedzi na żądanie reklamy za pomocą funkcji ResponseInfo.getAdapterResponses() w następujących klasach:

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

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 .