Integracja InMobi z zapośredniczeniem

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ą
Natywna  2.

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

Sign up for an InMobi account.

Bidding

Select Use InMobi SSP with Google Open Bidding and enter your Google Publisher ID.

Waterfall

No additional step is required for waterfall integrations.

Log in to your InMobi account once verified.

Add an app

To add your app to the InMobi dashboard, click Inventory > Inventory Settings.

Click Add Inventory and select the Mobile App channel from the drop-down menu.

Start typing your published app store URL in the search bar and select the app from the auto-populated results. Click Continue.

If your app in not published, click Link manually and enter the required details. Click Continue.

Review the App & Website Compliance settings and then click Save and Create Placements.

Placements

After you set up your inventory, the system redirects you to the placement creation workflow.

Select the type of ad unit. Then enter a Placement Name, select Off for Audience Bidding, and fill out the rest of the form. Click Create Placement when done.

Once the placement is created, its details are shown. Take note of the Placement ID, which will be used for setting up your Ad Manager ad unit.

Account ID

Your InMobi account ID is available under Finance > Payment Settings > Payment Information.

Locate InMobi Reporting API Key

Go to My Account > Account Settings. Navigate to the API Key tab and click Generate API Key.

Select the email of the user the key is required for and click Generate API Key. A file containing the API key and username/login name will be generated.

Only the publisher administrator of the account will be able to generate an API key for all users. If you have forgotten the previously generated API key, reset your API key by hovering over your mail on the API Key tab.

Turn on test mode

Enable Test Mode for your placement on all live impressions or certain test devices only.

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

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

Wersja 4.6.2

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.