Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja InMobi z zapośredniczeniem

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam z InMobi za pomocą zapośredniczenia, które obejmuje integracje kaskadowe i integracje z ustalaniem stawek. Dowiesz się z niego, jak dodać InMobi do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter InMobi z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia InMobi ma te możliwości:

Integracja
Określanie stawek
Kaskada
Formaty
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

iOS w wersji 13.0 lub nowszej.
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera InMobi w wersji 10.6.0.0 lub nowszej (zalecamy najnowszą wersję).

Najnowsza wersja Google Mobile Ads SDK.
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie InMobi

Zarejestruj się na konto InMobi.

Gdy Twoje konto zostanie zweryfikowane, zaloguj się.

Dodaj aplikację

Aby dodać aplikację do panelu InMobi, kliknij Inventory > Inventory Settings (Zasoby reklamowe > Ustawienia zasobów reklamowych).

Kliknij Dodaj zasoby reklamowe i w menu wybierz kanał Aplikacja mobilna.

Zacznij wpisywać opublikowany adres URL sklepu z aplikacjami na pasku wyszukiwania i wybierz aplikację z automatycznie wypełnionych wyników. Kliknij Dalej.

Jeśli aplikacja nie jest opublikowana, kliknij Połącz ręcznie i wpisz wymagane informacje. Kliknij Dalej.

Sprawdź ustawienia Zgodność aplikacji i witryn, a następnie kliknij Zapisz i utwórz miejsca docelowe.

Miejsca docelowe

Po skonfigurowaniu zasobów reklamowych system przekieruje Cię do procesu tworzenia miejsca docelowego.

Określanie stawek

Wybierz typ jednostki reklamowej. Następnie wpisz nazwę miejsca docelowego, wybierz Włączone i Określanie stawek przez pakiet SDK Google odpowiednio w polach Określanie stawek przez odbiorców i Partner, a potem wypełnij resztę formularza. Gdy skończysz, kliknij Utwórz miejsce docelowe.

Kaskada

Wybierz typ jednostki reklamowej. Następnie wpisz nazwę miejsca docelowego, wybierz Wyłącz w sekcji Określanie stawek za odbiorców i wypełnij pozostałą część formularza. Gdy skończysz, kliknij Utwórz miejsce docelowe.

Po utworzeniu miejsca docelowego wyświetlane są jego szczegóły. Zapisz identyfikator miejsca docelowego, który będzie używany do konfigurowania jednostki reklamowej Ad Managera.

Identyfikator konta

Identyfikator konta InMobi znajdziesz w sekcji Finance > Payment Settings > Payment Information (Finanse > Ustawienia płatności > Informacje o płatnościach).

Znajdowanie klucza interfejsu API do raportowania InMobi

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

Otwórz Moje konto > Ustawienia konta. Otwórz kartę 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 wydawcy konta będzie mógł wygenerować klucz interfejsu API dla wszystkich użytkowników. Jeśli nie pamiętasz wcześniej wygenerowanego klucza interfejsu API, zresetuj go, najeżdżając kursorem na swój adres e-mail na karcie Klucz interfejsu API.

Zaktualizuj plik 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 InMobi, dodaj spersonalizowany fragment kodu.

Włączanie trybu testowego

Włącz tryb testowy dla miejsca docelowego w przypadku wszystkich wyświetleń na żywo lub tylko niektórych urządzeń testowych.

Krok 2. Skonfiguruj oferty reklamowe InMobi w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodaj InMobi w sekcji Firmy

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Kaskada

Kliknij kolejno Administracja > Firmy, a następnie na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Jako Sieć reklamową wybierz InMobi, wpisz unikalną Nazwę i włącz Zapośredniczenie. Włącz Automatyczne zbieranie danych i wpisz nazwę użytkownika oraz klucz interfejsu API uzyskane w poprzedniej sekcji.

Następnie wpisz swoją nazwę użytkownika i kliknij Zapisz.

Włącz udostępnianie bezpiecznych sygnałów

Określanie stawek

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź i włącz Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznego sygnału w pytaniach o stawkę

Określanie stawek

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj InMobi i włącz opcję Włącz integrację aplikacyjną.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK.

Kliknij Zapisz.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie określania stawek InMobi

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz InMobi.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Kaskada

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę InMobi.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz identyfikator konta i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji.

Na koniec kliknij Zapisz.

Kaskada

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz Zasoby reklamowe i Aplikacja.

Przewiń do sekcji Partnerzy zysku i kliknij Dodaj partnera zapośredniczenia.

Wybierz firmę utworzoną dla InMobi w poprzedniej sekcji. Wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platformę i Aktywny jako Stan.

Wpisz identyfikator konta i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

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

Aby dodać InMobi do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w artykułach Ustawienia zgodne z rozporządzeniami europejskimi i Ustawienia zgodne z amerykańskimi przepisami stanowymi.

Krok 3. Zaimportuj pakiet SDK i adapter InMobi

Używanie Swift Package Managera

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 10.8.6.0.

Aby dodać do projektu zależność pakietu, wykonaj te czynności:

W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).

W wyświetlonym oknie wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-inmobi.git

W sekcji Reguła zależności wybierz Gałąź.
W polu tekstowym wpisz main.

Używanie CocoaPods

Dodaj do pliku Podfile projektu ten wiersz:
```
pod 'GoogleMobileAdsMediationInMobi'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK InMobi na iOS i połącz InMobiSDK.framework w projekcie.

Pobierz najnowszą wersję adaptera InMobi, korzystając z linku pobierania w historii zmian, i połącz InMobiAdapter.framework w projekcie.
Dodaj do projektu te platformy:
- libsqlite3.0.tbd
- libz.tbd
- WebKit.framework

Ustawienia projektu

Dodaj flagę -ObjC do Inne flagi tagu łączącego w sekcji Cel aplikacji > Ustawienia kompilacji.

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

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.

Począwszy od wersji 10.7.5 pakietu SDK InMobi, InMobi 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 artykule o inicjowaniu pakietu SDK.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych 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 każdej sieci reklamowej w ł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.

W wersji 10.5.6.0 adapter InMobi obsługuje odczytywanie ciągu tekstowego IAB dotyczącego ochrony prywatności w Stanach Zjednoczonych z NSUserDefaults. Aby ustawić ciąg tekstowy dotyczący prywatności w USA w NSUserDefaults, postępuj zgodnie z instrukcjami podanymi w dokumentacji dotyczącej amerykańskich przepisów stanowych o ochronie prywatności.

Więcej informacji o włączaniu ustawień zgodnych z CCPA w panelu InMobi znajdziesz w dokumentacji InMobi dotyczącej CCPA.

Krok 5. Wymagany dodatkowy kod

Wdrażanie SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją InMobi.

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 InMobi.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z InMobi, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam InMobi (określanie stawek) i InMobi (kaskada).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter InMobi obsługuje dodatkowe parametry żądania, które można przekazywać do adaptera za pomocą klasy GADInMobiExtras. GADInMobiExtras zawiera te właściwości wspólne dla wszystkich obsługiwanych formatów reklam:

Parametry i wartości żądania
`setAgeGroup` Grupa wiekowa użytkownika.	`kIMSDKAgeGroupBelow18` `kIMSDKAgeGroupBetween18And24` `kIMSDKAgeGroupBetween25And29` `kIMSDKAgeGroupBetween30And34` `kIMSDKAgeGroupBetween35And44` `kIMSDKAgeGroupBetween45And54` `kIMSDKAgeGroupBetween55And64` `kIMSDKAgeGroupAbove65`
`setEducationType` Poziom wykształcenia użytkownika.	`kIMSDKEducationHighSchoolOrLess` `kIMSDKEducationCollegeOrGraduate` `kIMSDKEducationPostGraduateOrAbove`
`setLogLevel`	`kIMSDKLogLevelNone` `kIMSDKLogLevelError` `kIMSDKLogLevelDebug`
`setAge`	Liczba całkowita. Wiek użytkownika.
`setYearOfbirth`	Liczba całkowita. Rok urodzenia użytkownika.
`setPostalCode`	Ciąg znaków. Kod pocztowy użytkownika. Zwykle jest to 5-cyfrowy numer.
`setAreaCode`	Ciąg znaków. Numer kierunkowy użytkownika (część numeru telefonu).
`setLanguage`	Ciąg znaków. Język ojczysty użytkownika (jeśli jest znany).
`setLoginId`	Ciąg znaków. Identyfikator logowania w domenie wydawcy.
`setSessionId`	Ciąg znaków. Identyfikator sesji w domenie wydawcy.
`setLocationWithCityStateCountry`	Ciąg znaków. Lokalizacja z parametrami miasto, stan i kraj.
`setKeywords`	Ciąg znaków. Wszelkie słowa kluczowe pasujące do kontekstu, które mają być przekazywane w żądaniu reklamy.
`setInterests`	Ciąg znaków. Wszelkie ciągi znaków istotne pod względem kontekstu, które mają być przekazywane w żądaniu reklamy.
`setAdditionalParameters`	Słownik. Wszelkie dodatkowe wartości, które mają być przekazywane w żądaniu reklamy.

Oto przykładowy kod pokazujący, jak ustawić te parametry żądania reklamy:

Swift

let request = GAMRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

GAMRequest *request = [GAMRequest request];
GADInMobiExtras *extras = [[GADInMobiExtras alloc] init];
extras.ageGroup = kIMSDKAgeGroupBetween35And54;
extras.areaCode = @"12345";
[request registerAdNetworkExtras:extras];

Korzystanie z reklam natywnych

renderowanie reklam

Adapter InMobi zwraca reklamy natywne jako obiekty GADNativeAd. Wypełnia te pola w przypadku GADNativeAd.

Pole	Zasoby zawsze uwzględniane przez adapter InMobi
Nagłówek
Obraz	1
Widok multimediów
Treść
Ikona aplikacji
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena

¹ Adapter InMobi nie zapewnia bezpośredniego dostępu do głównego komponentu z obrazem w przypadku reklam natywnych. Zamiast tego adapter wypełnia GADMediaView filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Kliknięcia są wykrywane przez Google Mobile Ads SDK i przekazywane do InMobi, dzięki czemu raportowanie kliknięć będzie zsynchronizowane.

Google Mobile Ads SDK używa wywołań zwrotnych pakietu SDK InMobi do śledzenia wyświetleń, więc raporty w obu panelach powinny być zgodne i zawierać niewiele rozbieżności lub nie zawierać ich wcale.

Kody błędów

Jeśli adapter nie otrzyma reklamy z InMobi, wydawcy mogą sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z metody GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Kod błędu	Przyczyna
101	Parametry serwera InMobi skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez InMobi.
103	Reklama InMobi została już wczytana dla tej konfiguracji sieci.
104	Reklama natywna InMobi została zwrócona z brakującymi komponentami natywnymi lub nie udało się pobrać wymaganych komponentów z obrazem.
105	Reklama InMobi nie jest gotowa do wyświetlenia.
106	InMobi zwraca pusty lub zerowy token stawki.
Inne	Pakiet SDK InMobi zwrócił błąd. Więcej informacji znajdziesz na stronie `IMRequestStatus.h`.