Integracja Tapjoy z zapośredniczeniem

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

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

Wersja 3.1.1

Wersja 3.1.0

Wersja 3.0.0

Wersja 2.10.1

Wersja 2.10.0

Wersja 2.9.1

Wersja 2.9.0

Wersja 2.8.2

Wersja 2.8.1

Wersja 2.8.0

Wersja 2.7.1

Wersja 2.7.0

Wersja 2.6.1

Wersja 2.6.0

Wersja 2.5.1

Wersja 2.5.0

Wersja 2.4.2

Wersja 2.4.1

Wersja 2.4.0

Wersja 2.3.1

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.