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 integrację z licytacją i metodą kaskadową. Wyjaśniamy, jak dodać Liftoff Monetize do oraz jak zintegrować Vungle SDK i adapter z Flutter

Obsługiwane integracje i formaty reklam

Integracja
Określanie stawek
Wodospad
Formaty
Otwarcie aplikacji 1 3
Baner 2
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą 2

1 Integracja z ustalaniem stawek w tym formacie jest dostępna w ramach zamkniętych testów beta.

2 Określanie stawek dla tego formatu jest w otwartej wersji beta.

3 Kaskada jest dostępna w zamkniętych testach beta.

Wymagania

  • Najnowsza wersja pakietu 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 za pomocą: pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w artykule Pierwsze kroki.
  • Dokończ zapośredniczenie Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie Liftoff Monetize

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

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Liftoff do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK Vungle i adapter Liftoff Monetize

Integracja przez pub.dev

Dodaj tę zależność z najnowszymi wersjami 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 zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize rozpakuj pobrany plik i dodaj wyodrębniony folder wtyczki (i jego zawartość) do projektu Flutter. Następnie odnoś się do tej wtyczki w swoim 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 uzyskane od 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). 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. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.

Wtyczka zapośredniczenia do reklam mobilnych Google dla Liftoff Monetize zawiera Metoda 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");

Zapoznaj się z instrukcjami implementacji zalecanej przez RODO w przypadku: Android oraz iOS, aby dowiedzieć się więcej oraz wartości, które można podać w metodzie.

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 według wskazówek każdej z tych sieci, zgodność z przepisami.

Wtyczka zapośredniczenia reklam mobilnych Google dla usługi Liftoff Monetize zawiera metodę 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);

Zapoznaj się z instrukcjami implementacji zalecanej przez ustawę CCPA: Androida 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 (określanie 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
Z nagrodą (wodospad) 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 (określanie stawek) GADMediationAdapterVungle
Reklama przy otwarciu 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
Z nagrodą (wodospad) GADMAdapterVungleRewardBasedVideoAd
Reklama pełnoekranowa z nagrodą (określanie stawek) GADMediationAdapterVungle
Reklama pełnoekranowa z nagrodą (wodospad) GADMediationAdapterVungle

Oto kody i odpowiednie komunikaty z adaptera do zarabiania Liftoff, które są wyświetlane, gdy nie udaje się załadować reklamy:

Android

Kod błędu Przyczyna
101 Nieprawidłowe parametry serwera (np. identyfikator aplikacji lub miejsca docelowego).
102 Żądaną wielkość banera nie można mapować na prawidłowy rozmiar reklamy w usłudze Liftoff Monetize.
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ć pakietu SDK Vungle.
106 Vungle SDK zwróciło udane wywołanie zwrotne wczytywania, ale Banners.getBanner() lub Vungle.getNativeAd() zwróciło wartość null.
107 Pakiet Vungle SDK 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żna wczytać drugiej reklamy z tym samym identyfikatorem miejsca docelowego.
103 Żądany rozmiar reklamy nie pasuje do obsługiwanego narzędzia Liftoff Monetize rozmiar banera.
104 Pakiet Vungle SDK nie mógł wyrenderować banera reklamowego.
105 Pakiet SDK Vungle obsługuje tylko wczytywanie 1 banera naraz, niezależnie od identyfikatora miejsca docelowego.
106 Pakiet SDK Vungle wysłał wywołanie zwrotne z informacją, że nie można odtworzyć reklamy.
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.0.0

  • Pierwsza wersja.
  • Zweryfikowano zgodność z adapterem Liftoff Monetize na Androida w wersji 7.3.1.0
  • Zweryfikowano zgodność z adapterem LiftoffMonetize na iOS w wersji 7.3.2.0
  • Utworzono i przetestowano z użyciem wtyczki Google Mobile Ads Flutter w wersji 5.1.0.