Ta strona została przetłumaczona przez Cloud Translation API.

Integracja InMobi z zapośredniczeniem

Z tego przewodnika dowiesz się, jak korzystać z pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklamy z InMobi za pomocą mediację, 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 Android do aplikacji.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do InMobi zapewnia następujące funkcje:

Integracja
Określanie stawek	¹.
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna	².

¹ Integracja ustalania stawek jest zamknięta w wersji beta, skontaktuj się ze swoim menedżerem konta i poproś o dostęp.

² Obsługiwane tylko w przypadku zapośredniczenie kaskadowe.

Wymagania

Interfejs API Androida na poziomie 21 lub wyższym

Najnowszy pakiet SDK do reklam mobilnych Google
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

Zaloguj się na konto Ad Managera.

Dodaj InMobi do firm

Ustalanie stawek

W przypadku integracji określania stawek ten krok nie jest wymagany.

Wodospad

Przejdź do sekcji Administracja > Firmy i kliknij przycisk Nowa firma na karcie Wszystkie firmy. Kliknij Sieć reklamowa.

Jako Sieć reklamowa wybierz InMobi, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie. Włącz Automatyczne zbieranie danych i wpisz Username and API Key uzyskane w poprzedniej sekcji.

Następnie wpisz swoją nazwę użytkownika, a gdy skończysz, kliknij Zapisz.

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

Ustalanie stawek

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

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj InMobi określanie stawek

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący, a potem na karcie Określanie stawek przez pakiet SDK kliknij Nowy licytujący.

Jako licytującego wybierz InMobi.

Przesuń przełącznik obok opcji Dodaj bibliotekę sygnałów tego licytującego do listy dozwolonych sygnałów i Zezwalaj na udostępnianie sygnałów temu licytującemu. Następnie kliknij Dalej.

Kliknij Dalej.

Kliknij Gotowe.

Wodospad

W przypadku integracji kaskady ten krok nie jest wymagany.

Skonfiguruj mapowanie jednostki reklamowej

Ustalanie stawek

Kliknij Wyświetlanie > Licytujący i na karcie Określanie stawek przez pakiet SDK wybierz firmę, dla której chcesz utworzyćInMobi .

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

Kliknij Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, jako Typ zasobów reklamowych wybierz Aplikacja mobilna i kliknij Aplikacja mobilna. Następnie wpiszAccount ID and Placement ID otrzymane w poprzedniej sekcji. Na koniec kliknij Zapisz.

Wodospad

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę, dla której utworzyliśmy InMobi w poprzedniej sekcji. Jako Typ integracji wybierz Zapośredniczenie mobilne SDK, Android jako Platformę i Aktywne jako Stan.

Wpisz wartość Account ID and Placement IDuzyskaną w poprzedniej sekcji oraz wartość Domyślny CPM. Kliknij Zapisz.

Uwaga: automatyczne zbieranie danych potrzebuje kilku dni na zebranie danych, zanim będzie mogło dokładnie obliczyć wartość dynamicznego CPM dla sieci zapośredniczenia. Gdy tylko obliczysz eCPM, jest on automatycznie aktualizowany w Twoim imieniu.

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

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj tę implementację zależności i konfiguracji. Korzystanie z najnowszych wersji pakietu InMobi SDK i adapter:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:inmobi:10.7.4.0")
}

Integracja ręczna

Pobierz InMobi Android SDK i wyodrębnianie plik InMobiSDK.aar w folderze libs i dodaj go do projektu.
Przejdź do Artefakty adaptera InMobi w repozytorium Google Maven. Wybierz najnowszą wersję, pobierz InMobi .aar adaptera i dodaj go do projektu.
InMobi wymaga również uwzględnienia innych zależności. Więcej informacji: Dokumentacja InMobi aby dowiedzieć się więcej.

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.

W wersji 7.1.0.0 adapter InMobi dodał funkcję InMobiConsentclass that lets you pass consent information to InMobi. The following sample code callsupdateGDPRConsent()`` do klasy InMobiConsent. Jeśli wybierzesz nazwę zaleca się zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  exception.printStackTrace();
}

InMobiConsent.updateGDPRConsent(consentObject);

Kotlin

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  exception.printStackTrace()
}

InMobiConsent.updateGDPRConsent(consentObject)

Zobacz Informacje o wdrażaniu RODO w InMobi . 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.

W wersji 10.5.7.1, adapter InMobi dodał obsługę odczytu ciągu tekstowego IAB dotyczącego ochrony prywatności w Stanach Zjednoczonych preferencji wspólnych. Postępuj zgodnie z instrukcjami podanymi w artykule Stany Zjednoczone dokumentacja stanowych przepisów o ochronie prywatności aby ustawić ciąg znaków dotyczący prywatności w Stanach Zjednoczonych preferencji wspólnych.

Zapoznaj się też z Dokumentacja dotycząca ustawy CCPA .

Krok 5. Wymagany dodatkowy kod

Integracja z InMobi nie wymaga dodatkowego kodu.

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:

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" />

Parametry charakterystyczne dla sieci

Adapter InMobi obsługuje dodatkowe parametry żądań, które można przekazać do jako pakietu Android. Adapter szuka następujących kluczy w pakiet:

Parametry i wartości żądania
`InMobiNetworkKeys.AGE_GROUP` Grupa wiekowa użytkownika.	`InMobiNetworkValues.BELOW_18` `InMobiNetworkValues.BETWEEN_18_AND_24` `InMobiNetworkValues.BETWEEN_25_AND_29` `InMobiNetworkValues.BETWEEN_30_AND_34` `InMobiNetworkValues.BETWEEN_35_AND_44` `InMobiNetworkValues.BETWEEN_45_AND_54` `InMobiNetworkValues.BETWEEN_55_AND_65` `InMobiNetworkValues.ABOVE_65`
`InMobiNetworkKeys.EDUCATION` Poziom wykształcenia użytkownika.	`InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS` `InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE` `InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE`
`InMobiNetworkKeys.AGE`	Ciąg znaków. wiek użytkownika;
`InMobiNetworkKeys.POSTAL_CODE`	Ciąg znaków. Kod pocztowy użytkownika (zwykle pięciocyfrowy)
`InMobiNetworkKeys.AREA_CODE`	Ciąg znaków. Numer kierunkowy telefonu użytkownika (część numeru telefonu)
`InMobiNetworkKeys.LANGUAGE`	Ciąg znaków. Dane użytkownika język ojczysty (jeśli jest znany).
`InMobiNetworkKeys.CITY`	Ciąg znaków. Miasto użytkownika
`InMobiNetworkKeys.STATE`	Ciąg znaków. Stan użytkownika
`InMobiNetworkKeys.COUNTRY`	Ciąg znaków. Kraj użytkownika
`InMobiNetworkKeys.LOGLEVEL` Ustawia poziom logu dla pakietu SDK InMobi.	`InMobiNetworkValues.LOGLEVEL_NONE` `InMobiNetworkValues.LOGLEVEL_DEBUG` `InMobiNetworkValues.LOGLEVEL_ERROR`

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

Java

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54);
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter.class, extras)
   .build();

Kotlin

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54)
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345")

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter InMobi zwraca reklamy natywne jako NativeAd obiektów. Zawiera te dane pola dla NativeAd.

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

¹ Przejściówka InMobi nie zapewnić bezpośredni dostęp do głównego komponentu z obrazem swoich reklam natywnych. Zamiast tego makro adapter wypełnia MediaView. z filmem lub obrazem.

Śledzenie wyświetleń i kliknięć

Pakiet SDK do reklam mobilnych Google korzysta z wywołań zwrotnych pakietu SDK InMobi do obsługi wyświetleń i śledzenie kliknięć, więc raporty w obu panelach powinny zawierać tylko niewielką lub zerową liczbę rozbieżności danych.

Kody błędów

Jeśli przejściówka nie odbierze reklamy z InMobi, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi za pomocą polecenia ResponseInfo.getAdapterResponses() w następujących klasach:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

Oto kody i powiązane z nimi wiadomości wysyłane przez przejściówkę InMobi, gdy nie można wczytać reklamy:

Kod błędu	Przyczyna
0-99	Błędy pakietu InMobi SDK. Więcej szczegółów znajdziesz w kodzie.
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.
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`.