W tym przewodniku dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Mintegral za pomocą zapośredniczenia AdMob, obejmującego zarówno integrację kaskadową, jak i integrację z określaniem stawek. Przewodnik zawiera informacje o tym, jak dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Mintegral z aplikacjąiOS .
Obsługiwane integracje i formaty reklam
Adapter mediacji dla Mintegral ma te możliwości:
Integracja | |
---|---|
Określanie stawek | |
Wodospad | |
Formaty | |
Otwarcie aplikacji | 1 |
Baner | |
Pełnoekranowa | |
Z nagrodą | |
Reklama pełnoekranowa z nagrodą | |
Natywna | 2 |
2 W przypadku formatu reklamy natywnej integracje z ustalaniem stawek i kaskadą są dostępne w otwartej wersji beta.
Wymagania
- docelowa wersja iOS 11.0 lub nowsza,
Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.
Krok 1. Skonfiguruj konfiguracje w interfejsie Mintegral
Zarejestruj lub zaloguj się na konto Mintegral.
Znajdowanie klucza aplikacji
Otwórz kartę Ustawienia aplikacji i zapisz klucz aplikacji.
Dodaj nową aplikację
Na karcie Ustawienia aplikacji kliknij przycisk Dodaj aplikację.
Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.
Zanotuj identyfikator aplikacji swojej aplikacji.
Tworzenie miejsca docelowego reklamy
Po utworzeniu aplikacji otwórz kartę Miejsca docelowe i jednostki i kliknij przycisk Dodaj miejsce docelowe, jak pokazano na ilustracji poniżej.
Wpisz nazwę miejsca docelowego i format reklamy.
Określanie stawek
Jako Typ określania stawek wybierz Określanie stawek przez kod w nagłówku. Wypełnij resztę formularza i kliknij Zapisz.
Wodospad
Jako Typ ustalania stawek wybierz Tradycyjne. Wypełnij pozostałe pola formularza i kliknij Zapisz.
Po utworzeniu miejsca docelowego zanotuj jego identyfikator miejsca docelowego.
Kliknij menu 1 Jednostki reklamowe i zapisz Identyfikator jednostki reklamowej.
Znajdowanie klucza interfejsu API do raportowania Mintegral
Określanie stawek
Ten krok nie jest wymagany w przypadku integracji określania stawek.
Wodospad
Do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie klucz interfejsu API do raportowania Mintegral. Kliknij Konto > Narzędzia API. Zapisz klucz dostępu i klucz tajny.
Krok 2. Skonfiguruj zapotrzebowanie Mintegral w AdMob UI
Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej
Musisz dodać Mintegral do konfiguracji zapośredniczenia jednostki reklamowej.
Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie Mintegral jako źródła reklam.
Aby utworzyć nową grupę zapośredniczenia, wybierz Utwórz grupę zapośredniczenia.
Podaj format reklamy i platformę, a następnie kliknij Dalej.
Nazwij grupę 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ą istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.
Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:
Dodaj Mintegral jako źródło reklam
Ustalanie stawek
Na karcie Określanie stawek w sekcji Źródła reklam kliknij Dodaj Źródło reklam. Następnie kliknij Mintegral.
Kliknij Jak podpisać umowę partnerską i skonfiguruj określanie stawek współpracy z Mintegral.
Kliknij przycisk Potwierdzam i wyrazić zgodę i kliknąć Dalej.
Jeśli masz już mapowanie dla Mintegral, możesz ją zaznaczyć. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz App Key, App ID, Placement ID, and Ad Unit ID opisane w poprzedniej sekcji. Następnie kliknij Gotowe.
Wodospad
Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij Mintegral.
Kliknij Mintegral. Następnie wpisz wartość eCPM dlaMintegral i kliknij Dalej.Jeśli masz już mapowanie Mintegral, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.
Następnie wpisz dane App Key, App ID, Placement ID, and Ad Unit IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.
Dodawanie partnerów reklamowych do listy zgodnej z RODO i przepisami stanowymi w USA
Aby dodać Mobvistę/Mintegral do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA w interfejsie AdMob, wykonaj czynności opisane w ustawieniach dotyczących RODO i amerykańskich przepisów stanowych.
Krok 3. Zaimportuj pakiet SDK i adapter Mintegral
Używanie CocoaPods (zalecane)
Dodaj ten wiersz do pliku Podfile projektu:
pod 'GoogleMobileAdsMediationMintegral'
W wierszu poleceń:
pod install --repo-update
Integracja ręczna
- Pobierz najnowszą wersję pakietu Mintegral SDK na iOS i połącz w projekcie wszystkie pliki
.framework
i pakiety. - Pobierz najnowszą wersję adaptera Mintegral, korzystając z linku do pobrania w Changelog i z linku
MintegralAdapter.xcframework
w projekcie.
Krok 4. Wdróż ustawienia prywatności w pakiecie SDK Mintegral
Zgoda użytkowników z UE i RODO
Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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.
Pakiet SDK Mintegral zawiera metodę setConsentStatus
, która umożliwia przekazywanie informacji o zgodzie do pakietu SDK Mintegral.
Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do biblioteki Mintegral SDK. Te opcje muszą zostać ustawione przed inicjowaniem pakietu SDK do reklam mobilnych Google, aby zapewnić ich prawidłowe przekazywanie do pakietu SDK Mintegral.
Swift
import MTGSDK
// ...
MTGSDK.sharedInstance().setConsentStatus(true)
Objective-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setConsentStatus:YES];
Więcej informacji znajdziesz w dokumentacji Mintegral dotyczące ochrony prywatności.
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 przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w celu wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.
Pakiet Mintegral SDK zawiera metodę setDoNotTrackStatus
do przekazywania informacji o zgodzie do pakietu SDK Mintegral.
Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do biblioteki Mintegral SDK. Jeśli musisz wywołać tę metodę, zrób to przed zainicjowaniu pakietu SDK do reklam mobilnych Google aby mieć pewność, że są one prawidłowo przekazywane do pakietu SDK Mintegral.
Swift
import MTGSDK
// ...
MTGSDK.sharedInstance().setDoNotTrackStatus(false)
Objective-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];
Więcej informacji znajdziesz w dokumentacji dotyczącej prywatności w Mintegral.
Krok 5. Dodaj wymagany kod
Integracja SKAdNetwork
Aby dodać identyfikatory SKAdNetwork do pliku Info.plist
projektu, postępuj zgodnie z dokumentacją Mintegral.
Krok 6. Przetestuj implementację
Włącz reklamy testowe
Zarejestruj urządzenie testowe na potrzeby AdMob.
Aby uzyskać reklamy testowe Mintegral na potrzeby banerów, reklam pełnoekranowych, reklam z nagrodą i reklam natywnych, Mintegral zaleca użycie kluczy aplikacji, identyfikatorów aplikacji, identyfikatorów miejsc docelowych i identyfikatorów jednostek reklamowych podanych na Strona Mintegral Test ID.
Weryfikacja reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyMintegral, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z Mintegral (Bidding) and Mintegral (Waterfall) źródeł reklam.
Kroki opcjonalne:
Dodawanie Mintegral do listy partnerów reklamowych w rozumieniu ustawy CCPA
Wykonaj czynności opisane w Ustawieniach CCPA , aby dodać Mintegral do listy partnerów reklamowych CCPA w AdMob interfejsie.
Reklamy natywne
Renderowanie reklam
Adapter Mintegral zwraca swoje reklamy natywne jako obiekty
GADNativeAd
Uzupełnia te
pola
GADNativeAd
.
Pole | Zasoby zawsze uwzględniane przez adapter Mintegral |
---|---|
Nagłówek | |
Obraz | 1 |
Treść | |
Ikona | |
Wezwanie do działania | |
Ocena w gwiazdkach | |
Sklep | |
Cena | |
Reklamodawca |
1 Adapter Mintegral nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego w przypadku reklam natywnych. Zamiast tego wypełnia on pola
GADMediaView
filmem lub obrazem.
Kody błędów
Jeśli adapter nie otrzyma reklamy od Mintegral, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z funkcji
GADResponseInfo.adNetworkInfoArray
w tych klasach:
GADMediationAdapterMintegral
Oto kody i dołączone komunikaty z adaptera Mintegral, które pojawiają się, gdy nie udaje się załadować reklamy:
Kod błędu | Domena | Przyczyna |
---|---|---|
101 | com.google.mediation.mintegral | nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub miejsca docelowego); |
102 | com.google.mediation.mintegral | Pakiet SDK Mintegral zwrócił błąd dotyczący braku wypełnienia. |
103 | com.google.mediation.mintegral | Pakiet SDK Mintegral nie wyświetlił reklamy. |
104 | com.google.mediation.mintegral | Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w Mintegral. |
Mintegral iOS Mediation Adapter Adapter
Wersja 7.7.3.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.7.3.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
- Wersja pakietu SDK Mintegral 7.7.3.
Wersja 7.7.2.1
- Adapter nie sprawdza już, czy reklamy pełnoekranowe i reklamy z nagrodą są gotowe przed ich wyświetleniem.
- Zaktualizowaliśmy komponent
CFBundleShortVersionString
, tak aby zawierał 3 elementy zamiast 4.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
- Wersja pakietu SDK Mintegral: 7.7.2.
Wersja 7.7.2.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.7.2.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.9.0.
- Wersja pakietu SDK Mintegral: 7.7.2.
Wersja 7.7.1.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.7.1.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.8.0.
- Wersja pakietu SDK Mintegral: 7.7.1.
Wersja 7.7.0.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.7.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.8.0.
- Mintegral SDK w wersji 7.7.0.
Wersja 7.6.9.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.9.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.7.0.
- Wersja pakietu SDK Mintegral: 7.6.9.
Wersja 7.6.8.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.8.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.7.0.
- Mintegral SDK w wersji 7.6.8.
Wersja 7.6.7.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.7.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.6.0.
- Mintegral SDK w wersji 7.6.7.
Wersja 7.6.6.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.6.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.5.0.
- Wersja pakietu SDK Mintegral: 7.6.6.
Wersja 7.6.4.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.4.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.4.0.
- Mintegral SDK w wersji 7.6.4.
Wersja 7.6.3.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.3.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
- Wersja pakietu SDK Mintegral 7.6.3.
Wersja 7.6.2.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.6.2.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
- Mintegral SDK w wersji 7.6.2.
Wersja 7.6.1.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
- Mintegral SDK w wersji 7.6.1.
Wersja 7.6.0.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Mintegral SDK w wersji 7.6.0.
Wersja 7.5.9.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.5.9.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
- Wersja pakietu SDK Mintegral: 7.5.9.
Wersja 7.5.8.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.5.8.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.1.0.
- Wersja pakietu SDK Mintegral 7.5.8.
Wersja 7.5.7.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.5.7.
- Teraz wymaga to systemu iOS w wersji co najmniej 12.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
- Uwzględniono
Info.plist
w platformachMintegralAdapter.xcframework
.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
- Wersja pakietu SDK Mintegral 7.5.7.
Wersja 7.5.6.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.5.6.
- Ustawienie
GADMediationAdapterMintegral.h
jako nagłówka publicznego.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 11.0.0.
- Wersja pakietu SDK Mintegral: 7.5.6.
Wersja 7.5.3.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.5.3.
- Dodano obsługę określania stawek w przypadku formatu reklamy wyświetlanej przy otwarciu aplikacji.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
- Wersja pakietu SDK Mintegral 7.5.3.
Wersja 7.4.8.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.4.8.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.13.0.
- Wersja pakietu SDK Mintegral: 7.4.8.
Wersja 7.4.7.0
- Zaktualizowano plik podspec, aby zależał on od
MintegralAdSDK/All
zamiast odMintegralAdSDK
. - Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.4.7.
- Dodano obsługę kaskady w przypadku formatu reklamy wyświetlanej przy otwarciu aplikacji.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
- Wersja pakietu SDK Mintegral 7.4.7.
Wersja 7.4.4.0
- Dodano obsługę znaku wodnego w reklamach z określaniem stawek.
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.4.4.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.10.0.
- Wersja pakietu SDK Mintegral: 7.4.4.
Wersja 7.4.3.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.4.3.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.9.0.
- Wersja pakietu SDK Mintegral: 7.4.3.
Wersja 7.4.1.0
- Weryfikowana zgodność z pakietem Mintegral SDK w wersji 7.4.1.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
- Wersja pakietu SDK Mintegral: 7.4.1.
Wersja 7.3.9.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.3.9.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
- Wersja pakietu SDK Mintegral 7.3.9.
Wersja 7.3.8.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.8.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.6.0.
- Wersja pakietu SDK Mintegral 7.3.8.
Wersja 7.3.7.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.7.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.5.0.
- Mintegral SDK w wersji 7.3.7.
Wersja 7.3.6.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.3.6.
- Usunięto obsługę architektury
armv7
. - Teraz wymaga minimalnej wersji iOS 11.0.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.5.0.
- Mintegral SDK w wersji 7.3.6.
Wersja 7.3.4.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.4.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
- Wersja pakietu SDK Mintegral: 7.3.4.
Wersja 7.3.3.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.3.
Zaprojektowane i przetestowane:
- Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
- Mintegral SDK w wersji 7.3.3.
Wersja 7.3.0.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.0.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.1.0.
- Wersja pakietu SDK Mintegral 7.3.0.
Wersja 7.2.9.1
- Dodaliśmy kaskadową obsługę banerów (w tym MREC), reklam pełnoekranowych, reklam z nagrodą i reklam natywnych.
- Wymaga pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
- Mintegral SDK w wersji 7.2.9.
Wersja 7.2.9.0
- Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.2.9.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 9.14.0.
- Wersja pakietu SDK Mintegral: 7.2.9.
Wersja 7.2.8.0
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.2.8.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 9.14.0.
- Wersja pakietu SDK Mintegral 7.2.8.
Wersja 7.2.6.0
- Pierwsza wersja!
- Dodano obsługę określania stawek w przypadku formatów reklam banerowych (w tym MREC), pełnoekranowych, z nagrodą i natywnych.
- Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.2.6.
- Wymaga pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Został opracowany i przetestowany z:
- Pakiet SDK do reklam mobilnych Google w wersji 9.13.0.
- Wersja pakietu SDK Mintegral: 7.2.6.