Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Tapjoy za pomocą zapośredniczenia, co obejmuje zarówno integrację określania stawek, jak i integracji kaskady. Omawiamy w nim, jak dodać Tapjoy do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK Tapjoy z aplikacją na Unity.
Obsługiwane integracje i formaty reklam
AdMob Adapter zapośredniczenia Tapjoy ma te możliwości:
Integracja | |
---|---|
Ustalanie stawek | |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- [Do określania stawek]: Wtyczka zapośredniczenia reklam mobilnych Google dla Tapjoy w wersji 2.3.0 lub nowszej (zalecana wersja)
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 19 lub wyższym
- Aby wdrożyć w iOS:
- Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej
- Działający projekt na Unity 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 Tapjoy
Zarejestruj się lub zaloguj w panelu Tapjoy.
Dodaj aplikację
Dodaj swoją aplikację do panelu Tapjoy, przechodząc do listy aplikacji w prawym górnym rogu i klikając przycisk Dodaj aplikację. Pojawi się prośba o podanie informacji o aplikacji.
Wypełnij formularz i kliknij przycisk Utwórz teraz, aby dodać swoją aplikację do panelu Tapjoy.
Możesz pominąć kroki integracji przedstawione przez Tapjoy i przejść do tworzenia miejsc docelowych do wykorzystania w AdMob zapośredniczeniu.
Jeśli aplikacja obsługuje obie platformy, jako platformę wybierz Obie.
Android
iOS
Miejsce docelowe, waluta wirtualna i treści
Miejsce docelowe
Kliknij Zarabianie > Miejsca docelowe i w prawym górnym rogu kliknij przycisk Utwórz miejsce docelowe. Nawet jeśli masz już miejsce docelowe, warto utworzyć dla niego nowe miejsce docelowe, AdMob aby można je było monitorować i raportować oddzielnie.
Wpisz nazwę miejsca docelowego, zaznacz pole wyboru Zapośredniczenie i wybierz AdMob z listy. Gdy skończysz, kliknij Utwórz.
Wpisana tutaj nazwa miejsca docelowego zostanie użyta do skonfigurowaniaAdMob jednostki reklamowej na potrzeby zapośredniczenia w następnej sekcji. W tym przykładzie zostało użyte „AdMob Zapośredniczenie”, ale miejsce docelowe możesz nazwać dowolnie.
Wirtualna waluta
Otwórz Zarabianie > Waluta wirtualna i w prawym górnym rogu kliknij przycisk Utwórz wirtualną walutę.
Wypełnij formularz i kliknij Utwórz teraz. Jako adresu URL wywołania zwrotnego użyj NO_CALLBACK. Dzięki temu pakiet SDK Tapjoy uniknie niepotrzebnego wywołania serwera.
Adapter Tapjoy nie przekazuje waluty ani nazwy waluty, więc jako nazwa i kwota tej waluty możesz wybrać dowolne wartości ogólne.
Android
iOS
treści
Aby utworzyć treści, które będą wyświetlane w miejscach docelowych, kliknij Zarabianie > Utwórz treści.
Aby uzyskać dodatkowe instrukcje dotyczące tworzenia treści, kliknij kartę odpowiadającą wybranemu formatowi reklamy:
Ustalanie stawek
Pełnoekranowa
Kliknij przycisk Utwórz obok treści Zautomatyzowanej pełnoekranowej reklamy wideo. Podaj nazwę treści i wybierz platformę. * {Android} * {iOS} Wybierz utworzoną wcześniej walutę wirtualną jako walutę wirtualną. Wybierz wcześniej utworzone miejsce docelowe reklamy pełnoekranowej. Gdy skończysz, kliknij przycisk Zapisz na dole.Otrzymano
W przypadku treści zautomatyzowanych reklam wideo z nagrodą kliknij przycisk Utwórz. * {Android} * {iOS} Wybierz utworzoną wcześniej walutę wirtualną jako walutę wirtualną. Wybierz utworzone wcześniej miejsce docelowe reklamy z nagrodą. Gdy skończysz, kliknij przycisk Zapisz na dole.Wodospad
Pełnoekranowa
Kliknij przycisk Utwórz obok treści Pełnoekranowej reklamy wideo. Podaj nazwę treści i wybierz platformę. * {Android} * {iOS} Wybierz utworzoną wcześniej walutę wirtualną jako walutę wirtualną. Wybierz wcześniej utworzone miejsce docelowe reklamy pełnoekranowej. Gdy skończysz, kliknij przycisk Zapisz na dole.Otrzymano
Kliknij przycisk Utwórz w przypadku treści wideo z nagrodą. Podaj nazwę treści i wybierz platformę. * {Android} * {iOS} Wybierz utworzoną wcześniej walutę wirtualną jako walutę wirtualną. Wybierz utworzone wcześniej miejsce docelowe reklamy z nagrodą. Gdy skończysz, kliknij przycisk Zapisz na dole.Znajdź klucz SDK
Oprócz nazwy miejsca docelowego potrzebujesz też klucza SDK, który jest potrzebny do skonfigurowania AdMob jednostki reklamowej.
Wybierz kolejno Ustawienia > Ustawienia aplikacji. Klucz pakietu SDK znajdziesz w sekcji Informacje o aplikacji na karcie Platformy aplikacji.
Android
iOS
Znajdowanie kluczy raportowania
Ustalanie stawek
W przypadku integracji określania stawek ten krok nie jest wymagany.
Wodospad
Aby kontynuować, musisz mieć klucz OAuth wydawcy i klucz zapośredniczenia. Klucz protokołu OAuth wydawcy możesz uzyskać na tej samej stronie, na karcie Klucze interfejsu API.
Klucz zapośredniczenia możesz uzyskać na tej samej stronie, na karcie Klucze zapośredniczenia w kolumnie Klucz interfejsu API do raportowania. Klucz ma etykietę „AdMob”.
Włącz tryb testowy
Reklamy testowe możesz włączyć w panelu Tapjoy w sekcji Ustawienia > Ustawienia aplikacji > Urządzenia testowe. Utwórz nowe urządzenie testowe, używając identyfikatora wyświetlania reklam urządzenia:
Android
Aby znaleźć identyfikator wyświetlania reklam na urządzeniu, w Ustawieniach na urządzeniu kliknij kolejno Google > Reklamy.
iOS
Aby uzyskać identyfikator wyświetlania reklam na swoim urządzeniu, dodaj do aplikacji ten kod. Zanim użyjesz poniższego kodu, zaimportuj do aplikacji platformę AdSupport.
Swift
let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")
Objective-C
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);
Następnie zmień wcześniej utworzone treści.
Aby zmodyfikować treści, najpierw wybierz Zarabianie > Miejsca docelowe i kliknij kartę Zainicjowane przez użytkownika. Następnie kliknij menu treści, które chcesz edytować, i wybierz Edytuj.
W sekcji Podstawowe zaznacz pole wyboru Tylko dla urządzeń testowych. Kliknij Zapisz u dołu strony. Znakomicie. Masz teraz działającą integrację zapośredniczenia z Tapjoy.
Android
iOS
Krok 2. Skonfiguruj oferty reklamowe Tapjoy 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.
Dodaj Tapjoy 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ć Tapjoy do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet Tapjoy SDK i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla Tapjoy, korzystając z linku do pobierania w historii zmian, i wyodrębnij GoogleMobileAdsTapjoyMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Assets > Import Package > Custom package (Zasoby > Importuj pakiet > Pakiet niestandardowy) i wybierz pobrany plik GoogleMobileAdsTapjoyMediation.unitypackage
. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Następnie wybierz Zasoby > Program do rozpoznawania Usług Google Play > Program do rozpoznawania Androida > Wymuś rozwiązanie. Biblioteka programu do rozpoznawania zależności usług Unity Play zajmie się rozpoznawaniem zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android
aplikacji Unity.
Krok 4. Zaimplementuj ustawienia prywatności w pakiecie Tapjoy SDK
Zgoda użytkowników z UE i 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.
Wtyczka zapośredniczenia reklam mobilnych Google dla Tapjoy w wersji 1.1.1 zawiera metody SetUserConsent()
i SubjectToGDPR()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Tapjoy. Jeśli zechcesz wywołać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUserConsent("myUserConsent");
Dostępna jest też opcjonalna flaga wskazująca, czy podlegasz przepisom RODO.
Tapjoy.SubjectToGDPR(true);
Więcej informacji oraz wartości, które mogą być podane w tej metodzie, znajdziesz w przewodniku Tapjoy na temat prywatności użytkownika.
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 Tapjoy w wersji 2.9.1 zawiera metodę SetUSPrivacy()
. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Tapjoy. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.
using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...
Tapjoy.SetUSPrivacy("myUSPrivacyString");
Więcej informacji oraz wartości, które mogą być podane w tej metodzie, znajdziesz w przewodniku Tapjoy na temat prywatności użytkownika.
Krok 5. Dodaj wymagany kod:
Android
Integracja z Tapjoy nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Wykonaj dokumentację Tapjoy, 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 Tapjoy interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyTapjoy, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Tapjoy (Bidding) and Tapjoy (Waterfall) źródeł reklam.
Kroki opcjonalne:
Android
Uprawnienia
Aby zapewnić optymalną wydajność, Tapjoy zaleca dodanie tych opcjonalnych uprawnień do pliku AndroidManifest.xml
aplikacji. Zmień plik AndroidManifest.xml
w folderze Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation
i uwzględnij te opcjonalne uprawnienia:
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
iOS
Brak dodatkowych czynności w przypadku integracji z iOS.
Kody błędów
Jeśli adapter nie otrzyma reklamy z Tapjoy, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo
w tych klasach:
Android
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | TapjoyAdapter |
Otrzymano | TapjoyMediationAdapter |
iOS
Format | Nazwa zajęć |
---|---|
Pełnoekranowa | GADMAdapterTapjoy |
Otrzymano | GADMAdapterTapjoy |
Oto kody i powiązane z nimi wiadomości wysyłane przez adapter Tapjoy, gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera Tapjoy skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
103 | Wydawca musi zażądać reklam z kontekstem Activity . |
104 | Nie udało się zainicjować pakietu SDK Tapjoy. |
105 | Podczas odtwarzania filmu wystąpił błąd prezentacji Tapjoy. |
106 | Pakiet Tapjoy SDK nie może wczytać dwóch reklam z tym samym identyfikatorem miejsca docelowego jednocześnie. |
107 | Aplikacja nie wysłała żądania reklam natywnych. |
108 | Pakiet Tapjoy SDK nie ma dostępnych treści reklam. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera Tapjoy skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
102 | Nie udało się zainicjować pakietu SDK Tapjoy. |
103 | Adapter Tapjoy nie obsługuje żądanego formatu reklamy. |
104 | Firma Tapjoy wysłała wywołanie zwrotne wczytywania, ale nie były dostępne żadne treści. |
105 | Reklama dla tej konfiguracji sieci została już wczytana. |
106 | Pakiet SDK Tapjoy zwrócił błąd wywołania zwrotnego błędu wideo. |
Historia zmian wtyczki Tapjoy Unity Mediation
Wersja 3.2.0
- Obsługuje adapter systemu Android Tapjoy w wersji 13.2.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 13.2.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 3.1.1
- Obsługuje adapter systemu Android Tapjoy w wersji 13.1.2.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 13.1.2.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.4.1.
Wersja 3.1.0
- Obsługuje adapter systemu Android Tapjoy w wersji 13.1.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 13.1.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.4.0.
Wersja 3.0.0
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/Tapjoy/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.Tapjoy
. - Obsługuje adapter systemu Android Tapjoy w wersji 13.0.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 13.0.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 2.10.1
- Obsługuje adapter Android Tapjoy w wersji 12.11.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.11.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.4.1.
Wersja 2.10.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.11.0.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.11.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 2.9.1
- Dodano metodę
Tapjoy.SetUSPrivacy(string)
. - Obsługuje adapter systemu Android Tapjoy w wersji 12.10.0.1.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.10.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.2.0.
Wersja 2.9.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.10.0.1.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.10.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 2.8.2
- Obsługuje adapter systemu Android Tapjoy w wersji 12.9.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.9.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.8.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.9.0.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.9.0.1.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 2.8.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.9.0.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.9.0.0.
Wersja 2.7.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.8.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.8.1.0.
Wersja 2.7.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.8.0.1.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.8.0.1.
Wersja 2.6.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.7.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.7.1.0.
Wersja 2.6.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.7.0.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.7.0.0.
Wersja 2.5.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.6.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.6.1.0.
Wersja 2.5.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.6.0.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.6.0.0.
Wersja 2.4.2
- Obsługuje adapter systemu Android Tapjoy w wersji 12.4.2.1.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.4.2.1.
Wersja 2.4.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.4.2.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.4.2.0.
Wersja 2.4.0
- Obsługuje adapter systemu Android Tapjoy w wersji 12.4.1.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.4.1.0.
Wersja 2.3.1
- Obsługuje adapter systemu Android Tapjoy w wersji 12.3.3.0.
- Obsługuje adapter systemu iOS Tapjoy w wersji 12.3.3.0.
Wersja 2.3.0
- Obsługuje adapter Tapjoy na Androida w wersji 12.3.1.0.
- Obsługuje adapter Tapjoy na iOS w wersji 12.3.1.0.
Wersja 2.2.0
- Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
- Obsługuje adapter Tapjoy na Androida w wersji 12.2.1.0.
- Obsługuje adapter Tapjoy na iOS w wersji 12.2.1.0.
Wersja 2.1.0
- Obsługuje adapter Tapjoy na Androida w wersji 12.2.0.0.
- Obsługuje adapter Tapjoy na iOS w wersji 12.1.0.0.
Wersja 2.0.1
- Obsługuje adapter Tapjoy na Androida w wersji 12.0.0.1.
- Obsługuje adapter Tapjoy na iOS w wersji 12.0.0.0.
Wersja 2.0.0
- Obsługuje adapter Tapjoy na Androida w wersji 12.0.0.0.
- Obsługuje adapter Tapjoy na iOS w wersji 12.0.0.0.
Wersja 1.1.1
- Obsługuje pakiet SDK Tapjoy na Androida w wersji 11.12.2.
- Obsługuje pakiet Tapjoy iOS SDK w wersji 11.12.2.
- Dodano metodę
Tapjoy.SetUserConsent()
, która pozwala przekazywać stan zgody użytkownika do pakietu SDK Tapjoy w formie ciągu tekstowego dotyczącego zgody użytkownika. - Dodano metodę
Tapjoy.SubjectToGDPR()
, która wskazuje, czy RODO dotyczy użytkownika.
Wersja 1.1.0
- Obsługuje pakiet SDK Tapjoy na Androida w wersji 11.12.1.
- Obsługuje pakiet Tapjoy iOS SDK w wersji 11.12.1.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje pakiet SDK Tapjoy na Androida w wersji 11.11.1.
- Obsługuje pakiet Tapjoy iOS SDK w wersji 11.11.1.