Integracja Mintegral z określaniem stawek (beta)

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, 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  1
Wodospad  2
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna
1 Integracja ustalania stawek jest w zamkniętej wersji beta (z wyjątkiem formatu reklamy natywnej, który jest w wersji beta otwartej).

2 Integracja kaskady jest w zamkniętej wersji beta.

Wymagania

  • Cel wdrożenia iOS w wersji 11.0 lub nowszej

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.

Dodawanie nowej aplikacji

Na karcie Ustawienia aplikacji kliknij przycisk Dodaj aplikację.

Wybierz Platformę i wypełnij resztę formularza. Następnie kliknij Zapisz.

Zapisz identyfikator 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 ustalania stawek wybierz Określanie stawek przez kod w nagłówku. Wypełnij resztę formularza i kliknij Zapisz.

Wodospad

W polu Typ ustalania stawek wybierz Tradycyjne. Wypełnij resztę formularza i kliknij Zapisz.

Po utworzeniu miejsca docelowego reklamy zanotuj jego identyfikator.

Kliknij menu 1 Jednostki reklamowe i zapisz Identyfikator jednostki reklamowej.

Znajdowanie klucza interfejsu API do raportowania Mintegral

Określanie stawek

Nie musisz tego robić w przypadku integracji z określaniem stawek.

Wodospad

Aby skonfigurować identyfikator jednostki reklamowej AdMob, potrzebujesz klucza interfejsu API Mintegral Reporting API. Kliknij Konto > Narzędzia API. Zapisz klucz dostępu i klucz tajny.

Krok 2. Skonfiguruj zapotrzebowanie Mintegral w  Ad Manager UI

Dodaj Mintegral do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

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

  • 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 pobierania w dzienniku zmian i 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 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych przez każdą z nich. 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 użytkowników do pakietu SDK Mintegral. 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 dotyczącej prywatności w Mintegral.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności nakładają na Ciebie obowiązek zapewnienia użytkownikom możliwości wycofania zgody na „sprzedaż” ich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu musisz umieścić na stronie głównej „sprzedającego” dobrze widoczny link „Do Not Sell My Personal Information” („Proszę nie sprzedawać moich danych osobowych”). 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. 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 SDK Mintegral zawiera metodę setDoNotTrackStatus, która umożliwia przekazywanie informacji o zgodzie do pakietu SDK Mintegral.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie użytkowników do pakietu SDK Mintegral. 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 z 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 Ad Manager.

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 Ad Manager interfejsie.

Reklamy natywne

Renderowanie reklam

Adapter Mintegral zwraca reklamy natywne jako obiekty GADNativeAd . Wypełnia ona te pola: pola w  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 adapter wypełnia pole GADMediaView za pomocą filmu lub obrazu.

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 ramach tych klas:

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 pasuje do rozmiaru banera obsługiwanego przez Mintegral.

Mintegral iOS Mediation Adapter Changelog

Wersja 7.7.3.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.7.3.

Zaprojektowane i przetestowane:

  • 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ż przed wyświetleniem, czy reklamy pełnoekranowe i reklamy z nagrodą są gotowe.
  • Zaktualizowano zasadę CFBundleShortVersionString, by zawierała 3 komponenty zamiast 4.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
  • Mintegral SDK w wersji 7.7.2.

Wersja 7.7.2.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.7.2.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.9.0.
  • Mintegral SDK w wersji 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

  • Weryfikowana 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.
  • Mintegral SDK w wersji 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

  • Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.6.7.

Został opracowany i przetestowany z:

  • 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.
  • Wersja pakietu SDK Mintegral: 7.6.4.

Wersja 7.6.3.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.3.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
  • Mintegral SDK w wersji 7.6.3.

Wersja 7.6.2.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.6.2.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
  • Wersja pakietu SDK Mintegral: 7.6.2.

Wersja 7.6.1.0

  • Zweryfikowano 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.
  • Wersja pakietu SDK Mintegral: 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.
  • Wersja pakietu SDK Mintegral: 7.6.0.

Wersja 7.5.9.0

  • Weryfikowana 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

  • Zweryfikowano 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.
  • Mintegral SDK w wersji 7.5.8.

Wersja 7.5.7.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.5.7.
  • Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
  • Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
  • Uwzględnij Info.plist w ramach 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.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 11.0.0.
  • Mintegral SDK w wersji 7.5.6.

Wersja 7.5.3.0

  • Weryfikowana 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.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
  • Mintegral SDK w wersji 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.
  • Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.4.7.
  • Dodano obsługę kaskady w przypadku formatu reklamy wyświetlanej przy otwarciu aplikacji.

Został opracowany i przetestowany z:

  • 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.
  • Weryfikowana zgodność z pakietem Mintegral SDK 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

  • Weryfikowana 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.
  • Mintegral SDK w wersji 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.

Zaprojektowane i przetestowane:

  • 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.
  • Mintegral SDK w wersji 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.
  • Wersja pakietu SDK Mintegral 7.3.7.

Wersja 7.3.6.0

  • Weryfikowana zgodność z pakietem Mintegral SDK 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

  • Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.3.4.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
  • Mintegral SDK w wersji 7.3.4.

Wersja 7.3.3.0

  • Weryfikowana zgodność z pakietem SDK Mintegral w wersji 7.3.3.

Został opracowany i przetestowany z:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
  • Wersja pakietu SDK Mintegral 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.
  • Mintegral SDK w wersji 7.3.0.

Wersja 7.2.9.1

  • Dodano obsługę kaskady w przypadku formatów 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.

Zaprojektowane i przetestowane:

  • Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
  • Mintegral SDK w wersji 7.2.9.

Wersja 7.2.9.0

  • Weryfikowana 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

  • Zweryfikowano zgodność z pakietem SDK Mintegral w wersji 7.2.8.

Zaprojektowane i przetestowane:

  • 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.
  • Zweryfikowano 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.