Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z InMobi z wykorzystaniem zapośredniczenia, co obejmuje zarówno integracje kaskadowe, jak i z określaniem stawek. Opisano w nim, jak dodać InMobi do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet InMobi SDK i jego adaptację z aplikacją na Unity.
Obsługiwane integracje i formaty reklam
Integracja | |
---|---|
Ustalanie stawek | 1 |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Otrzymano |
1 Integracja ustalania stawek znajduje się w fazie zamkniętych testów beta. Skontaktuj się z menedżerem konta i poproś o dostęp.
Wymagania
- Unity 4 lub nowsza
- Najnowszy pakiet SDK do reklam mobilnych Google
- Aby przeprowadzić wdrożenie na Androidzie:
- Interfejs API Androida na poziomie 19 lub wyższym
- Aby wdrożyć w iOS:
- Docelowe wdrożenie systemu iOS w wersji 10.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 ustawienia w interfejsie użytkownika InMobi
Zarejestruj się, aby utworzyć konto InMobi.
Ustalanie stawek
Wybierz Use InMobi SSP with Google Otwarte ustalanie stawek i wpisz swój identyfikator wydawcy Google.
Wodospad
Integracje kaskadowe nie wymagają żadnych dodatkowych czynności.
Po zweryfikowaniu zaloguj się na konto InMobi.
Dodaj aplikację
Aby dodać aplikację do panelu InMobi, kliknij Inventory > Inventory Settings (Zasoby reklamowe > Ustawienia zasobów reklamowych).
Kliknij Dodaj zasoby reklamowe i wybierz z menu kanał Aplikacja mobilna.
Zacznij wpisywać na pasku wyszukiwania URL opublikowanego sklepu z aplikacjami i wybierz aplikację z automatycznie wypełnionych wyników. Kliknij Continue (Dalej).
Jeśli aplikacja nie jest opublikowana, kliknij Połącz ręcznie i wpisz wymagane dane. Kliknij Continue (Dalej).
Sprawdź ustawienia zgodności aplikacji i witryn, a potem kliknij Zapisz i utwórz miejsca docelowe.
Miejsca docelowe
Po skonfigurowaniu zasobów reklamowych system przekieruje Cię do procesu tworzenia miejsca docelowego.
Ustalanie stawek
Wybierz typ jednostki reklamowej. Wpisz nazwę miejsca docelowego, wybierz Włączone i Otwarte ustalanie stawek Google w polach Określanie stawek za odbiorców oraz Partner, a potem wypełnij resztę formularza. Gdy skończysz, kliknij Utwórz miejsce docelowe.
Wodospad
Wybierz typ jednostki reklamowej. Następnie wpisz nazwę miejsca docelowego, wybierz Wyłączone dla opcji Określanie stawek za odbiorców i wypełnij resztę formularza. Gdy skończysz, kliknij Utwórz miejsce docelowe.
Po utworzeniu miejsca docelowego pojawią się jego szczegóły. Zanotuj identyfikator miejsca docelowego, który zostanie użyty do skonfigurowaniaAdMob jednostki reklamowej.
Identyfikator konta
Identyfikator konta InMobi znajdziesz w sekcji Finanse > Ustawienia płatności > Dane do płatności.
Znajdź klucz InMobi Reporting API
Ustalanie stawek
W przypadku integracji określania stawek ten krok nie jest wymagany.
Wodospad
Otwórz Moje konto > Ustawienia konta. Przejdź do karty Klucz interfejsu API i kliknij Wygeneruj klucz interfejsu API.
Wybierz adres e-mail użytkownika, dla którego wymagany jest klucz, i kliknij Wygeneruj klucz interfejsu API. Zostanie wygenerowany plik zawierający klucz interfejsu API i nazwę użytkownika lub login.
Tylko administrator konta wydawcy może wygenerować klucz interfejsu API dla wszystkich użytkowników. Jeśli nie pamiętasz wygenerowanego wcześniej klucza interfejsu API, zresetuj go, najeżdżając kursorem na pocztę na karcie Klucz interfejsu API.
Włącz tryb testowy
Włącz tryb testowy miejsca docelowego we wszystkich aktywnych wyświetleniach lub tylko na wybranych urządzeniach testowych.
Krok 2: skonfiguruj oferty reklamowe InMobi 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 InMobi 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ć InMobi do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.
Krok 3. Zaimportuj pakiet SDK i adapter InMobi
Pobierz najnowszą wersję wtyczki zapośredniczenia reklam mobilnych Google dla aplikacji InMobi, korzystając z linku do pobrania w dzienniku zmian, i wyodrębnij GoogleMobileAdsInMobiMediation.unitypackage
z pliku ZIP.
W edytorze projektu Unity wybierz Assets > Import Package > Custom package (Zasoby > Importuj pakiet > Pakiet niestandardowy) i wybierz pobrany plik GoogleMobileAdsInMobiMediation.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. Zastosuj ustawienia prywatności w pakiecie InMobi SDK
Zgoda użytkowników z UE a 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 aplikacji InMobi w wersji 2.1.0 dodała metodę InMobi.UpdateGDPRConsent()
, która umożliwia przekazywanie informacji o zgodzie użytkownika do aplikacji InMobi. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu InMobi SDK. 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.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
Więcej informacji o możliwych kluczach i wartościach akceptowanych przez InMobi w tym obiekcie dotyczącym zgody użytkownika znajdziesz w szczegółach dotyczących wdrożenia RODO.
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.
Wskazówki, jak włączyć ustawienia CCPA dla urządzeń InMobi, znajdziesz w dokumentacji firmy InMobi
Krok 5. Dodaj wymagany dodatkowy kod
Android
Integracja z InMobi nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Postępuj zgodnie z dokumentacją InMobi, 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 InMobi interfejsie użytkownika.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyInMobi, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z InMobi (Bidding) and InMobi (Waterfall) źródeł reklam.
Kroki opcjonalne:
Android
Uprawnienia
Aby uzyskać optymalną wydajność, InMobi zaleca dodanie do pliku AndroidManifest.xml
aplikacji następujących opcjonalnych uprawnień.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
Możesz opcjonalnie dodać te uprawnienia do pliku Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
.
iOS
Integracja z iOS nie wymaga żadnych dodatkowych czynności.
Kody błędów
Jeśli adapter nie otrzyma reklamy z InMobi, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z ResponseInfo
, korzystając z tych klas:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Oto kody i powiązane komunikaty wysyłane przez adapter InMobi, gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Błędy pakietu SDK InMobi. Więcej informacji znajdziesz w kodzie. |
100 | Brakuje parametrów serwera InMobi skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
101 | Nie udało się zainicjować pakietu InMobi SDK. |
102 | Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez InMobi. |
103 | Żądanie reklamy nie jest ujednoliconym żądaniem reklamy natywnej. |
104 | Podjęto próbę żądania reklamy InMobi bez zainicjowania pakietu SDK InMobi. Teoretycznie nigdy nie powinno to nastąpić, ponieważ adapter inicjuje pakiet InMobi SDK przed żądaniem reklam InMobi. |
105 | Reklama InMobi nie jest jeszcze gotowa do wyświetlania. |
106 | InMobi nie wyświetliła reklamy. |
107 | InMobi zwróciła reklamę natywną, w której brakuje wymaganego komponentu. |
108 | Komponenty z obrazem reklam natywnych InMobi zawierają nieprawidłowy adres URL. |
109 | Adapterowi nie udało się pobrać zasobów graficznych reklam natywnych InMobi. |
iOS
Kod błędu | Przyczyna |
---|---|
101 | Brakuje parametrów serwera InMobi skonfigurowanych w interfejsie AdMob lub są one nieprawidłowe. |
102 | Adapter InMobi nie obsługuje żądanego formatu reklamy. |
103 | Reklama InMobi została już wczytana dla tej konfiguracji sieci. |
Inne | Pakiet InMobi SDK zwrócił błąd. Aby dowiedzieć się więcej, wejdź na IMRequestStatus.h . |
Historia zmian wtyczki InMobi Unity Mediation
Wersja 4.4.1
- Obsługuje adapter InMobi Android w wersji 10.6.2.0.
- Obsługuje adapter InMobi iOS w wersji 10.6.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.4.0
- Obsługuje adapter InMobi Android w wersji 10.6.0.0.
- Obsługuje adapter InMobi iOS w wersji 10.6.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.3.3
- Obsługuje adapter InMobi Android w wersji 10.5.8.0.
- Obsługuje adapter InMobi iOS w wersji 10.5.8.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.5.2.
Wersja 4.3.0
- Treści adaptera zostały przeniesione do:
GoogleMobileAds/Mediation/InMobi/
. - Zrefaktoryzowano przestrzeń nazw adaptera na
GoogleMobileAds.Mediation.InMobi
. - Obsługuje adapter InMobi Android w wersji 10.5.4.1.
- Obsługuje adapter InMobi iOS w wersji 10.5.4.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 4.2.2
- Obsługuje adapter InMobi Android w wersji 10.1.2.1.
- Obsługuje adapter InMobi iOS w wersji 10.1.2.1.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 4.2.1
- Obsługuje adapter InMobi Android w wersji 10.1.2.0.
- Obsługuje adapter InMobi iOS w wersji 10.1.2.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 4.2.0
- Obsługuje adapter InMobi Android w wersji 10.1.1.0.
- Obsługuje adapter InMobi iOS w wersji 10.1.1.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 4.1.0
- Obsługuje adapter InMobi Android w wersji 10.0.9.0.
- Obsługuje adapter InMobi iOS w wersji 10.1.0.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 4.0.4
- Obsługuje adapter InMobi Android w wersji 10.0.7.0.
- Obsługuje adapter InMobi iOS w wersji 10.0.7.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 4.0.3
- Obsługuje adapter InMobi Android w wersji 10.0.5.0.
- Obsługuje adapter InMobi iOS w wersji 10.0.5.0.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 4.0.2
- Obsługuje adapter InMobi Android w wersji 10.0.3.0.
- Obsługuje adapter InMobi iOS w wersji 10.0.2.1.
- Stworzona i przetestowana z wtyczką Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 4.0.1
- Obsługuje adapter InMobi Android w wersji 10.0.3.0.
- Obsługuje adapter InMobi iOS w wersji 10.0.2.0.
Wersja 4.0.0
- Obsługuje adapter InMobi Android w wersji 10.0.1.0.
- Obsługuje adapter InMobi iOS w wersji 10.0.1.0.
Wersja 3.2.0
- Obsługuje adapter InMobi Android w wersji 9.2.0.0.
- Obsługuje adapter InMobi iOS w wersji 9.2.1.0.
Wersja 3.1.2
- Obsługuje adapter InMobi Android w wersji 9.1.9.0.
- Obsługuje adapter InMobi iOS w wersji 9.1.7.0.
Wersja 3.1.1
- Obsługuje adapter InMobi Android w wersji 9.1.1.0.
- Obsługuje adapter InMobi iOS w wersji 9.1.1.0.
Wersja 3.1.0
- Obsługuje adapter InMobi Android w wersji 9.1.0.0.
- Obsługuje adapter InMobi iOS w wersji 9.1.0.0.
Wersja 3.0.3
- Obsługuje adapter InMobi Android w wersji 9.0.7.1.
- Obsługuje adapter InMobi iOS w wersji 9.0.7.2.
Wersja 3.0.2
- Obsługuje adapter InMobi Android w wersji 9.0.7.0.
- Obsługuje adapter InMobi iOS w wersji 9.0.7.0.
Wersja 3.0.1
- Obsługuje adapter InMobi Android w wersji 9.0.6.0.
- Obsługuje adapter InMobi iOS w wersji 9.0.7.0.
Wersja 3.0.0
- Obsługuje adapter InMobi Android w wersji 9.0.4.0.
- Obsługuje adapter InMobi iOS w wersji 9.0.4.0.
Wersja 2.4.0
- Obsługuje adapter InMobi Android w wersji 7.3.0.1.
- Obsługuje adapter InMobi iOS w wersji 7.4.0.0.
Wersja 2.3.0
- Obsługuje adapter Androida w wersji 7.2.9.0.
- Obsługuje adapter iOS w wersji 7.3.2.0.
Wersja 2.2.2
- Zaktualizowano wtyczkę, aby obsługiwała nowy interfejs Rewarded API.
- Obsługuje adapter Androida w wersji 7.2.7.0.
- Obsługuje adapter iOS w wersji 7.2.7.0.
Wersja 2.2.1
- Obsługuje adapter Androida w wersji 7.2.2.0.
- Obsługuje adapter iOS w wersji 7.2.4.0.
Wersja 2.2.0
- Obsługuje adapter Androida w wersji 7.2.1.0.
- Obsługuje adapter iOS w wersji 7.2.0.0.
Wersja 2.1.2
- Obsługuje adapter Androida w wersji 7.1.1.1.
- Obsługuje adapter iOS w wersji 7.1.2.0.
Wersja 2.1.1
- Obsługuje adapter Androida w wersji 7.1.1.1.
- Obsługuje adapter iOS w wersji 7.1.1.2.
Wersja 2.1.0
- Obsługuje adapter Androida w wersji 7.1.0.0.
- Obsługuje adapter iOS w wersji 7.1.1.1.
- Dodano metodę
InMobi.UpdateGDPRConsent()
.
Wersja 2.0.0
- Obsługuje adapter Androida w wersji 7.0.4.0.
- Obsługuje adapter iOS w wersji 7.1.1.0.
Wersja 1.0.0
- Pierwsza wersja!
- Obsługuje adapter Androida w wersji 6.2.4.0.
- Obsługuje adapter iOS w wersji 6.2.1.0.