Integracja AppLovin z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z AppLovin za pomocą zapośredniczenia, obejmujące zarówno integracje określania stawek, jak i kaskady. Wyjaśniamy, jak dodać do AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK AppLovin. i adaptera Flutter do aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do AppLovin zawiera te funkcje:

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

Wymagania

• Najnowszy pakiet SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Do wdrożenia na Androidzie
  • Interfejs API Androida na poziomie 21 lub wyższym
• Do wdrożenia na iOS
  • Cel wdrożenia iOS w wersji 12.0 lub nowszej
• Działający Flutter projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
• Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika AppLovin

Zarejestruj się lub zaloguj na konto AppLovin.

Aby skonfigurować AdMob jednostkę reklamową, potrzebujesz klucza SDK i klucza raportu AppLovin. Aby je znaleźć, otwórz interfejs AppLovin > Konto > Klucze, aby zobaczyć obie wartości.

Jeśli chcesz tylko zintegrować określanie stawek, możesz przejść do konfigurowania ustawień zapośredniczenia.

Wybierz aplikację do zapośredniczenia

Tworzenie strefy

Włącz tryb testowy

Postępuj zgodnie z instrukcjami w przewodniku AppLovin dotyczącym Trybu testowego MAX dotyczącego włączania reklam testowych AppLovin.

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Dodaj AppLovin Corp. 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ć AppLovin Corp. do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK AppLovin i adapter

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami AppLovin Pakiet SDK i adapter w pakiecie Plik pubspec.yaml:

dependencies:
  gma_mediation_applovin: ^1.0.0

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla AppLovin rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki (i jego zawartość) do projektu Flutter. Następnie sprawdź informacje o wtyczce w pubspec.yaml przez dodanie tej zależności:

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

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.

Jeśli jesteś nie korzystasz z platformy CMP, która zapisuje ciąg znaków dotyczący zgody w udostępnianych danych ustawień, możesz użyć GmaMediationApplovin.setHasUserConsent() i GmaMediationApplovin.setIsAgeRestrictedUser() . Poniższy przykładowy kod pokazuje, do przekazywania informacji o zgodzie do pakietu SDK AppLovin. Te opcje muszą być skonfigurowane przed zainicjowaniem pakietu SDK do reklam mobilnych Google. , aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.

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

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

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.

Wtyczka zapośredniczenia do reklam mobilnych Google dla AppLovin obejmuje GmaMediationApplovin.setDoNotSell() . Poniższy przykładowy kod pokazuje, jak to zrobić informacji o zgodzie użytkowników pakietu SDK AppLovin. Te opcje należy skonfigurować przed zainicjuj reklamy mobilne Google pakiet SDK , aby mieć pewność, że zostaną prawidłowo przekazane do pakietu SDK AppLovin.

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

GmaMediationApplovin.setDoNotSell(true);

Zapoznaj się z informacjami na temat prywatności w AppLovin dokumentacja .

Krok 5. Dodaj wymagany kod

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob 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 przesyłanie obiektu AppLovinMediationExtras do żądania reklamy na potrzeby konfiguracji parametrów sieci. Oto przykładowy kod 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

Dodaję połączenie do: GmaMediationApplovin.initializeSdk('sdkKey') w aktywności związanej z premierą produktu, AppLovin umożliwia śledzenie zdarzeń natychmiast po uruchomieniu aplikacji.

Kody błędów

Jeśli adapter nie odbierze reklamy z AppLovin, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo w następujące klasy:

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Historia zmian adaptera zapośredniczenia AppLovin Flutter

1.1.0

• Interfejs API dla GmaMediationApplovin nie jest już statyczny.
• Zweryfikowano zgodność z adapterem AppLovin na Androida w wersji 12.4.3.0.
• Zweryfikowano zgodność z adapterem systemu iOS AppLovin w wersji 12.4.2.0.
• Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.

1.0.0

• Pierwsza wersja.
• Zweryfikowano zgodność z adapterem AppLovin na Androida w wersji 12.3.0.0
• Zweryfikowano zgodność z adapterem systemu iOS AppLovin w wersji 12.2.1.0
• Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.0.0.