Ta strona została przetłumaczona przez Cloud Translation API.

Integracja elementu myTarget z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z myTarget przy użyciu pośrednictwa AdMob, w tym integracji kaskadowych. Znajdziesz w nim informacje o tym, jak dodać myTarget do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter myTarget z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter pośredniczący dla myTarget ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

docelowa wersja iOS 12.0 lub nowsza

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przeczytaj Przewodnik dla początkujących

Krok 1. Skonfiguruj konfiguracje w interfejsie myTarget

Najpierw zarejestruj się lub zaloguj się na konto myTarget. Otwórz stronę Aplikacje, klikając APLIKACJE w nagłówku. Dodaj aplikację, klikając DODAJ APLIKACJĘ.

Następnie podaj adres URL aplikacji w iTunes.

Podczas dodawania aplikacji myTarget wymaga utworzenia jednostki reklamowej, zanim uda Ci się dokończyć proces.

Spośród dostępnych formatów reklam wybierz BANER, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Pełnoekranowa

Spośród dostępnych formatów reklam wybierz INTERSTITIAL, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Z nagrodą

Spośród dostępnych formatów reklam wybierz WIDEO Z NAGRODĄ, a potem kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Natywna

Spośród dostępnych formatów reklam wybierz NATYWNY, a potem kliknij DODAJ JEDNOSTKĘ REKLAMOWĄ.

Na stronie szczegółów jednostki reklamowej zanotuj identyfikator boksu reklamowego, który znajdziesz w ustawieniach jednostki reklamowej jako slot_id. Ten identyfikator miejsca na reklamę posłuży Ci do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Aby skonfigurować identyfikator jednostki reklamowej AdMob, oprócz slot_id musisz też podać trwały token dostępu myTarget. Otwórz kartę Profil i wybierz Tokeny dostępu. Kliknij Utwórz token lub Pokaż token, aby wyświetlić trwały token dostępu myTarget.

Włączanie trybu testowego

Aby dodać i skonfigurować urządzenie testowe w interfejsie myTarget, wykonaj instrukcje podane w dokumentacji myTarget.

Krok 2. Skonfiguruj zapotrzebowanie myTarget w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać myTarget do konfiguracji pośrednictwa w przypadku danej jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediation (Mediacja). Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, a potem przejdź do sekcji Dodawanie myTarget jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj grupie zapośredniczenia nazwę i wybierz lokalizacje docelowe. Następnie ustaw stan grupy zapośredniczenia na Włączona, a potem kliknij Dodaj jednostki reklamowe.

Połącz tę grupę zapośredniczenia z co najmniej jedną z dotychczasowych jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Powinna się teraz wyświetlić karta Jednostki reklamowe z wybranymi przez Ciebie jednostkami reklamowymi:

Dodawanie myTarget jako źródła reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam. Następnie wybierz myTarget.

Wybierz myTarget i włącz przełącznik Optymalizuj. Aby skonfigurować optymalizację źródła reklam dla myTarget, wpisz trwały token dostępu uzyskany w poprzedniej sekcji. Następnie wpisz wartość eCPM dla myTarget i kliknij Dalej.

Jeśli masz już mapowanie dla myTarget, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz identyfikator slotu uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

Uwaga: optymalizacja źródła reklam potrzebuje kilku dni na zebranie wystarczającej ilości danych, aby dokładnie obliczyć eCPM dla sieci zapośredniczenia. Tymczasem stan optymalizacji źródła reklam to PENDING, więc musisz ręcznie ustawić wartość eCPM dla tej sieci. Gdy można obliczyć eCPM, źródło reklam automatycznie zacznie aktualizować tę wartość w Twoim imieniu.

Dodawanie Mail.ru do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Mail.ru do listy partnerów reklamowych w interfejsie AdMob, wykonaj czynności opisane w ustawieniach RODO i ustawieniach dotyczących przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter myTarget

Za pomocą CocoaPods (zalecane)

Dodaj ten wiersz do pliku Podfile projektu:
```
pod 'GoogleMobileAdsMediationMyTarget'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK myTarget.
Pobierz najnowszą wersję adaptera myTarget, korzystając z linku do pobrania w Changelog i z linku MyTargetAdapter.framework w projekcie.
Dodaj do projektu te frameworki:
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

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

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). 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. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

W wersji pakietu SDK 4.7.9 firma myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do myTarget SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserConsent:YES];

Jeśli wiesz, że użytkownik należy do kategorii objętej ograniczeniami wiekowymi, możesz użyć tego kodu, aby przekazać te informacje o zgodzie do pakietu SDK myTarget.

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserAgeRestricted:YES];

Więcej informacji o wartościach, które można podać w ramach tej metody, oraz o RODO znajdziesz w przewodniku myTarget.

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 po przepisach stanowych USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku 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ść.

W wersji pakietu SDK 5.7.0 firma myTarget dodała interfejs API zgody użytkownika, aby spełnić wymagania dotyczące prywatności. Poniższy przykładowy kod pokazuje, jak przekazywać te informacje o zgodzie do myTarget SDK. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setCcpaUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setCcpaUserConsent:YES];

Aby uzyskać więcej informacji o wartościach, które można podać w ramach tej metody, skontaktuj się z zespołem pomocy myTarget.

Krok 5. Dodaj wymagany kod

Integracja z SKAdNetwork

Aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu, postępuj zgodnie z dokumentacją myTarget.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob i włączyć tryb testowy w interfejsie myTarget.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z myTarget, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając z źródeł reklam myTarget (kaskada).

Kroki opcjonalne:

Parametry związane z siecią

Adapter myTarget obsługuje parametr isDebugMode, który jest opcjonalnym dodatkiem umożliwiającym rejestrowanie danych. Jego domyślna wartość to YES. Ten parametr można przekazać do adaptera za pomocą klasy GADMAdapterMyTargetExtras. Musi być ustawiony w każdym żądaniu reklamy. Oto jak to zrobić:

Swift

let request = GADRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADMAdapterMyTargetExtras * extras = [[GADMAdapterMyTargetExtras alloc] init];
extras.isDebugMode = NO;
[request registerAdNetworkExtras:extras];

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter myTarget zwraca swoje reklamy natywne jako obiekty GADNativeAd. Wypełnia ona te pola reklam natywnych: GADNativeAd.

Pole	Wypełnia je adapter myTarget.
Nagłówek	Zawsze
Obraz	Zawsze
Treść	Zawsze
Ikona aplikacji	Zawsze
Wezwanie do działania	Zawsze
Ocena w gwiazdkach	Niegwarantowane
Sklep	Niegwarantowane
Cena	Niegwarantowane
Logo	Niegwarantowane
Reklamodawca	Zawsze

Śledzenie wyświetleń i kliknięć

Pakiet SDK do reklam mobilnych Google korzysta z wywołań zwrotnych pakietu SDK myTarget do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny być zgodne lub zawierać niewielkie rozbieżności.

Kody błędów

Jeśli adapter nie otrzyma reklamy z myTarget, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, używając funkcji GADResponseInfo.adNetworkInfoArray w ramach tych klas:

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Oto kody i odpowiednie komunikaty wyrzucane przez adapter myTarget, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
100	Pakiet SDK myTarget nie zawiera jeszcze reklamy.
101	Parametry serwera myTarget skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102	Adapter myTarget nie obsługuje żądanego formatu reklamy.
103	Próbowano wyświetlić reklamę myTarget, która nie została załadowana.
104	Żądaną wielkość reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze myTarget.
105	Brak wymaganych komponentów reklam natywnych.

Historia zmian adaptera dogodzenia reklam myTarget na iOS

Wersja 5.23.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.23.0.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.13.0.
Wersja pakietu SDK MyTarget 5.23.0.

Wersja 5.22.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.22.0.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.12.0.
Wersja pakietu SDK MyTarget: 5.22.0.

Wersja 5.21.9.1

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.
Pakiet SDK MyTarget w wersji 5.21.9.

Wersja 5.21.9.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.9.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
Pakiet SDK MyTarget w wersji 5.21.9.

Wersja 5.21.8.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.8.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
Pakiet SDK MyTarget w wersji 5.21.8.

Wersja 5.21.7.0

Weryfikacja zgodności z pakietem SDK myTarget w wersji 5.21.7.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.8.0.
Wersja pakietu SDK MyTarget: 5.21.7.

Wersja 5.21.6.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.6.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.7.0.
Wersja pakietu SDK MyTarget 5.21.6.

Wersja 5.21.5.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.5.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.7.0.
Pakiet SDK MyTarget w wersji 5.21.5.

Wersja 5.21.4.0

Zweryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.4.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.5.0.
Wersja pakietu SDK MyTarget 5.21.4.

Wersja 5.21.3.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.3.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.5.0.
Pakiet SDK MyTarget w wersji 5.21.3.

Wersja 5.21.2.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.2.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.3.0.
Wersja pakietu SDK MyTarget 5.21.2.

Wersja 5.21.1.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.1.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
Wersja pakietu SDK MyTarget: 5.21.1.

Wersja 5.21.0.1

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 ramowych MyTargetAdapter.xcframework.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
Wersja pakietu SDK MyTarget: 5.21.0.

Wersja 5.21.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.21.0.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
Wersja pakietu SDK MyTarget: 5.21.0.

Wersja 5.20.2.0

Zweryfikowana zgodność z pakietem SDK myTarget w wersji 5.20.2.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 11.0.0.
Wersja pakietu MyTarget SDK to 5.20.2.

Wersja 5.20.1.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.20.1.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
Pakiet SDK MyTarget w wersji 5.20.1.

Wersja 5.19.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.19.0.
Teraz wymaga co najmniej iOS 12.4.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 10.8.0.
Wersja pakietu MyTarget SDK to 5.19.0.

Wersja 5.18.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.18.0.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
Pakiet SDK MyTarget w wersji 5.18.0.

Wersja 5.17.5.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.17.5.
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.
Pakiet SDK MyTarget w wersji 5.17.5.

Wersja 5.17.4.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.17.4.
Wymaga teraz 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.2.0.
Pakiet SDK MyTarget w wersji 5.17.4.

Wersja 5.16.0.0

Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.
Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.16.0.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 9.10.0.
Pakiet SDK MyTarget w wersji 5.16.0.

Wersja 5.15.2.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.15.2.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 9.5.0.
Pakiet SDK MyTarget w wersji 5.15.2.

Wersja 5.15.1.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.15.1.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 9.2.0.
Pakiet SDK MyTarget w wersji 5.15.1.

Wersja 5.15.0.1

Dodano obsługę architektury symulatora arm64.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
Pakiet SDK MyTarget w wersji 5.15.0.

Wersja 5.15.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.15.0.
Wersja zweryfikowana pod kątem zgodności z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Został opracowany i przetestowany z:

Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
Pakiet SDK MyTarget w wersji 5.15.0.