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, co obejmuje zarówno integrację określania stawek, jak i integracji kaskady. Opisano w nim, jak dodać AppLovin do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter AppLovin z aplikacją Flutter .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla AppLovin ma te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner	^1
Pełnoekranowa
Otrzymano

¹ Banery reklamowe (z wyjątkiem banerów MREC) są obsługiwane tylko w zapośredniczeniu. 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 przeprowadzić wdrożenie na Androidzie:
  • Interfejs API Androida na poziomie 21 lub wyższym
• Aby wdrożyć w iOS:
  • Wartość docelowa 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 artykule Pierwsze kroki.
• Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie 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

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Aby przejść do zarejestrowanych aplikacji, w interfejsie AppLovin wybierz Applications (Aplikacje) w sekcji Zarabianie. Z listy dostępnych aplikacji wybierz tę, w której chcesz zastosować zapośredniczenie.

Tworzenie strefy

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

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

Wpisz nazwę w polu Identyfikator strefy, w polu Platforma wybierz Android, a następnie wybierz Typ reklamy.

Skonfiguruj Ceny dla strefy, wybierając Stały CPM lub Zoptymalizowane przez AppLovin. W przypadku opcji Płaski CPM stawki CPM można konfigurować osobno dla poszczególnych krajów. Następnie kliknij Zapisz.

Android

iOS

Po utworzeniu strefy identyfikator strefy znajdziesz w kolumnie Identyfikator strefy.

Android

iOS

Uwaga: zdecydowanie zalecamy utworzenie strefy AppLovin dla poszczególnych AdMob jednostek reklamowych, aby AdMob skuteczniej optymalizować źródła reklam w zapośredniczeniu

.

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 oferty reklamowe AppLovin w AdMob interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Android

Instrukcje znajdziesz w kroku 2 instrukcji na Androida.

iOS

Instrukcje znajdziesz w kroku 2 przewodnika po iOS.

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

Ważne: sprawdź, czy masz uprawnienia Zarządzanie kontem, aby dokończyć konfigurowanie opcji uzyskiwania zgody użytkowników z UE, RODO, ustawy CPRA i platformy do przesyłania wiadomości użytkownikom. Więcej informacji znajdziesz w artykule Zarządzanie dostępem użytkowników do konta.

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 i adapter AppLovin

Uwaga: jeśli nie zintegrujesz zgodnej wersji pakietu AppLovin i pakietu SDK do reklam mobilnych Google, mogą wystąpić problemy z kompilacją.

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. Zaimplementuj ustawienia prywatności w pakiecie SDK AppLovin

Zgoda użytkowników z UE a RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.

AppLovin umożliwia odczyt ciągu tekstowego dotyczącego zgody użytkownika ze wspólnych preferencji i odpowiednie ustawianie stanu zgody.

Jeślinie używasz platformy do zarządzania zgodą użytkowników, która zapisuje ciąg znaków dotyczący zgody użytkownika w udostępnianych preferencjach, możesz użyć metod GmaMediationApplovin.setHasUserConsent() oraz GmaMediationApplovin.setIsAgeRestrictedUser() . Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK AppLovin. Te opcje musisz skonfigurować przed zainicjowaniem pakietu SDK do reklam mobilnych Google, aby mieć pewność, że zostaną 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 AppLovin.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

Wtyczka zapośredniczenia 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 upewnić się, że zostaną prawidłowo przekazane 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 w AppLovin.

Krok 5. Dodaj wymagany kod

Android

Integracja z AppLovin nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Wykonaj 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 AdMob i włącz tryb testowy w AppLovin interfejsie użytkownika.

Ważne: przed opublikowaniem aplikacji wyłącz tryb testowy AdMob iAppLovin .

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 specyficzne dla sieci

Adapter AppLovin pozwala na 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 aktywności związanej z wprowadzaniem aplikacji na rynek 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 żądanie reklamy, korzystając z ResponseInfo w tych klasach:

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

Kod błędu	Przyczyna
Od –1009 do –1, 204	Pakiet SDK do AppLovin zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji AppLovin.
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
103	Kontekst jest pusty.
104	Token stawki AppLovin jest pusty.
105	Zażądano wielu reklam dla tej samej strefy. AppLovin może wczytać tylko 1 reklamę w danej strefie.
106	Reklama nie jest gotowa do wyświetlania.
108	Adapter AppLovin nie obsługuje żądanego formatu reklamy.

iOS

Kod błędu	Przyczyna
Od –1009 do –1, 204	Pakiet SDK do AppLovin zwrócił komunikat o błędzie. Więcej informacji znajdziesz w dokumentacji AppLovin.
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez AppLovin.
102	Brakuje parametrów serwera AppLovin skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe.
103	Nie udało się wyświetlić reklamy AppLovin.
104	Zażądano wielu reklam dla tej samej strefy. AppLovin może wczytać tylko 1 reklamę w danej strefie.
105	Nie znaleziono klucza pakietu SDK AppLovin.
107	Token stawki jest pusty.
108	Adapter AppLovin nie obsługuje żądanego formatu reklamy.
110	Aplikacja AppLovin wysłała wywołanie zwrotne wczytywania, ale nie wczytała żadnych reklam.

Historia zmian adaptera zapośredniczenia Flutter w AppLovin

1.1.0

• Interfejs API GmaMediationApplovin nie jest już statyczny.
• Zweryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.4.3.0.
• Zweryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.4.2.0.
• Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.1.0.

1.0.0

• Pierwsza wersja.
• Zweryfikowana zgodność z adapterem AppLovin na Androida w wersji 12.3.0.0
• Zweryfikowana zgodność z adapterem AppLovin na iOS w wersji 12.2.1.0
• Stworzona i przetestowana z wtyczką Google Mobile Ads Flutter w wersji 5.0.0.