Zintegruj Mintegral z zapośredniczeniem

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
1 Określanie stawek i integracje kaskadowe reklam wyświetlanych przy otwarciu aplikacji są w fazie zamkniętych testów beta.

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,

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 docelowegoformat 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 RODOamerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Mintegral

  • 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

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 platformach MintegralAdapter.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 od MintegralAdSDK.
  • 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.