Integracja InMobi z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z InMobi za pomocą zapośredniczenia obejmującego zarówno kaskady, jak i integracje z określaniem stawek. Omawiamy, jak dodać InMobi do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować InMobi SDK i dostosować ją do Unity aplikacji.

Obsługiwane integracje i formaty reklam

Integracja
Ustalanie stawek  1
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna  2

1 Integracja ustalania stawek jest w fazie zamkniętych testów beta. Aby poprosić o dostęp do tej funkcji, skontaktuj się ze swoim menedżerem konta.

Wymagania

  • Najnowszy pakiet SDK do reklam mobilnych Google
  • Unity 4 lub nowsza
  • Aby wdrożyć to na Androidzie:
    • Interfejs API Androida na poziomie 21 lub wyższym
  • Aby wdrożyć w iOS:
    • Cel wdrożenia iOS w wersji 10.0 lub nowszej
  • Działający Unity projekt skonfigurowany za pomocą pakietu SDK do reklam mobilnych Google. Więcej informacji znajdziesz w pierwszych krokach.
  • Wykonaj 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, korzystając z linku pobierania w Changelog i wyodrębnij GoogleMobileAdsInMobiMediation.unitypackage z pliku ZIP.

W edytorze projektu Unity wybierz 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 nazw usług Unity Play przeprowadzi rozpoznawanie zależności od zera i skopiuje zadeklarowane zależności do katalogu Assets/Plugins/Android aplikacji w Unity.

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

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali określone informacje na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz aby uzyskać od nich zgodę. 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). Podczas uzyskiwania zgody musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą gromadzić, otrzymywać lub wykorzystywać dane osobowe, a także podać informacje o sposobie ich wykorzystania. Obecnie Google nie może automatycznie przekazać tym sieciom wyboru użytkownika dotyczącego zgody.

Wtyczka zapośredniczenia do reklam mobilnych Google dla InMobi w wersji 2.1.0 dodała metodę InMobi.UpdateGDPRConsent(), która umożliwia przekazywanie do InMobi informacji o zgodzie. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu InMobi SDK. Jeśli chcesz wywoływać tę metodę, zalecamy zrobienie tego przed wysłaniem żądania 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 zgody znajdziesz w informacjach o wdrażaniu RODO w InMobi.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają umożliwienia użytkownikom wycofania zgody na sprzedaż danych osobowych (w znaczeniu określonym w ustawie), za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej sprzedawcy. 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 każdej sieci reklamowej w łańcuchu zapośredniczenia. Musisz więc wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i zastosować się do zaleceń każdej z nich, by zapewnić zgodność z zasadami.

Zapoznaj się z dokumentacją InMobi dotyczącą ustawy CCPA, aby dowiedzieć się, jak włączyć ustawienia CCPA w przypadku 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 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 do pliku AndroidManifest.xml aplikacji tych 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" />

Opcjonalnie możesz dodać te uprawnienia do pliku 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ć podstawowy błąd w odpowiedzi za pomocą polecenia ResponseInfo z następującymi klasami:

Android

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

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

Oto kody i powiązane z nimi komunikaty wysyłane przez przejściówkę InMobi, gdy nie uda się wczytać reklamy:

Android

Kod błędu Przyczyna
0-99 Błędy pakietu InMobi SDK. Więcej informacji znajdziesz w opisie kodu.
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. Teoretycznie nie powinno to się zdarzyć, ponieważ adapter inicjuje 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.
Inny Pakiet InMobi SDK zwrócił komunikat o błędzie. Aby dowiedzieć się więcej, wejdź na IMRequestStatus.h.

Historia zmian wtyczki InMobi Unity Mediation

Wersja 4.6.1

Wersja 4.6.0

Wersja 4.5.1

Wersja 4.5.0

Wersja 4.4.1

Wersja 4.4.0

Wersja 4.3.3

Wersja 4.3.0

Wersja 4.2.2

Wersja 4.2.1

Wersja 4.2.0

Wersja 4.1.0

Wersja 4.0.4

Wersja 4.0.3

Wersja 4.0.2

Wersja 4.0.1

Wersja 4.0.0

Wersja 3.2.0

Wersja 3.1.2

Wersja 3.1.1

Wersja 3.1.0

Wersja 3.0.3

Wersja 3.0.2

Wersja 3.0.1

Wersja 3.0.0

Wersja 2.4.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.