Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania z zapośredniczenia w InMobi, w obrębie kaskady i integracji określania stawek. Omawiamy, jak dodać InMobi do konfiguracji zapośredniczenia jednostki reklamowej oraz integracji pakietu SDK InMobi i adaptera Unity do aplikacji.
Obsługiwane integracje i formaty reklam
Integracja | |
---|---|
Określanie stawek | 1. |
Wodospad | |
Formaty | |
Baner | |
Pełnoekranowa | |
Z nagrodą |
1 Integracja ustalania stawek jest zamknięta w wersji beta, skontaktuj się ze swoim menedżerem konta i poproś o dostęp.
Wymagania
- Najnowszy pakiet SDK do reklam mobilnych Google
- Unity 4 lub nowsza
- Do wdrożenia na Androidzie
- Interfejs API Androida na poziomie 21 lub wyższym
- Do wdrożenia na iOS
- Cel wdrożenia iOS w wersji 10.0 lub nowszej
- Działający Unity projekt skonfigurowany w Google Pakiet SDK do reklam mobilnych. Zobacz Rozpocznij, aby dowiedzieć się więcej.
- Dokończ zapośredniczenie Przewodnik dla początkujących
Krok 1. Skonfiguruj konfiguracje 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.
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 skonfigurowaniaAd Manager 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
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 źródła ofert reklamowych InMobi w Ad Manager interfejsie użytkownika
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Android
Instrukcje znajdziesz w kroku 2 instrukcji na Android.
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 Ad Manager UI.
Krok 3. Zaimportuj pakiet SDK InMobi i adapter
Pobierz najnowszą wersję wtyczki zapośredniczenia do reklam mobilnych Google dla InMobi
klikając link pobierania w
Historia zmian i wyodrębnienie
GoogleMobileAdsInMobiMediation.unitypackage
z pliku ZIP.
W edytorze projektów Unity, wybierz Assets (Zasoby) > Importuj pakiet > Niestandardowy zakres dat
Spakuj i wybierz plik GoogleMobileAdsInMobiMediation.unitypackage
,
pobrano. Upewnij się, że wszystkie pliki są zaznaczone, i kliknij Importuj.
Potem kliknij Komponenty > Program do rozpoznawania usług Google Play > Program do rozpoznawania Androida > Wymuś
Zakończ. Biblioteka programu do rozpoznawania usług Unity Play będzie działać w zależności
od zera i skopiować zadeklarowane zależności
Katalog Assets/Plugins/Android
Twojej aplikacji w Unity.
Krok 4. Wdróż ustawienia prywatności w pakiecie InMobi SDK
Zgoda użytkowników z UE i RODO
Obowiązujące w Google zgoda użytkownika z UE Google, musisz dopilnować, aby takie oświadczenia zostały ujawnione. zgody uzyskane od użytkowników z Europejskiego Obszaru Gospodarczego dotyczące: wykorzystywania identyfikatorów urządzeń i danych osobowych. Zasady te odzwierciedlają wymagania unijnej dyrektywy o prywatności i łączności elektronicznej oraz Ogólnej ustawy o ochronie danych Rozporządzenie (RODO). Wyświetlając prośbę o zgodę na wykorzystanie danych, musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe i dostarczają informacji o korzystaniu z poszczególnych sieci. Google obecnie nie może automatycznego przekazywania do takich sieci wyboru użytkownika dotyczącego zgody.
Wtyczka zapośredniczenia do reklam mobilnych Google dla InMobi w wersji 2.1.0 dodała
Metoda InMobi.UpdateGDPRConsent()
, która umożliwia przekazywanie informacji o zgodzie użytkowników do:
InMobi. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do
Pakiet SDK InMobi. Jeśli chcesz wywoływać tę metodę, zalecamy wykonanie jej wcześniej
do wysyłania żą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);
Zapoznaj się z artykułem na temat wdrażania InMobi w ramach RODO szczegóły . do tego obiektu zgody.
Amerykańskie przepisy stanowe o ochronie prywatności
Stany Zjednoczone przepisy stanowe o ochronie prywatności wymagają dawania użytkownikom zrezygnować z „wyprzedaży”, „danych osobowych” (zgodnie z definicją w ustawie tych haseł) z opcją rezygnacji dostępną za pomocą dobrze widocznego powiadomienia „Nie sprzedawaj Informacje” w wierszu „sprzedaż”, na stronie głównej strony. Stany Zjednoczone stanowa prywatność użytkowników przewodnik dotyczący zgodności z przepisami prawa umożliwia włączenie ograniczone przetwarzanie danych wyświetlania reklam przez Google, ale Google nie może stosować tego ustawienia do poszczególnych reklam w łańcuchu zapośredniczenia. W przypadku każdej sieci reklamowej należy w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży i postępuj zgodnie ze wskazówkami dotyczącymi tych sieci, aby zapewnić zgodność z przepisami.
Zobacz listę InMobi Dokumentacja dotycząca ustawy CCPA .
Krok 5. Dodaj wymagany dodatkowy kod
Android
Integracja z InMobi nie wymaga dodatkowego kodu.
iOS
Integracja SKAdNetwork
Obserwuj InMobi's
dokumentacja
aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby Ad Manager 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 następujących opcjonalnych elementów:
uprawnienia dostępu do pliku AndroidManifest.xml
aplikacji.
<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" />
Opcjonalnie możesz dodać te uprawnienia do sekcji
Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
.
iOS
Nie musisz wykonywać żadnych dodatkowych czynności w przypadku integracji z iOS.
Kody błędów
Jeśli adapter nie otrzyma reklamy z InMobi, wydawcy mogą sprawdzić
bazowego błędu w odpowiedzi na żądanie reklamy za pomocą funkcji
ResponseInfo
w
następujące klasy:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Oto kody i powiązane z nimi wiadomości wysyłane przez przejściówkę InMobi, gdy nie można wczytać reklamy:
Android
Kod błędu | Przyczyna |
---|---|
0-99 | Błędy pakietu InMobi SDK. Zobacz kod . |
100 | Brak parametrów serwera InMobi skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe. |
101 | Nie udało się zainicjować pakietu SDK InMobi. |
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ę wysłania żądania reklamy InMobi bez zainicjowania pakietu SDK InMobi. Ten powinien teoretycznie nigdy się nie zdarzyć, ponieważ przejściówka uruchamia pakiet SDK InMobi. przed wysłaniem żądania reklam InMobi. |
105 | Reklama InMobi nie jest jeszcze gotowa do wyświetlenia. |
106 | InMobi nie może wyświetlić reklamy. |
107 | InMobi zwróciła reklamę natywną, w której brakuje wymaganego komponentu. |
108 | Komponenty z obrazem reklamy natywnej 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 | Brak parametrów serwera InMobi skonfigurowanych w Ad Manager interfejsie lub są nieprawidłowe. |
102 | InMobi Adapter nie obsługuje żądanego formatu reklamy. |
103 | Reklama InMobi jest już załadowana dla tej konfiguracji sieci. |
Inne | Pakiet InMobi SDK zwrócił komunikat o błędzie. Aby dowiedzieć się więcej, wejdź na IMRequestStatus.h . |
Historia zmian wtyczki InMobi Unity Mediation
Następna wersja
- Nazwa
DummyClient
została zmieniona naPlaceholderClient
.
Wersja 4.6.2
- Obsługuje adapter InMobi na Androida w wersji 10.7.4.0.
- Obsługuje adapter InMobi na iOS w wersji 10.7.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.1.
Wersja 4.6.1
- Obsługuje adapter InMobi na Androida w wersji 10.7.4.0.
- Obsługuje adapter InMobi na iOS w wersji 10.7.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 4.6.0
- Obsługuje adapter InMobi na Androida w wersji 10.7.3.0.
- Obsługuje adapter InMobi na iOS w wersji 10.7.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 4.5.1
- Obsługuje adapter InMobi na Androida w wersji 10.6.7.1.
- Obsługuje adapter InMobi na iOS w wersji 10.7.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.1.0.
Wersja 4.5.0
- Obsługuje adapter InMobi na Androida w wersji 10.6.7.1.
- Obsługuje adapter InMobi na iOS w wersji 10.7.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 9.0.0.
Wersja 4.4.1
- Obsługuje adapter InMobi na Androida w wersji 10.6.2.0.
- Obsługuje adapter InMobi na iOS w wersji 10.6.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.4.0
- Obsługuje adapter InMobi na Androida w wersji 10.6.0.0.
- Obsługuje adapter InMobi na iOS w wersji 10.6.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.6.0.
Wersja 4.3.3
- Obsługuje adapter InMobi na Androida w wersji 10.5.8.0.
- Obsługuje adapter InMobi na iOS w wersji 10.5.8.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.5.2.
Wersja 4.3.0
- Przeniesiono treść adaptera do:
GoogleMobileAds/Mediation/InMobi/
. - Przestrzeń nazw adaptera została zmieniona na
GoogleMobileAds.Mediation.InMobi
. - Obsługuje adapter InMobi na Androida w wersji 10.5.4.1.
- Obsługuje adapter InMobi na iOS w wersji 10.5.4.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 8.1.0.
Wersja 4.2.2
- Obsługuje adapter InMobi na Androida w wersji 10.1.2.1.
- Obsługuje adapter InMobi na iOS w wersji 10.1.2.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 4.2.1
- Obsługuje adapter InMobi na Androida w wersji 10.1.2.0.
- Obsługuje adapter InMobi na iOS w wersji 10.1.2.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.1.
Wersja 4.2.0
- Obsługuje adapter InMobi na Androida w wersji 10.1.1.0.
- Obsługuje adapter InMobi na iOS w wersji 10.1.1.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 4.1.0
- Obsługuje adapter InMobi na Androida w wersji 10.0.9.0.
- Obsługuje adapter InMobi na iOS w wersji 10.1.0.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.3.0.
Wersja 4.0.4
- Obsługuje adapter InMobi na Androida w wersji 10.0.7.0.
- Obsługuje adapter InMobi na iOS w wersji 10.0.7.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.2.
Wersja 4.0.3
- Obsługuje adapter InMobi na Androida w wersji 10.0.5.0.
- Obsługuje adapter InMobi na iOS w wersji 10.0.5.0.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 4.0.2
- Obsługuje adapter InMobi na Androida w wersji 10.0.3.0.
- Obsługuje adapter InMobi na iOS w wersji 10.0.2.1.
- Utworzono i przetestowano z wykorzystaniem wtyczki Unity do reklam mobilnych Google w wersji 7.0.0.
Wersja 4.0.1
- Obsługuje adapter InMobi na Androida w wersji 10.0.3.0.
- Obsługuje adapter InMobi na iOS w wersji 10.0.2.0.
Wersja 4.0.0
- Obsługuje adapter InMobi na Androida w wersji 10.0.1.0.
- Obsługuje adapter InMobi na iOS w wersji 10.0.1.0.
Wersja 3.2.0
- Obsługuje adapter InMobi na Androida w wersji 9.2.0.0.
- Obsługuje adapter InMobi na iOS w wersji 9.2.1.0.
Wersja 3.1.2
- Obsługuje adapter InMobi na Androida w wersji 9.1.9.0.
- Obsługuje adapter InMobi na iOS w wersji 9.1.7.0.
Wersja 3.1.1
- Obsługuje adapter InMobi na Androida w wersji 9.1.1.0.
- Obsługuje adapter InMobi na iOS w wersji 9.1.1.0.
Wersja 3.1.0
- Obsługuje adapter InMobi na Androida w wersji 9.1.0.0.
- Obsługuje adapter InMobi na iOS w wersji 9.1.0.0.
Wersja 3.0.3
- Obsługuje adapter InMobi na Androida w wersji 9.0.7.1.
- Obsługuje adapter InMobi na iOS w wersji 9.0.7.2.
Wersja 3.0.2
- Obsługuje adapter InMobi na Androida w wersji 9.0.7.0.
- Obsługuje adapter InMobi na iOS w wersji 9.0.7.0.
Wersja 3.0.1
- Obsługuje adapter InMobi na Androida w wersji 9.0.6.0.
- Obsługuje adapter InMobi na iOS w wersji 9.0.7.0.
Wersja 3.0.0
- Obsługuje adapter InMobi na Androida w wersji 9.0.4.0.
- Obsługuje adapter InMobi na iOS w wersji 9.0.4.0.
Wersja 2.4.0
- Obsługuje adapter InMobi na Androida w wersji 7.3.0.1.
- Obsługuje adapter InMobi na 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
- Zaktualizowaliśmy wtyczkę, aby obsługiwała nowy interfejs API z nagrodą.
- 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.