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 z wykorzystaniem zapośredniczenia, w tym integracji określania stawek. Dowiesz się z niego, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować Meta Audience Network i dostosować ją do aplikacji na Unity.

Obsługiwane integracje i formaty reklam

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

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

1 Meta Audience Network zaczęła określać stawki tylko w 2021 r.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity w wersji 5.6 lub nowszej
  • Wtyczka zapośredniczenia reklam mobilnych Google dla Meta Audience Network 2.11.0 (zalecana wersja)
  • Aby przeprowadzić wdrożenie na Androidzie:
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Aby wdrożyć w iOS:
    • Docelowe wdrożenie systemu iOS w wersji 10.0 lub nowszej
    • Najnowsza wersja pakietu Meta Audience Network SDK zwykle wymaga najnowszej wersji Xcode.
  • Działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Wykonaj czynności opisane w przewodniku dla początkujących po zapośredniczeniu.

Krok 1. Skonfiguruj konfiguracje w interfejsie 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.

Android

iOS

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 oferty reklamowe Meta Audience Network w AdMob interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

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

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla MetaAudience Network, korzystając z linku do pobierania w Historii zmian i wyodrębnij GoogleMobileAdsFacebookMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz Assets > Import Package > Custom Package (Zasoby > Importuj pakiet > Pakiet niestandardowy) i znajdź pobrany plik GoogleMobileAdsFacebookMediation.unitypackage. Zaznacz wszystkie pliki i kliknij Importuj.

Wybierz Zasoby > Narzędzie do rozpoznawania w Usługach Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności w Usługach Play Unity wykonuje wtedy rozpoznawanie zależności od podstaw i kopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji na Unity.

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie SDK Meta Audience Network

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.

Zapoznaj się z wytycznymi firmy Meta, aby dowiedzieć się więcej o reklamach w wynikach RODO i metadanych.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

Jeśli jesteś użytkownikiem z Kalifornii, zapoznaj się z opcjami przetwarzania danych firmy Meta.

Krok 5. Dodaj wymagany kod

Android

Integracja z Meta Audience Network nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

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

Śledzenie reklam włączone

Jeśli tworzysz wersję do systemu iOS 14 lub nowszego, zapoznaj się z instrukcjami na stronie Meta Audience Network, aby dowiedzieć się, jak ustawić flagę śledzenia reklam.

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:

Buforowanie na Androidzie 9

Android

Począwszy od Androida 9 (poziom interfejsu API 28) obsługa tekstu zwykłego jest domyślnie wyłączona, co wpływa na działanie buforowania multimediów w pakiecie Meta Audience Network SDK i może mieć wpływ na wrażenia użytkowników i przychody z reklam. Postępuj zgodnie z dokumentacją Meta, aby zaktualizować konfigurację zabezpieczeń sieci w swojej aplikacji.

iOS

Opcja niedostępna w przypadku integracji z iOS.

Kody błędów

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

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

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

Android

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 zażądać 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 ma inny obiekt niż oczekiwano.
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 z ładunku stawki.
110 Pakiet SDK Meta Audience Network SDK nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą.
111 Podczas tworzenia obiektu Meta Audience Network AdView został zgłoszony wyjątek.
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.

iOS

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 Nie udało się zainicjować obiektu reklamowego Meta Audience Network.
104 Pakiet SDK Meta Audience Network SDK nie wyświetlił reklamy pełnoekranowej lub reklamy z nagrodą.
105 Kontroler widoku głównego 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.

Historia zmian wtyczki Unity Mediation sieci Meta Audience

Wersja 3.12.0

Wersja 3.11.0

Wersja 3.10.0

Wersja 3.9.1

Wersja 3.9.0

Wersja 3.8.0

Wersja 3.7.0

Wersja 3.6.1

Wersja 3.6.0

Wersja 3.5.0

Wersja 3.4.0

Wersja 3.3.2

Wersja 3.3.1

Wersja 3.3.0

Wersja 3.2.0

Wersja 3.1.0

Wersja 3.0.0

Wersja 2.12.0

Wersja 2.11.1

Wersja 2.11.0

Wersja 2.10.0

Wersja 2.9.2

Wersja 2.9.1

Wersja 2.9.0

Wersja 2.8.1

Wersja 2.8.0

Wersja 2.7.1 (wycofana, użyj wersji 2.8.0 lub nowszej)

Wersja 2.7.0 (wycofana, użyj wersji 2.8.0 lub nowszej)

Wersja 2.6.1 (wycofana, użyj wersji 2.8.0 lub nowszej)

Wersja 2.6.0

Wersja 2.5.1

  • Obsługuje adapter Facebooka na Androida w wersji 5.5.0.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.5.1.0.

Wersja 2.5.0

  • Obsługuje adapter Facebooka na Androida w wersji 5.5.0.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.5.0.0.

Wersja 2.4.1

  • Obsługuje adapter Facebooka na Androida w wersji 5.4.1.1.
  • Obsługuje adapter Facebooka na iOS w wersji 5.4.0.0.

Wersja 2.4.0

  • Obsługuje adapter Facebooka na Androida w wersji 5.4.0.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.4.0.0.

Wersja 2.3.2

  • Obsługuje adapter Facebooka na Androida w wersji 5.3.1.2.
  • Obsługuje adapter Facebooka na iOS w wersji 5.3.2.0.

Wersja 2.3.1

  • Obsługuje adapter Facebooka na Androida w wersji 5.3.1.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.3.2.0.

Wersja 2.3.0

  • Obsługuje adapter Facebooka na Androida w wersji 5.3.0.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.3.0.0.

Wersja 2.2.0

  • Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą w otwartej wersji beta.
  • Obsługuje adapter Facebooka na Androida w wersji 5.2.0.1.
  • Obsługuje adapter Facebooka na iOS w wersji 5.2.0.1.

Wersja 2.1.1

  • Obsługuje adapter Facebooka na Androida w wersji 5.1.0.1.
  • Obsługuje adapter Facebooka na iOS w wersji 5.1.0.0.

Wersja 2.1.0

  • Obsługuje adapter Facebooka na Androida w wersji 5.1.0.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.1.0.0.

Wersja 2.0.0

  • Obsługuje adapter Facebooka na Androida w wersji 5.0.1.0.
  • Obsługuje adapter Facebooka na iOS w wersji 5.0.1.0.

Wersja 1.2.1

  • Obsługuje adapter Facebooka na Androida w wersji 4.99.3.0.
  • Obsługuje adapter Facebooka na iOS w wersji 4.99.3.0.

Wersja 1.2.0

  • Obsługuje adapter Facebooka na Androida w wersji 4.99.1.1.
  • Obsługuje adapter Facebooka na iOS w wersji 4.99.2.0.

Wersja 1.1.3

  • Obsługuje adapter Facebooka na Androida w wersji 4.28.2.1.
  • Obsługuje adapter Facebooka na iOS w wersji 4.28.1.2.

Wersja 1.1.2

  • Rozwiązaliśmy potencjalny konflikt z wtyczką zapośredniczenia Unity Ads Unity.

Wersja 1.1.1

  • Obsługuje adapter Facebooka na Androida w wersji 4.28.2.0.
  • Obsługuje adapter Facebooka na iOS w wersji 4.28.1.1.

Wersja 1.1.0

  • Obsługuje pakiet SDK Facebooka na Androida w wersji 4.28.1.
  • Obsługuje pakiet SDK Facebook na iOS w wersji 4.28.1.

Wersja 1.0.0

  • Pierwsza wersja!
  • Obsługuje pakiet SDK Facebooka na Androida w wersji 4.27.0.
  • Obsługuje pakiet SDK Facebook iOS w wersji 4.27.1.