Integracja Meta Audience Network z określaniem stawek

Wybierz platformę: Android (beta) Android iOS Unity Flutter

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z Meta Audience Network przy użyciu mediacji, w tym integracji określania stawek. Wyjaśniamy w nim, jak dodać Meta Audience Network do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Meta Audience Network z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

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

¹ Meta Audience Network stała się w 2021 r. siecią tylko z licytowaniem.
^2. Sieć Meta Audience Network nie obsługuje zakotwiczonych i śródtekstowych banerów adaptacyjnych.

Wymagania

• Najnowsze GMA Next-Gen SDK.

• Zapoznaj się z przewodnikiem dla początkujących dotyczącym mediacji.

• Android w wersji 24 lub nowszej

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

Krok 1. Skonfiguruj ustawienia w interfejsie sieci odbiorców 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.

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 następnie kliknij Dalej.

Wybierz Google Ad Manager jako Platformę do zapośredniczenia, a potem 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 znacznej 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 reklamowej Meta znajdziesz w przewodniku po testowaniu implementacji sieci reklamowej.

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

Zaloguj się na konto Ad Managera.

Włączanie udostępniania bezpiecznych sygnałów

Otwórz Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, a następnie sprawdź i włącz opcję Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Facebooka i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek Meta

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz Meta.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Konfigurowanie mapowania jednostki reklamowej

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę w Meta Audience Network.

Otwórz kartę Mapowanie jednostki reklamowej i kliknij Nowe mapowanie jednostki reklamowej.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz identyfikator miejsca docelowego uzyskany w poprzedniej sekcji.

Jeśli konfigurujesz mapowanie jednostek reklamowych na potrzeby reklamy pełnoekranowej z nagrodą w interfejsie Ad Managera, wybierz format Z nagrodą i użyj identyfikatora miejsca docelowego reklamy pełnoekranowej z nagrodą.

Na koniec kliknij Zapisz.

Dodawanie Meta do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi dotyczącymi prywatności

Aby dodać Meta do listy partnerów reklamowych zachowujących zgodność z 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 z Androidem Studio (zalecana)

W pliku Gradle na poziomie aplikacji dodaj te zależności implementacji i konfiguracje:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integracja ręczna

• Pobierz najnowszą wersję pakietu SDK Meta Audience Network na Androida. Wyodrębnij AudienceNetwork.aar z folderu AudienceNetwork/bin i dodaj go do projektu.

• Przejdź do artefaktów adaptera Meta Audience Network w repozytorium Maven Google. Wybierz najnowszą wersję, pobierz plik .aar adaptera Meta Audience Network i dodaj go do projektu.

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

Zgoda użytkowników z UE i RODO

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 stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także 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.

Meta nie jest zarejestrowana na globalnej liście dostawców IAB Europe. Zamiast tego musisz użyć specyfikacji technicznej Udzielenie dodatkowej zgody. Więcej informacji znajdziesz w sekcji Składniki specyfikacji „Udzielenie dodatkowej zgody”. Specyfikacja dotycząca udzielania dodatkowej zgody działa w połączeniu z Zasadami IAB Europe dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2. Ta specyfikacja umożliwia Ci wraz z platformami do zarządzania zgodą użytkowników (CMP) i partnerami zbieranie i przesyłanie dodatkowych sygnałów zgody w przypadku firm, które są wymienione na liście dostawców technologii reklamowych Google (ATP), ale nie są jeszcze uwzględnione na globalnej liście dostawców IAB Europe.

Postępuj zgodnie ze wskazówkami w dokumentacji Meta dotyczącymi RODO i reklam w 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 stanów 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 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.

Postępuj zgodnie z instrukcjami w dokumentacji Mety dotyczącymi opcji przetwarzania danych użytkowników z Kalifornii.

Krok 5. Dodaj wymagany kod

Integracja z Meta Audience Network nie wymaga dodatkowego kodu.

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 za pomocą źródła lub źródeł reklam Meta Audience Network (określanie stawek).

Kroki opcjonalne:

Reklamy natywne

Niektóre komponenty reklamy natywnej w sieci Meta Audience Network nie są mapowane 1:1 na komponenty reklamy natywnej w Google. Takie komponenty są przekazywane z powrotem do wydawcy w pakiecie za pomocą metody getExtras() w NativeAd. Adapter obsługuje przekazywanie tych komponentów:

Oto przykładowy kod pokazujący, jak wyodrębnić te komponenty:

Przykład:

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

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Korzystanie z reklam natywnych Meta Audience Network bez obiektu MediaView

Format reklamy natywnej w sieci Meta Audience Network wymaga renderowania komponentuMediaView. Jeśli planujesz renderować reklamy natywne bez tego komponentu, użyj formatu reklamy baner natywny w Meta Audience Network.

Jeśli zamiast tego chcesz używać banerów reklam natywnych z Meta Audience Network, podczas konfigurowania Meta Audience Network musisz wybrać formatNative Banner. Wtedy adapter automatycznie wczyta odpowiedni format reklamy natywnej.

Renderowanie reklam

Adapter Audience Network zwraca reklamy natywne jako obiekty.NativeAd Wypełnia te polaNativeAd.

¹ Adapter sieci Meta Audience Network nie zapewnia bezpośredniego dostępu do głównego komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia pole MediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

W tabeli poniżej znajdziesz informacje o tym, kiedy GMA Next-Gen SDK rejestruje wyświetlenia i kliknięcia reklam natywnych.

Meta Audience Network ma określone wymagania dotyczące renderowania komponentów, aby wyświetlenie było uznawane za prawidłowe. Zależą one od tego, czy podczas konfigurowania Meta Audience Network wybrano format Reklama natywna czy Baner natywny.

Pamięć podręczna w Androidzie 9

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. Postępuj zgodnie z dokumentacją Mety, aby zaktualizować konfigurację zabezpieczeń sieci w aplikacji.

Kody błędów

Jeśli adapter nie otrzyma reklamy z sieci Audience Network, możesz sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z tych klas:ResponseInfo.getAdSourceResponses()

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

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