Ta strona została przetłumaczona przez Cloud Translation API.

Integracja AppLovin z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z AppLovin korzystające z zapośredniczenie, w obrębie kaskady i integracji określania stawek. Wyjaśniamy, jak dodać do AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK AppLovin. i adapter do aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia na potrzeby AppLovin udostępnia te funkcje:

Integracja
Określanie stawek
Wodospad
Formaty
Baner	¹.
Pełnoekranowa
Z nagrodą
Natywna

¹ Banery reklamowe (z wyłączeniem MREC) banerów) są obsługiwane tylko w ramach zapośredniczenia. Określanie stawek nie obsługuje żadnych typów banery reklamowe.

Wymagania

Cel wdrożenia iOS w wersji 12.0 lub nowszej
[Do określania stawek]: adapter AppLovin w wersji 6.3.0.0 lub nowszej (zalecana najnowsza wersja)

Najnowszy pakiet SDK do reklam mobilnych Google
Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika AppLovin

Zarejestruj się lub zaloguj z kontem AppLovin.

Aby skonfigurować jednostkę reklamową AdMob, musisz mieć Klucz pakietu SDK i klucz raportu AppLovin. Aby je znaleźć, wejdź na Interfejs AppLovin > Konto > Klucze, aby zobaczyć obie te wartości.

Jeśli planujesz tylko zintegrować określanie stawek, przejdź do skonfigurować ustawienia zapośredniczenia.

Wybierz aplikację do zapośredniczenia

Określanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

W interfejsie AppLovin wybierz Applications (Aplikacje) w sekcji Zarabianie, aby przejść do zarejestrowanych aplikacji. Wybierz aplikację których chcesz używać z zapośredniczeniem, z listy dostępnych aplikacji.

Utwórz strefę

Określanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

W interfejsie AppLovin w sekcji Zarabianie wybierz Strefy. , aby przejść do zarejestrowanych identyfikatorów stref. Jeśli utworzyłeś już wymagane strefy dla aplikacji, przejdź od razu do kroku 2. Aby utworzyć nowy identyfikator strefy, kliknij Utwórz strefę.

Wpisz nazwę Zone ID (Identyfikator strefy), a jako Platformę wybierz Android. wybierz Typ reklamy.

Skonfiguruj Ceny dla strefy, wybierając Stały CPM lub Zoptymalizowane przez AppLovin. Stawki CPM można konfigurować dla poszczególnych krajów: opcję Stały CPM. Następnie kliknij Zapisz.

Android

iOS

Po utworzeniu strefy jej identyfikator znajdziesz w sekcji Identyfikator strefy. .

Android

iOS

Włącz tryb testowy

Postępuj zgodnie z instrukcjami w AppLovin Tryb testowy (MAX) .

Krok 2. Skonfiguruj żądania w AppLovin w interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Android.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

Dodaj AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Krok 3. Zaimportuj pakiet SDK AppLovin i adapter

Używanie CocoaPods (zalecane)

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

Integracja ręczna

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

Krok 4. Wdroż ustawienia prywatności w pakiecie SDK AppLovin

Zgoda użytkowników z UE i RODO

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

Od wersji SDK 12.0.0 AppLovin obsługuje odczytywanie ciągu tekstowego dotyczącego zgody z UserDefaults i odpowiednio ustawiając stan zgody.

Jeśli nie używasz pakietu SDK AppLovin w wersji 12.0.0 lub nowszej albo nie używasz platformy CMP, która zapisuje ciągu znaków dotyczącego zgody użytkownika w parametrze UserDefaults , możesz używać następujących adresów: setHasUserContent i setIsAgeRestrictedUser metod. Poniższy przykładowy kod pokazuje, jak to zrobić informacji o zgodzie użytkowników pakietu SDK AppLovin. Te opcje należy skonfigurować przed zainicjować pakiet SDK do reklam mobilnych Google , aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

Ponadto, jeśli wiesz, że użytkownik jest objęty ograniczeniem wiekowym, możesz: ustaw tę flagę na YES.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setIsAgeRestrictedUser(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setIsAgeRestrictedUser:YES];

Zobacz ustawienia prywatności w AppLovin .

Amerykańskie przepisy stanowe o ochronie prywatności

Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.

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

Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do funkcji SDK AppLovin. Te opcje należy skonfigurować przed zainicjować pakiet SDK do reklam mobilnych Google , aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

Zobacz dokumentację dotyczącą ochrony prywatności w AppLovin .

Krok 5. Dodaj wymagany kod

Integracja SKAdNetwork

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

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby i włącz tryb testowy w AppLovin interfejsie użytkownika.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyAppLovin, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z AppLovin (Bidding) and AppLovin (Waterfall) źródeł reklam.

Kroki opcjonalne:

Parametry charakterystyczne dla sieci

Adapter AppLovin obsługuje protokół muteAudio, który jest opcjonalnym dodatkiem do wyłączenia dźwięku reklam wideo. Ten parametr można przekazać do adaptera za pomocą GADMAdapterAppLovinExtras i należy ją ustawić w przypadku każdego żądania reklamy. Aby go ustawić:

Swift

let request = ()
let extras = GADMAdapterAppLovinExtras()
extras.muteAudio = false
request.register(extras)

Objective-C

 *request = [ request];
GADMAdapterAppLovinExtras * extras = [[GADMAdapterAppLovinExtras alloc] init];
extras.muteAudio = NO;
[request registerAdNetworkExtras:extras];

Optymalizacje

Inicjowanie pakietu SDK AppLovin zaraz po premierze aplikacji zapewnia AppLovin umożliwia śledzenie zdarzeń natychmiast po uruchomieniu aplikacji.

Swift

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Objective-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

Kody błędów

Jeśli adapter nie odbierze reklamy z AppLovin, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia GADResponseInfo.adNetworkInfoArray. w następujących klasach:

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter AppLovin gdy nie można wczytać reklamy:

Kod błędu	Przyczyna
Od –1009 do -1, 204	Pakiet SDK AppLovin wystąpił błąd. Zobacz Dokumentacja AppLovin .
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
102	Brak parametrów serwera AppLovin skonfigurowanych w interfejsie lub są one nieprawidłowe.
103	Nie udało się wyświetlić reklamy AppLovin.
104	Zażądano kilku reklam dla tej samej strefy. AppLovin może wczytywać tylko 1 reklamę naraz na strefę.
105	Nie znaleziono klucza pakietu SDK AppLovin.
107	Token stawki jest pusty.
108	Adapter AppLovin nie obsługuje żądanego formatu reklamy.
110	AppLovin wysłała pomyślne wywołanie zwrotne wczytywania, ale nie wczytała żadnych reklam.