Integracja Meta Audience Network z określaniem stawek

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z sieci reklamowej Meta Audience Network przy użyciu zapośredniczenia, w tym integracji z licytowaniem. Wyjaśniamy w nim, jak dodać Meta Audience Network do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować Meta Audience Network i adapter z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

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

Integracja
Określanie stawek
Kaskada 1
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

1 W 2021 r. sieć Meta Audience Network zaczęła obsługiwać tylko licytowanie.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Flutter w wersji 3.7.0 lub nowszej
  • Wdrażanie na Androidzie
    • Android API na poziomie 23 lub wyższym
  • Wdrażanie na iOS
    • iOS w wersji 10.0 lub nowszej
    • Najnowszy pakiet SDK sieci Meta Audience Network zwykle wymaga najnowszej wersji Xcode.
  • Działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie sieci reklamowej Meta

Zarejestruj się i zaloguj na stronie początkowej Business Managera.

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

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

Tworzenie usługi

Po wypełnieniu wymaganych informacji wyświetli się prośba o utworzenie usługi dla aplikacji. Wpisz wybraną nazwę usługi dla aplikacji i kliknij Dalej.

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

Dodaj szczegóły aplikacji i kliknij Dalej.

Android

iOS

Skonfiguruj konto płatności, klikając Dodaj nowe konto płatności. Przekierujemy Cię na nową stronę, na której możesz wpisać dane do płatności. Wypełnij wymagane pola, a następnie kliknij Dalej.

Jako Platformę do zapośredniczenia wybierz Google AdMob, a następnie kliknij Utwórz miejsce docelowe.

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

Zanotuj identyfikator miejsca docelowego.

Kliknij Gotowe.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt dla swojej aplikacji.

Aby wdrożyć app-ads.txt w przypadku Meta Audience Network, zapoznaj się z artykułem Identyfikowanie autoryzowanych sprzedawców za pomocą pliku app-ads.txt.

Włączanie trybu testowego

Szczegółowe instrukcje włączania reklam testowych w sieci Meta Audience Network znajdziesz w tym przewodniku.

Krok 2. Skonfiguruj popyt z Meta Audience Network w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika dotyczącego iOS.

Dodawanie Meta do listy partnerów reklamowych objętych RODO i przepisami stanowymi w USA

Aby dodać Meta do listy partnerów reklamowych wyświetlanych w wiadomościach zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter sieci Meta Audience Network

Integracja za pomocą pub.dev

Dodaj do pliku pubspec.yaml pakietu tę zależność z najnowszymi wersjami pakietu Meta Audience Network SDK i adaptera:

dependencies:
  gma_mediation_meta: ^

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Meta Audience Network, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z jego zawartością) do projektu Flutter. Następnie odwołaj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK sieci reklamowej Meta

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych środków do lokalnego przechowywania danych (jeśli jest to wymagane przez prawo) oraz na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

Informacje o RODO i reklamach Meta znajdziesz w wskazówkach Meta.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA 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 Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

W przypadku użytkowników z Kalifornii zapoznaj się z opcjami przetwarzania danych oferowanymi przez Meta.

Krok 5. Dodaj wymagany kod

Android

Integracja z siecią Meta Audience Network nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z instrukcjami w dokumentacji Meta Audience Network.

Śledzenie reklam włączone

Jeśli tworzysz aplikację na iOS 14 lub nowszą wersję tego systemu, zapoznaj się z instrukcjami Meta Audience Network dotyczącymi ustawiania flagi śledzenia reklam.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob i włączono tryb testowy w interfejsie Meta Audience Network.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Meta Audience Network, włącz w Inspektorze reklam testowanie pojedynczego źródła reklam za pomocą źródła lub źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Pamięć podręczna w Androidzie 9

Android

Od Androida 9 (poziom API 28) obsługa tekstu jawnego jest domyślnie wyłączona, co wpłynie na funkcjonalność buforowania multimediów w pakiecie Meta Audience Network SDK i może mieć wpływ na wrażenia użytkowników oraz przychody z reklam. Aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji, postępuj zgodnie z dokumentacją Mety.

iOS

Nie dotyczy integracji z iOS.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Audience Network, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z ResponseInfo w tych klasach:

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Oto kody i komunikaty wyświetlane przez adapter Meta Audience Network, gdy nie uda się wczytać reklamy:

Android

Kod błędu Przyczyna
101 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
102 Rozmiar żądanej reklamy nie pasuje do rozmiaru banera obsługiwanego przez sieć Meta Audience Network.
103 Wydawca musi wysyłać żądania reklam z kontekstem Activity.
104 Nie udało się zainicjować pakietu Meta Audience Network SDK.
105 Wydawca nie poprosił o wyświetlenie ujednoliconych reklam natywnych.
106 Wczytana reklama natywna jest innym obiektem niż oczekiwany.
107 Użyty obiekt Context jest nieprawidłowy.
108 W załadowanej reklamie brakuje wymaganych komponentów reklamy natywnej.
109 Nie udało się utworzyć reklamy natywnej na podstawie ładunku stawki.
110 Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej ani reklamy z nagrodą.
111 Podczas tworzenia obiektu Meta Audience Network AdView wystąpił wyjątek.
1000-9999 Meta Audience Network zwróciła błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej Meta.

iOS

Kod błędu Przyczyna
101 Nieprawidłowe parametry serwera (np. brak identyfikatora miejsca docelowego).
102 Rozmiar żądanej reklamy nie pasuje do rozmiaru banera obsługiwanego przez sieć Meta Audience Network.
103 Nie udało się zainicjować obiektu reklamy w sieci Meta Audience Network.
104 Pakiet SDK Meta Audience Network nie wyświetlił reklamy pełnoekranowej ani reklamy z nagrodą.
105 Główny kontroler widoku banera reklamowego to nil.
106 Nie udało się zainicjować pakietu Meta Audience Network SDK.
1000-9999 Meta Audience Network zwróciła błąd specyficzny dla pakietu SDK. Więcej informacji znajdziesz w dokumentacji sieci reklamowej Meta.

Dziennik zmian adaptera zapośredniczenia Fluttera w Meta Audience Network

Wersja 1.4.1

Wersja 1.4.0

Wersja 1.3.0

Wersja 1.2.0

Wersja 1.1.0

Wersja 1.0.1

  • Dodano klasę dart, aby umożliwić prawidłową analizę zgodności z platformami hosta
  • Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

Wersja 1.0.0

  • Pierwsza wersja.
  • Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.