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

¹ W przypadku tego formatu integracja z określaniem stawek jest dostępna w otwartej wersji beta.

² Integracja formatu kaskadowego jest w otwartej fazie beta.

Wymagania

• Najnowsza wersja pakietu SDK do reklam mobilnych Google
• Flutter 3.7.0 lub nowszy
• [Do ustalania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam z określaniem stawek, użyj wtyczki do zapośredniczenia reklam mobilnych Google w AppLovin w wersji 5.1.0 lub nowszej (zalecana najnowsza wersja).
• Aby wdrożyć na Androidzie:
  • Poziom interfejsu API 21 lub nowszy
• Aby wdrożyć aplikację 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 się na swoje konto Liftoff Monetize.

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

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

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

Zanotuj identyfikator aplikacji.

Dodawanie nowych miejsc docelowych

Aby utworzyć nowe miejsce docelowe do użycia z mediacją AdMob, otwórz panel Monetyzacja miejsc docelowych Liftoff, kliknij przycisk Dodaj miejsce docelowe i wybierz swoją aplikację z menu.

Szczegółowe informacje o dodawaniu nowych miejsc docelowych:

Zanotuj identyfikator referencyjny i kliknij OK.

Znajdowanie klucza interfejsu API raportowania

Włączanie trybu testowego

Aby włączyć reklamy testowe, otwórz panel Liftoff Monetize i kliknij 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.

Krok 2. Skonfiguruj w  AdMob UI usługę Monetyzacja za pomocą Liftoff

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA Liftoff

Aby dodać Liftoff do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK Vungle i adapter Liftoff Monetize

Integracja za pomocą pub.dev

Dodaj te zależności z najnowszymi wersjami pakietu SDK i adaptera Monetize firmy Liftoff w pliku pubspec.yaml pakietu:

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 w pliku pubspec.yaml dodaj odwołanie do wtyczki, dodając tę zależność:

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

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Liftoff Monetize

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie 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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

Wtyczka zapośredniczenia reklam mobilnych Google dla usługi Liftoff Monetize obejmuje metodę GmaMediationLiftoffmonetize.setGDPRStatus(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu 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 Android i iOS, a także wartości, które można podać w ramach tej metody.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). Przewodnik dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej 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 reklam mobilnych Google dla usługi Liftoff Monetize obejmuje metodę GmaMediationLiftoffmonetize.setCCPAStatus(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Vungle. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

Więcej informacji oraz wartości, które można podać w ramach tej metody, znajdziesz w rekomendowanych instrukcjach implementacji CCPA na Android i iOS.

Krok 5. Dodaj wymagany kod

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie Liftoff Monetize.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Liftoff Monetize, włącz testowanie pojedynczego źródła reklam w inspektorze reklam za pomocą źródeł reklam Liftoff Monetize (ustalanie stawek) i Liftoff Monetize (kaskada).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdzić błąd w odpowiedzi reklamy, korzystając z ResponseInfo w ramach tych klas:

Oto kody i odpowiednie komunikaty z adaptera do zarabiania Liftoff, które są wyświetlane, gdy nie udaje się załadować 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.

Historia zmian adaptera zapośredniczenia Fluttera w ramach usługi Liftoff Monetize

Następna wersja

• Skompilowano i przetestowano za pomocą wtyczki reklam mobilnych Google dla Fluttera w wersji 5.2.0.

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.