Integracja AppLovin z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z AppLovin za pomocą mediacji, obejmując zarówno licytowanie, jak i integrację kaskadową. Przewodnik zawiera informacje o dodawaniu AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz o integrowaniu pakietu AppLovin SDK i adaptera z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla AppLovin umożliwia:

¹ Banery reklamowe (z wyjątkiem banerów MREC) są obsługiwane tylko w ramach zapośredniczenia. Ustalanie stawek nie obsługuje żadnego typu banerów reklamowych.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Aby wdrożyć na Androidzie:
  • poziom interfejsu API 21 lub nowszy,
• Aby wdrożyć aplikację na iOS:
  • docelowa wersja iOS 12.0 lub nowsza
• działający projekt Flutter skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
• Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj ustawienia w interfejsie AppLovin

Zarejestruj się lub zaloguj się na konto AppLovin.

Aby skonfigurować jednostkę reklamową AdMob, musisz mieć klucz SDK i klucz raportowania AppLovin. Aby je znaleźć, otwórz UI AppLovin > Konto > Klucze, aby wyświetlić obie wartości.

Jeśli zamierzasz tylko zintegrować ustalanie stawek, możesz przejść do konfigurowania ustawień pośrednictwa.

Wybieranie aplikacji do zapośredniczenia

Utwórz strefę

Włączanie trybu testowego

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

Krok 2. Skonfiguruj reklamy na żądanie AppLovin w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Dodawanie AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Applovin Corp. do listy partnerów reklamowych w ustawieniach RODO i przepisów stanowych w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter AppLovin

Integracja przez pub.dev

Dodaj w pliku pubspec.yaml pakietu następującą zależność z najnowszymi wersjami pakietu SDK i adaptera Applovin:

dependencies:
  gma_mediation_applovin: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki mediacji reklam mobilnych Google dla Applovin, wyodrębnij pobrany plik i dodaj wyodrębniony folder wtyczki (oraz jego zawartość) do projektu Flutter. Następnie odwołuj się do wtyczki w pliku pubspec.yaml, dodając tę zależność:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK AppLovin

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Jeśli nie używasz platformy CMP, która zapisuje ciąg znaków zgody w wspólnych preferencjach, możesz użyć metod GmaMediationApplovin.setHasUserConsent() i GmaMediationApplovin.setIsAgeRestrictedUser(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu AppLovin SDK. Te opcje muszą zostać ustawione przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK AppLovin.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

Wtyczka reklam mobilnych Google do zapośredniczenia w AppLovin: GmaMediationApplovin.setDoNotSell() metoda. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje muszą być ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK AppLovin.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

Więcej informacji znajdziesz w dokumentacji AppLovin's Privacy Documentation.

Krok 5. Dodaj wymagany kod

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie 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 (z ustalaniem stawek) i Applovin (kaskada).

Kroki opcjonalne:

Parametry związane z siecią

Adapter AppLovin umożliwia przekazanie do żądania reklamy obiektu AppLovinMediationExtras, aby ustawić parametry specyficzne dla sieci. Poniższy przykładowy kod pokazuje, jak wyłączyć dźwięk w reklamach wideo za pomocą parametru isMuted:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Optymalizacje

Dodanie wywołania funkcji GmaMediationApplovin.initializeSdk('sdkKey') do aktywności uruchamiającej zapewnia AppLovin możliwość śledzenia zdarzeń od razu po uruchomieniu aplikacji.

Kody błędów

Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, korzystając z interfejsu ResponseInfo w tych klasach:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Oto kody i odpowiednie komunikaty z adaptera AppLovin, które pojawiają się, gdy nie udaje się załadować reklamy:

Historia zmian w adapterze zapośredniczenia Fluttera AppLovin

Następna wersja

• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

1.2.0

• Wersja 12.6.1.0 adaptera AppLovin dla Androida została sprawdzona pod kątem zgodności.
• Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.6.1.0.
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.1.0

• Interfejs API usługi GmaMediationApplovin nie jest już statyczny.
• Weryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.4.3.0.
• Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.4.2.0.
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

1.0.0

• Pierwsza wersja.
• Wersja 12.3.0.0 adaptera AppLovin dla Androida przeszła testy zgodności
• Weryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.2.1.0
• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.0.0.