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

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 Meta Audience Network

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 niezbędne pola, a potem 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 jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

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 przewodniku po testowaniu implementacji sieci reklamowej.

Krok 2. Skonfiguruj popyt Meta Audience Network w interfejsie Ad Managera

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, którzy przestrzegają RODO i przepisów stanowych w USA

Aby dodać Meta do listy partnerów reklamowych objętych rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, 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 Audience Network od Meta

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymywali określone informacje i wyrażali 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). Gdy prosisz użytkowników o zgodę, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może zbierać, otrzymywać lub wykorzystywać dane osobowe, oraz podać informacje o sposobie wykorzystywania danych przez każdą z tych sieci. Google nie może obecnie automatycznie przekazywać do takich sieci informacji o wyborze 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 amerykańskich stanach 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” („Proszę nie sprzedawać moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 zapośredniczenia. 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 firmę Meta.

Krok 5. Dodaj wymagany kod

Android

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

iOS

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją 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 zarejestrujesz urządzenie testowe w usłudze Ad Manager i włączysz 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, korzystając ze źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Pamięć podręczna w Androidzie 9

Android

Od Androida 9 (poziom interfejsu 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 sieci 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 towarzyszące, które są zwracane 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 SDK Meta Audience Network.
105 Wydawca nie poprosił o wyświetlanie 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 zdołał 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 zdołał 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 SDK Meta Audience Network.
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.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.