Integracja AppLovin z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z AppLovin za pomocą zapośredniczenia, które obejmuje zarówno integrację określania stawek, jak i kaskady. Dowiesz się z niego, jak dodać AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK AppLovin i adapter z Flutter aplikacją.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob do AppLovin udostępnia te funkcje:

¹ Banery reklamowe (oprócz banerów MREC) są obsługiwane tylko w ramach zapośredniczenia. Określanie stawek nie obsługuje żadnych rodzajów banerów reklamowych.

Wymagania

• Najnowszy pakiet SDK do reklam mobilnych Google
• Flutter w wersji 3.7.0 lub nowszej
• Aby wdrożyć to na Androidzie:
  • Interfejs API Androida na poziomie 21 lub wyższym
• Aby wdrożyć w iOS:
  • Cel wdrożenia iOS w wersji 12.0 lub nowszej
• Działający Flutter projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
• Wykonaj 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 za pomocą pub.dev

Dodaj tę zależność do najnowszych wersji pakietuAppLovin SDK i adaptera w pliku pubspec.yaml pakietu:

dependencies:
  gma_mediation_applovin: ^1.0.0

Integracja ręczna

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

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

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Jeśli nie używasz platformy CMP, która zapisuje ciąg znaków dotyczący zgody użytkownika we wspólnych preferencjach, możesz użyć metod GmaMediationApplovin.setHasUserConsent() i GmaMediationApplovin.setIsAgeRestrictedUser() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkowników do pakietu SDK AppLovin. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane 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 w AppLovin.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. Przewodnik dotyczący zgodności z amerykańskimi przepisami stanowymi o ochronie 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 łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Wtyczka zapośredniczenia do reklam mobilnych Google dla AppLovin zawiera metodę GmaMediationApplovin.setDoNotSell() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje należy ustawić przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby zostały prawidłowo przekierowane do pakietu SDK AppLovin.

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

GmaMediationApplovin.setDoNotSell(true);

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

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 przekazywanie do żądania reklamy obiektu AppLovinMediationExtras w celu ustawienia parametrów związanych z siecią. Ten 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 do GmaMediationApplovin.initializeSdk('sdkKey') do działania dotyczącego uruchomienia umożliwia AppLovin śledzenie zdarzeń natychmiast po uruchomieniu aplikacji.

Kody błędów

Jeśli adapter nie otrzyma reklamy z AppLovin, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na reklamę, używając parametru ResponseInfo z tych klas:

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter AppLovin, gdy reklama się nie wczytuje:

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.