Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja AppLovin z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać Google Mobile Ads SDK do wczytywania i wyświetlania reklam z AppLovin za pomocą zapośredniczenia AdMob, które obejmuje integracje kaskadowe i z określaniem stawek. Wyjaśniamy w nim, jak dodać AppLovin do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter AppLovin z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter do mediacji w przypadku AppLovin ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji	¹
Baner	²
Pełnoekranowa
Z nagrodą
Natywna

¹ Integracja z systemem Waterfall jest obecnie w fazie zamkniętej wersji beta.

² Kaskadowe wywołanie obsługuje tylko rozmiary banerów 320x50 i 728x90. Ustalanie stawek nie obsługuje reklam banerowych.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

iOS w wersji 13.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera AppLovin w wersji 6.3.0.0 lub nowszej (zalecana jest najnowsza wersja).

Najnowsza wersja Google Mobile Ads SDK.
Konfigurowanie zapośredniczenia AdMob

Krok 1. Skonfiguruj ustawienia w interfejsie AppLovin

Zarejestruj się lub zaloguj na konto AppLovin.

Aby skonfigurować jednostkę reklamową AdMob, musisz mieć klucz pakietu SDK i klucz raportu AppLovin. Aby je znaleźć, otwórz interfejs AppLovin > Konto > Klucze. Zobaczysz tam obie wartości.

Jeśli planujesz jedynie integrację ustalania stawek, możesz przejść do konfigurowania ustawień mediacji.

Wybierz aplikację do mediacji

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

W interfejsie użytkownika AppLovin wybierz Aplikacje w sekcji Monetyzacja, aby uzyskać dostęp do zarejestrowanych aplikacji. Z listy dostępnych aplikacji wybierz tę, której chcesz używać w przypadku mediacji.

Utwórz strefę

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

W interfejsie AppLovin w sekcji Monetyzacja wybierz Strefy, aby wyświetlić zarejestrowane identyfikatory stref. Jeśli masz już utworzone wymagane strefy dla aplikacji, przejdź do kroku 2. Aby utworzyć nowy identyfikator strefy, kliknij Utwórz strefę.

Wprowadź nazwę Identyfikatora strefy, wybierz Android jako Platformę i wybierz Typ reklamy.

Skonfiguruj Cenę dla strefy, wybierając opcję Stała stawka CPM lub Zoptymalizowana przez AppLovin. W przypadku opcji Stały CPM stawki CPM można konfigurować w poszczególnych krajach. Następnie kliknij Zapisz.

Po utworzeniu strefy jej identyfikator znajdziesz w kolumnie Identyfikator strefy.

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 nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby zaimplementować app-ads.txt w przypadku AppLovin, dodaj AppLovin do pliku app-ads.txt.

Włączanie trybu testowego

Aby włączyć reklamy testowe AppLovin, postępuj zgodnie z instrukcjami w przewodniku AppLovin MAX Test Mode (Tryb testowy MAX).

Krok 2. Skonfiguruj popyt AppLovin w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać AppLovin do konfiguracji zapośredniczenia w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij nazwę tej grupy zapośredniczenia, aby ją edytować, i przejdź do sekcji Dodaj AppLovin jako źródło reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodaj AppLovin jako źródło reklam

Określanie stawek

W sekcji Źródła reklam odszukaj kartę Ustalanie stawek i kliknij Dodaj źródło reklam. Następnie kliknij AppLovin.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo w zakresie określania stawek z firmą AppLovin.

Kliknij Potwierdzam i akceptuję, a potem Dalej.

Jeśli masz już mapowanie dla AppLovin, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz klucz pakietu SDK uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

Na karcie Kaskadowe w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz AppLovin i włącz przełącznik Optymalizuj. Wpisz klucz raportu uzyskany w poprzedniej sekcji, aby skonfigurować optymalizację źródeł reklam w przypadku AppLovin. Następnie wpisz wartość eCPM dla AppLovin i kliknij Dalej.

Jeśli masz już mapowanie dla sieci AppLovin, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator pakietu aplikacji wraz z kluczem pakietu SDK i identyfikatorem strefy uzyskanymi w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródeł reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy tylko będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

Dodawanie firmy AppLovin Corp. do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Wykonaj kroki opisane w ustawieniach rozporządzeń europejskich i ustawieniach przepisów stanowych USA, aby dodać AppLovin Corp. do listy partnerów reklamowych podlegających rozporządzeniom europejskim i przepisom stanowym USA w interfejsie użytkownika AdMob.

Krok 3. Zaimportuj pakiet SDK AppLovin i adapter

Używanie menedżera pakietów Swift

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 13.3.1.0.

Aby dodać zależność pakietu do projektu:

W Xcode kliknij File > Add Package Dependencies... (Plik > Dodaj zależności pakietu…).

W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-applovin.git

W sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz main.

Korzystanie z CocoaPods

Dodaj ten wiersz do pliku Podfile projektu:
```
pod 'GoogleMobileAdsMediationAppLovin'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK AppLovin na iOS i połącz ApplovinSDK.framework w projekcie.
Pobierz najnowszą wersję adaptera AppLovin z linku do pobierania w historii zmian i ApplovinAdapter.framework w projekcie.
Dodaj do projektu te platformy:
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

Krok 4: Wdrażanie ustawień prywatności w pakiecie AppLovin SDK

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii 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 zapośredniczenia. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

Od wersji SDK 12.0.0 AppLovin obsługuje odczytywanie ciągu zgody z UserDefaults i odpowiednie ustawianie statusu zgody.

Jeśli nie używasz pakietu SDK AppLovin w wersji 12.0.0 lub nowszej albo platformy CMP, która zapisuje ciąg tekstowy dotyczący zgody w UserDefaults, możesz użyć metody setHasUserConsent. W poniższym przykładzie przekazujemy informacje o zgodzie do pakietu SDK AppLovin. Musisz ustawić te opcje przed zainicjowaniem Google Mobile Ads SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu AppLovin SDK.

Swift

ALPrivacySettings.setHasUserConsent(true)AppLovinMediationSwiftSnippets.swift

Objective-C

[ALPrivacySettings setHasUserConsent:YES];AppLovinMediationObjectiveCSnippets.m

Więcej informacji znajdziesz w ustawieniach prywatności AppLovin.

Zadeklaruj użytkowników dziecięcych

Od wersji 13.0.0 pakietu SDK AppLovin nie obsługuje już flag użytkowników z ograniczeniami wiekowymi. Nie możesz też inicjować ani używać pakietu SDK AppLovin w przypadku „dziecka” w rozumieniu obowiązujących przepisów. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją AppLovin dotyczącą zakazów wykorzystywania danych dzieci lub korzystania z usług lub aplikacji przeznaczonych wyłącznie dla dzieci.

Adapter AppLovin w wersji 13.0.0.1 lub nowszej automatycznie wyłącza zapośredniczanie AppLovin w przypadku aplikacji, które deklarują jedno z tych ustawień za pomocą symbolu Google Mobile Ads SDK:

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące ochrony prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę 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 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.

Pakiet SDK AppLovin zawiera metodę setDoNotSell, która umożliwia wydawcom rezygnację ze sprzedaży danych osobowych.

W tym przykładzie informacje o uzyskanej zgodzie są przekazywane do pakietu AppLovin SDK. Musisz ustawić te opcje przed zainicjowaniem Google Mobile Ads SDK, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu AppLovin SDK.

Swift

ALPrivacySettings.setDoNotSell(true)AppLovinMediationSwiftSnippets.swift

Objective-C

[ALPrivacySettings setDoNotSell:YES];AppLovinMediationObjectiveCSnippets.m

Więcej informacji znajdziesz w dokumentacji dotyczącej prywatności AppLovin.

Krok 5. Dodaj wymagany kod

Wdrażanie SKAdNetwork

Postępuj zgodnie z dokumentacją AppLovin, aby dodać identyfikatory SKAdNetwork do pliku Info.plist swojego projektu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj o zarejestrowaniu urządzenia testowego w usłudze AdMob i włączeniu trybu testowego w interfejsie użytkownika AppLovin.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z AppLovin, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam AppLovin (licytowanie) i AppLovin (wodospad).

Kroki opcjonalne:

Optymalizacje

Zainicjuj pakiet SDK do AppLovin po uruchomieniu aplikacji. Dzięki temu AppLovin może od razu zacząć śledzić zdarzenia”.

Kody błędów

Jeśli adapter nie odbierze reklamy z AppLovin, wydawcy mogą sprawdzić błąd bazowy w odpowiedzi na żądanie reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w następujących klasach:

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Kod błędu	Przyczyna
Od –1009 do –1, 204	Pakiet SDK AppLovin zwrócił błąd. Więcej szczegółów znajdziesz w dokumentacji AppLovin.
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
102	Parametry serwera AppLovin skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
103	Nie udało się wyświetlić reklamy AppLovin.
104	Wysłano prośbę o wiele reklam w tej samej strefie. Sieć AppLovin może wczytywać tylko 1 reklamę naraz w każdej strefie.
105	Klucz SDK AppLovin nie został znaleziony.
107	Token stawki jest pusty.
108	Adapter AppLovin nie obsługuje żądanego formatu reklamy.
110	AppLovin wysłał wywołanie zwrotne wczytania, ale nie wczytał żadnych reklam.
111	Nie można pobrać wystąpienia pakietu AppLovin SDK.
112	Użytkownik jest dzieckiem.
113	Współdzielona instancja AppLovin SDK nie została zainicjowana.
114	Pakiet SDK AppLovin nie zwraca tokena stawki.
115	Brak identyfikatora jednostki reklamowej. Nie udało się wczytać reklamy.
116	Reklama nie jest gotowa. Nie można wyświetlić reklamy.