Integracja Liftoff Zarabiaj z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads Flutter Plugin do wczytywania i wyświetlania reklam z Liftoff Monetize za pomocą zapośredniczenia, które obejmuje integracje z określaniem stawek i kaskadowe. Znajdziesz tu informacje o tym, jak dodać Liftoff Monetize do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Liftoff Monetize z aplikacją Flutter.

Obsługiwane integracje i formaty reklam

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Najnowsza wersja Google Mobile Ads Flutter Plugin.
• platformy Flutter w wersji 3.7.0 lub nowszej,
• Wdrażanie na Androidzie
  • Android w wersji API 24 lub nowszej.
• Aby wdrożyć na iOS:
  • iOS w wersji 13.0 lub nowszej.
• Działający projekt Flutter skonfigurowany za pomocą Google Mobile Ads Flutter Plugin. Więcej informacji znajdziesz w artykule Konfigurowanie Google Mobile Ads Flutter Plugin.

Krok 1. Skonfiguruj ustawienia w interfejsie Liftoff Monetize

Zarejestruj się lub zaloguj na konto Liftoff Monetize.

Dodaj aplikację do panelu Liftoff Monetize, klikając przycisk Add Application (Dodaj aplikację).

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

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

Zapisz identyfikator aplikacji.

Dodawanie nowych miejsc docelowych

Aby utworzyć nowe miejsce docelowe do użycia w zapośredniczeniu, otwórz panel Miejsca docelowe w Liftoff Monetize, kliknij przycisk Dodaj miejsce docelowe i wybierz aplikację z menu.

Szczegółowe informacje o dodawaniu nowych miejsc docelowych znajdziesz poniżej:

Zapisz Identyfikator referencyjny i kliknij OK.

Znajdowanie klucza interfejsu API raportowania

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (czyli plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze nie masz pliku app-ads.txt, utwórz go na potrzeby Ad Managera.

Aby wdrożyć app-ads.txt w przypadku Liftoff Monetize, pobierz i dołącz wpisy app-ads.txt Liftoff Monetize do istniejącego pliku app-ads.txt. Więcej informacji znajdziesz w artykule o pliku app-ads.txt.

Włączanie trybu testowego

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

Wybierz aplikację, w której chcesz włączyć reklamy testowe, w sekcji Placement Reference ID (Identyfikator referencyjny miejsca docelowego) aplikacji. Reklamy testowe można włączyć, wybierając Test Mode (Tryb testowy) i Show test ads only (Pokazuj tylko reklamy testowe) w sekcji Status.

Krok 2. Skonfiguruj popyt Liftoff Monetize w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

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

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA , aby dodać Liftoff do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter Liftoff Monetize

Integracja przez pub.dev

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

Integracja ręczna

Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Liftoff Monetize, rozpakuj pobrany plik i dodaj rozpakowany folder wtyczki (wraz z zawartością) do projektu Flutter. Następnie dodaj odwołanie do wtyczki w pliku pubspec.yaml, dodając tę zależność:

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

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

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu zapośredniczenia.

Od wersji 1.1.0 wtyczki Flutter Liftoff Monetize automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą użytkowników, które obsługują specyfikację Google dotyczącą udzielenia dodatkowej zgody, w tym pakiet SDK UMP. Więcej informacji znajdziesz w zalecanych instrukcjach wdrażania zgodnego z RODO na Android i iOS.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe dotyczące prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja rezygnacji musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 Twoim łańcuchu zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

Wtyczka zapośredniczenia reklam mobilnych Google dla Liftoff Monetize zawiera metodę GmaMediationLiftoffmonetize.setCCPAStatus(). Poniższy przykładowy kod pokazuje, jak przekazywać informacje o uzyskanej zgodzie do pakietu Liftoff Monetize SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklamy za pomocą Google Mobile Ads Flutter Plugin.

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

Więcej informacji i wartości, które można podać w metodzie, znajdziesz w instrukcjach zalecanej implementacji zgodnej z ustawą 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 usłudze Ad Manager i włączyć tryb testowy w interfejsie Liftoff Monetize.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z usługi Liftoff Monetize, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Liftoff Monetize (licytowanie) i Liftoff Monetize (kaskadowe).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Liftoff Monetize, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, używając ResponseInfo w tych klasach:

Oto kody i powiązane z nimi komunikaty, które adapter Liftoff Monetize wyświetla, gdy nie uda się wczytać reklamy:

Informacje o błędach pochodzących z pakietu SDK Vungle znajdziesz w artykule Kody błędów: pakiet SDK Vungle na iOS i Androida.

Historia zmian adaptera zapośredniczenia Liftoff Monetize do Fluttera

Wersja 1.5.5

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.7.8.1.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.7.7.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.

Wersja 1.5.4

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.7.8.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.7.7.0.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.

Wersja 1.5.3

• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.
• Dodaliśmy obsługę Swift Package Manager.
• Obsługuje adapter Androida Liftoff Monetize w wersji 7.7.7.0.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.7.6.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 9.1.0.

Wersja 1.5.2

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.7.7.0.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.7.6.0.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.

Wersja 1.5.1

• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.
• thought Obsługuje adapter Liftoff Monetize na Androida w wersji 7.7.4.2.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.7.4.0.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 9.0.0.

Wersja 1.5.0

• Zaktualizowano minimalną wersję Fluttera do 3.38.1.
• Zaktualizowano, aby obsługiwać wtyczkę reklam mobilnych Google do Fluttera w wersji 8.0.0.
• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.7.2.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.7.1.0.
• Zbudowano i przetestowano z użyciem wtyczki reklam mobilnych Google do Fluttera w wersji 8.0.0.

Wersja 1.4.3

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.6.3.1.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.6.3.1.
• Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.

Wersja 1.4.2

• Zaktualizowano minimalną wersję Fluttera do 3.35.1.
• Zaktualizowano obsługę wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.6.2.0.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.6.3.0.
• Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 7.0.0.

Wersja 1.4.1

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.6.1.0.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.6.2.0.
• Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.4.0

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.6.0.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.6.1.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.3.0

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.5.1.1.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.6.0.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.2.3

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.5.1.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.5.3.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.2.2

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.5.0.1.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.5.2.0.
• Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.2.1

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.5.0.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.5.1.0.
• Zbudowano i przetestowano przy użyciu wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.2.0

• Obsługuje adapter Androida Liftoff Monetize w wersji 7.5.0.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.5.0.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.1.1

• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.4.3.1.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.4.5.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 6.0.0.

Wersja 1.1.0

• Wtyczka na iOS jest teraz platformą statyczną.
• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.4.3.0.
• Obsługuje adapter Liftoff Monetize na iOS w wersji 7.4.4.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.3.1.

Wersja 1.0.0

• Pierwsza wersja.
• Obsługuje adapter Liftoff Monetize na Androida w wersji 7.3.1.0.
• Obsługuje adapter iOS Liftoff Monetize w wersji 7.3.2.0.
• Zbudowano i przetestowano za pomocą wtyczki reklam mobilnych Google do Fluttera w wersji 5.1.0.