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

Integracja 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 za pomocą mediacji, która obejmuje integrację kaskadową. 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 na temat zapośredniczenia.

Krok 1. Skonfiguruj konfiguracje w interfejsie myTarget

Najpierw zarejestruj się lub zaloguj 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 Natywna, 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 Ad Managera w następnej sekcji.

Aby skonfigurować identyfikator jednostki reklamowej AdMob, oprócz slot_id musisz też podać trwały token dostępu myTarget. Przejdź na 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 Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij kolejno Dostarczanie > Grupy taryfowe i Nowa grupa taryfowa.

Wpisz unikalną nazwę grupy rentowności, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów na Aplikacja mobilna. W sekcji Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji Zasoby i Aplikacja mobilna, do której chcesz dodać pośrednictwo.

Następnie kliknij przycisk Dodaj partnera dążącego do osiągnięcia zysku.

Jeśli masz już partnera zysku w myTarget, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera pod kątem stawek.

Jako sieć reklamową wybierz myTarget, wpisz unikalną nazwę i włącz mediację.

Włącz automatyczne gromadzenie danych i wpisz trwały token dostępu uzyskany w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platforma i Aktywny jako Stan. Wpisz identyfikator slotu uzyskany w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Gdy skończysz, kliknij Zapisz u dołu strony.

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 usłudze Ad Manager, która podlega ustawieniom dotyczącym RODO i amerykańskich przepisów stanowych, 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 przez każdą z nich. 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 polityce prywatności i RODO firmy myTarget znajdziesz w jej przewodniku.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. 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 zachować 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 Ad Managerze i włączyć tryb testowy w interfejsie myTarget.

Weryfikacja 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 = GAMRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Objective-C

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

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter myTarget zwraca reklamy natywne jako obiekty GADNativeAd. Wypełnia ona te pola: 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 używa wywołań zwrotnych pakietu SDK myTarget do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny być zgodne, a różnice między nimi powinny być niewielkie.

Kody błędów

Jeśli adapter nie otrzyma reklamy z myTarget, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, korzystając z elementu 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	Brak parametrów serwera myTarget skonfigurowanych w interfejsie Ad Managera lub są one nieprawidłowe.
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.24.1.0

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

Został opracowany i przetestowany z użyciem:

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

Wersja 5.24.0.0

Weryfikowana zgodność z pakietem SDK myTarget w wersji 5.24.0.
Zaktualizowaliśmy adapter, aby był zgodny ze sprawdzonymi metodami Google dotyczącymi języka Objective-C.

Został opracowany i przetestowany z użyciem:

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

Wersja 5.23.0.0

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

Został opracowany i przetestowany z użyciem:

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

Wersja 5.22.0.0

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

Został opracowany i przetestowany z użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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

Wersja 5.20.1.0

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

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
Wersja pakietu MyTarget SDK: 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 użyciem:

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

Wersja 5.18.0.0

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

Został opracowany i przetestowany z użyciem:

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 co najmniej iOS 11.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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 użyciem:

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