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

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 AdMob. Przewodnik obejmuje integracje kaskadowe i określanie 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 AdMob.

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

Identyfikator konta

Identyfikator konta InMobi znajdziesz w sekcji 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 / nazwę logowania.

Tylko administrator wydawcy konta będzie mógł 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 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, skonfiguruj go pod kątem swojej aplikacji.

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 AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać InMobi do konfiguracji zapośredniczenia dla jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie InMobi jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj nazwę grupie zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny być teraz widoczne wybrane przez Ciebie jednostki reklamowe:

Dodawanie InMobi jako źródła reklam

Określanie stawek

W sekcji Źródła reklam znajdź kartę Określanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz InMobi (SDK).

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo z określaniem stawek z InMobi.

Kliknij Potwierdź i wyraź zgodę, a następnie Dalej.

Jeśli masz już mapowanie dla InMobi, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator konta i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Kaskada

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz InMobi i włącz przełącznik Optymalizuj. Wpisz nazwę użytkownika i klucz interfejsu API uzyskane w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam InMobi. Następnie wpisz wartość eCPM dla InMobi i kliknij Dalej.

Jeśli masz już mapowanie dla InMobi, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator konta i identyfikator miejsca docelowego uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. W tym czasie stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla sieci. Gdy będzie można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować eCPM w Twoim imieniu.

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

Wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych, aby dodać InMobi do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob.

Krok 3. Zaimportuj pakiet SDK i adapter InMobi

Zalecane: użyj 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.

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

Używanie CocoaPods

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

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 przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do personalizacji 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.

Adapter InMobi na iOS w wersji 10.7.5.0 i nowszych obsługuje przekazywanie do pakietu SDK InMobi sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych. Więcej informacji znajdziesz w artykule RODO.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „sprzedającego”. Przewodnik po 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 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 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.

Wskazówki dotyczące włączania ustawień zgodnych z CCPA w panelu InMobi znajdziesz też 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 AdMob 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 = GADRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

GADRequest *request = [GADRequest 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: Opisy pól reklam natywnych w przypadku GADNativeAd.

Pole	Komponenty 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 reklamę, 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 AdMob 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`.