Integracja Liftoff Zarabiaj z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Liftoff Monetize za pomocą mediacji. Obejmuje on zarówno licytowanie, jak i integrację kaskadową. Przewodnik zawiera informacje o dodawaniu pakietu Liftoff Monetize do konfiguracji pośrednictwa jednostki reklamowej oraz o integrowaniu pakietu SDK i adaptera Vungle z aplikacjąFlutter .

Obsługiwane integracje i formaty reklam

Integracja
Określanie stawek
Wodospad
Formaty
Otwarcie aplikacji 1, 2
Baner 1
Pełnoekranowa
Z nagrodą
Pełnoekranowa z nagrodą 1
Natywna 1, 2

1 Ustalanie stawek dla tego formatu jest w otwartej wersji beta.

2 Integracja formatu kaskadowego jest w otwartej fazie beta.

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
    • docelowa wersja iOS 12.0 lub nowsza,
  • Działający Flutter projekt 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 konfiguracje w interfejsie Liftoff Monetize

Zarejestruj się lub zaloguj w Liftoff Zarabianie na koncie.

Dodaj aplikację do panelu Liftoff Monetize, klikając przycisk Dodaj aplikację.

Wypełnij formularz, wpisując wszystkie niezbędne informacje.

Android

iOS

Po utworzeniu aplikacji wybierz ją na panelu aplikacji Liftoff Monetize.

Android

iOS

Zanotuj identyfikator aplikacji.

Android

iOS

Dodaj nowe miejsca docelowe

Aby utworzyć nowe miejsce docelowe do wykorzystania w AdMob zapośredniczenia, przejdź do Panel Liftoff Monetize Placements, kliknij przycisk Dodaj miejsce docelowe i wybierz aplikację z listy. z listy.

Szczegółowe informacje na temat dodawania nowych miejsc docelowych znajdziesz poniżej:

Otwarcie aplikacji

Wybierz Interstitial i wpisz Nazwa miejsca docelowego. Następnie kliknij Tak. w polu Możliwe do pominięcia i wypełnij pozostałą część formularza. [Dotyczy tylko ustalania stawek] W sekcji Generowanie przychodu ustaw przełącznik Ustalanie stawek w aplikacji w pozycji Włączono. Kliknij przycisk Dalej na dole strony, by utworzyć miejsce docelowe.

Wybierz Baner, wpisz Nazwa miejsca docelowego i wypełnij pozostałą część formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Kliknij przycisk Dalej na dole stronę tworzenia miejsca docelowego.

Baner 300 x 250

Wybierz MREC, wpisz Nazwa miejsca docelowego i wypełnij pozostałą część formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Kliknij przycisk Dalej na dole stronę tworzenia miejsca docelowego.

Pełnoekranowa

Wybierz Reklama pełnoekranowa, wpisz Nazwa miejsca docelowego i uzupełnij pozostałą część formularza. [Tylko określanie stawek] W sekcji Zarabianie Zmień ustawienie Określanie stawek w aplikacji na Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Z nagrodą

Kliknij Reklama z nagrodą, wpisz Nazwę miejsca docelowego i wypełnij pozostałe pola. formularza. [Tylko określanie stawek] W sekcji Zarabianie włącz Określanie stawek w aplikacji. przełącz na Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Reklama pełnoekranowa z nagrodą

Wybierz Z nagrodą. Wpisz nazwę miejsca docelowego, zaznacz opcję Możliwość pominięcia i wypełnij pozostałe pola formularza. [Tylko określanie stawek] W sekcji Zarabianie przesuń przełącznik zmień ustawienie Określanie stawek w aplikacji na Włączone. Aby utworzyć miejsce docelowe, kliknij przycisk Dalej na dole strony.

Natywna

Wybierz Natywna, wpisz Nazwa miejsca docelowego i uzupełnij pozostałą część formularza. [Dotyczy tylko określania stawek] W sekcji Generowanie przychodu ustaw przełącznik Określanie stawek w aplikacji w pozycji Włączone. Kliknij przycisk Dalej na dole stronę tworzenia miejsca docelowego.

Zanotuj identyfikator referencyjny i kliknij Sounds Good.

Otwarcie aplikacji

Baner 300 x 250

Pełnoekranowa

Z nagrodą

Reklama pełnoekranowa z nagrodą

Natywna

Znajdowanie klucza interfejsu API raportowania

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji określania stawek.

Wodospad

Oprócz identyfikatora aplikacji i identyfikatora referencyjnego będą też potrzebne klucz interfejsu API do raportowania Liftoff Monetize, aby umożliwić Identyfikator jednostki reklamowej AdMob. Przejdź do panel raportów Liftoff Monetize oraz kliknij przycisk Reporting API Key, aby wyświetlić interfejs API do raportowania. Klucz.

Włącz tryb testowy

Aby włączyć reklamy testowe, otwórz panel Liftoff Monetize i przejdź do Aplikacje.

W sekcji Identyfikator referencyjny miejsca docelowego wybierz aplikację, w której chcesz włączyć reklamy testowe. W sekcji Stan wybierz Tryb testowy, aby wyświetlać tylko reklamy testowe.

Android

iOS

Krok 2. Skonfiguruj źródła ofert reklamowych i zarabiaj na nich w AdMob interfejsie

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.

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

Krok 3. Zaimportuj SDK Vungle i adapter Liftoff Monetize

Integracja przez pub.dev

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

Integracja ręczna

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Liftoff Monetize

Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania 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). 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. Obecnie Google nie może automatycznie przekazywać sieciom takich informacji.

Wtyczka zapośredniczenia reklam mobilnych Google dla usługi Liftoff Monetize zawiera metodę GmaMediationLiftoffmonetize.setGDPRStatus(). Poniżej znajduje się przykładowy kod. pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli wybierzesz zalecamy wywołanie tej metody przed wysłaniem żądania reklam pakiet SDK do reklam mobilnych Google.

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

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

Więcej informacji na temat implementacji zalecanej przez RODO znajdziesz w AndroidzieiOS. Znajdziesz tam też wartości, które można podać w ramach tej metody.

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. 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 zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize zawiera Metoda GmaMediationLiftoffmonetize.setCCPAStatus(). Poniżej znajduje się przykładowy kod. pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli wybierzesz zalecamy wywołanie tej metody przed wysłaniem żądania reklam pakiet SDK do reklam mobilnych Google.

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

Zobacz instrukcje implementacji zalecanej przez ustawę CCPA: Android oraz iOS, aby dowiedzieć się więcej wartości, które można podać w metodzie.

Krok 5. Dodaj wymagany kod

Android

Integracja z Liftoff Monetize nie wymaga dodatkowego kodu.

iOS

Integracja SKAdNetwork

Obserwuj kanał Liftoff Monetize dokumentacja 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 Liftoff Monetize interfejsie użytkownika.

Weryfikacja reklam testowych

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

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdź przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo w ramach tych zajęć:

Android

Format Nazwa zajęć
Otwarcie aplikacji (ustalanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Otwarcie aplikacji (wodospad) com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Baner (wodospad) com.vungle.mediation.VungleInterstitialAdapter
Reklama pełnoekranowa (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa (wodospad) com.vungle.mediation.VungleInterstitialAdapter
Reklamy z nagrodą (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama z nagrodą (kaskadowa) com.vungle.mediation.VungleAdapter
Reklama pełnoekranowa z nagrodą (określanie stawek) com.google.ads.mediation.vungle.VungleMediationAdapter
Reklama pełnoekranowa z nagrodą (wodospad) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

Format Nazwa zajęć
Otwarcie aplikacji (ustalanie stawek) GADMediationAdapterVungle
Otwarcie aplikacji (kaskada) GADMediationAdapterVungle
Baner (określanie stawek) GADMediationAdapterVungle
Baner (wodospad) GADMAdapterVungleInterstitial
Reklama pełnoekranowa (określanie stawek) GADMediationAdapterVungle
Reklama pełnoekranowa (wodospad) GADMAdapterVungleInterstitial
Reklamy z nagrodą (określanie stawek) GADMediationAdapterVungle
Reklama z nagrodą (kaskadowa) GADMAdapterVungleRewardBasedVideoAd
Reklama pełnoekranowa z nagrodą (określanie stawek) GADMediationAdapterVungle
Reklama pełnoekranowa z nagrodą (kaskada) GADMediationAdapterVungle

Oto kody i powiązane z nimi wiadomości wysyłane przez Liftoff Monetize adaptera, gdy reklama nie wczytuje się:

Android

Kod błędu Przyczyna
101 nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego);
102 Żądany rozmiar banera nie jest zmapowany na prawidłową reklamę Liftoff Monetize rozmiaru.
103 Liftoff Monetize wymaga przesyłania żądań z kontekstem Activity reklam.
104 Pakiet SDK Vungle nie może wczytać wielu reklam w tym samym miejscu docelowym ID.
105 Nie udało się zainicjować Vungle SDK.
106 Pakiet SDK Vungle zwrócił wywołanie zwrotne pomyślnego wczytania, ale funkcja Banners.getBanner() lub Vungle.getNativeAd() zwróciła wartość null.
107 Pakiet SDK Vungle nie jest gotowy do wyświetlenia reklamy.
108 Pakiet SDK Vungle zwrócił nieprawidłowy token ustalania stawek.

iOS

Kod błędu Przyczyna
101 nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego);
102 Reklama została już wczytana na potrzeby tej konfiguracji sieci. Pakiet SDK Vungle nie może wczytać drugiej reklamy dla tego samego identyfikatora miejsca docelowego.
103 Żądany rozmiar reklamy nie pasuje do obsługiwanego rozmiaru banera w Liftoff Monetize.
104 Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego.
105 Vungle SDK obsługuje jednoczesne wczytywanie tylko jednego banera reklamowego, niezależnie od tego identyfikator miejsca docelowego.
106 Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że reklama nie może być odtworzona.
107 Pakiet Vungle SDK nie jest gotowy do wyświetlenia reklamy.

W przypadku błędów pochodzących z pakietu Vungle SDK zapoznaj się z artykułem Kody błędów: Vungle SDK na iOS i Androida.

Liftoff Zarabiaj – Adapter zapośredniczenia Flutter

Wersja 1.1.0

  • Weryfikowana zgodność z adapterem Androida Liftoff Monetize w wersji 7.4.0.1
  • Weryfikowana zgodność z adapterem iOS LiftoffMonetize w wersji 7.4.0.1
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.

Wersja 1.0.0

  • Pierwsza wersja.
  • Weryfikowana zgodność z adapterem Androida Liftoff Monetize w wersji 7.3.1.0
  • Weryfikowana zgodność z adapterem iOS LiftoffMonetize w wersji 7.3.2.0
  • Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.1.0.