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 przy użyciu 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

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 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. 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 Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

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

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku dla myTarget, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz myTarget, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie 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, u dołu strony kliknij Zapisz.

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 zgodnych z RODO i przepisami stanowymi USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące 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

Przepisy stanowe w USA 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 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 Ad Managerze 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 = 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 swoje reklamy natywne jako obiekty GADNativeAd. Wypełnia ona te pola w przypadku 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 Ad Managera 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.