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

Integracja MyTarget z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z elementu myTarget za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać element myTarget do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK myTarget i adapter z aplikacją iOS .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Ad Manager elementu zapośredniczenia dla elementu myTarget ma te możliwości:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej

Najnowszy pakiet SDK do reklam mobilnych Google
Skorzystaj z zapośredniczenia Wprowadzenie

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. Aby dodać aplikację, kliknij DODAJ APLIKACJĘ.

Następnie podaj adres URL iTunes dla Twojej aplikacji.

Gdy dodajesz aplikację, myTarget musisz utworzyć jednostkę reklamową, zanim zakończysz ten proces.

Wybierz BANNER z dostępnych formatów reklam i kliknij przycisk BANNER.

Pełnoekranowa

Spośród dostępnych formatów reklam wybierz REKLAMA PEŁNOEKRANOWA i kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Otrzymano

Wybierz FILM Z NAGRODĄ spośród dostępnych formatów reklamy i kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Natywna

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

Na stronie szczegółów jednostki reklamowej zanotuj identyfikator boksu, który znajdziesz w ustawieniach jednostki reklamowej jako slot_id. Ten identyfikator boksu zostanie użyty w następnej sekcji do skonfigurowania Ad Manager jednostki reklamowej.

Oprócz parametru slot_id potrzebujesz też tokena stałego dostępu myTarget, by skonfigurować identyfikator jednostki reklamowej AdMob. Otwórz kartę Profile (Profil) i wybierz Access Tokens (Tokeny dostępu). Kliknij Create Token (Utwórz token) lub Show Token (Pokaż token), aby wyświetlić Permanent Access Token (token stałego dostępu) myTarget.

Włącz tryb testowy

Wykonaj instrukcje podane w dokumentacji obiektu myTarget, aby dodać i skonfigurować urządzenie testowe w interfejsie użytkownika myTarget.

Krok 2. Skonfiguruj strategię MyTarget na potrzeby ofert reklamowych w Ad Manager interfejsie użytkownika

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach 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 w przypadku usługimyTarget, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz myTarget, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszPermanent Access Token uzyskane w poprzedniej sekcji.

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, iOS jako platformę i Aktywne jako stan. WpiszSlot ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

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

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

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Mail.ru do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w Ad Manager UI.

Krok 3. Zaimportuj pakiet SDK myTarget i adapter

Używanie CocoaPods (zalecane)

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

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK myTarget.
Pobierz najnowszą wersję adaptera myTarget, korzystając z linku do pobierania w dzienniku zmian, i dodaj link MyTargetAdapter.framework w swoim projekcie.
Dodaj do projektu te platformy:
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

Krok 4. Zastosuj ustawienia prywatności w pakiecie SDK myTarget

Zgoda użytkowników z UE a RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz dopilnować, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) udzielili określonych informacji na temat korzystania z identyfikatorów urządzeń i danych osobowych oraz uzyskali od nich odpowiednie zgody. 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). Żeby uzyskać zgodę na wykorzystanie danych, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub wykorzystywać dane osobowe, a także dostarczać informacje o korzystaniu z nich przez poszczególne sieci. Obecnie Google nie może automatycznie przekazać zgody użytkownika na wykorzystanie danych do takich sieci.

W pakiecie SDK w wersji 4.7.9, w ramach platformy myTarget dodano interfejs API do uzyskiwania zgody użytkownika, aby zapewnić zgodność z wymaganiami dotyczącymi prywatności. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK myTarget. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Objective-C

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

[MTRGPrivacy setUserConsent:YES];

Poza tym, jeśli wiadomo, że użytkownik należy do kategorii z ograniczeniami wiekowymi, możesz przekazać informacje o zgodzie użytkownika do pakietu SDK myTarget, używając podanego niżej kodu.

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Objective-C

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

[MTRGPrivacy setUserAgeRestricted:YES];

Więcej informacji oraz wartości, jakie może zawierać ta metoda, znajdziesz w przewodniku myTarget dotyczącym prywatności i RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

W pakiecie SDK w wersji 5.7.0, w systemie myTarget dodano interfejs API do uzyskiwania zgody użytkownika, aby zapewnić zgodność z wymaganiami dotyczącymi prywatności. Poniższy przykładowy kod pokazuje, jak przekazać informacje o zgodzie do pakietu SDK myTarget. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań 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 i poznać wartości, które mogą być podane w metodzie, skontaktuj się z zespołem pomocy myTarget.

Krok 5. Dodaj wymagany kod

Integracja SKAdNetwork

Wykonaj dokumentację myTarget, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager i włącz tryb testowy w myTarget interfejsie użytkownika.

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Parametry specyficzne dla sieci

Adapter myTarget obsługuje isDebugMode – opcjonalny dodatek umożliwiający logowanie, którego wartość domyślna to YES. Ten parametr można przekazać do adaptera za pomocą klasy GADMAdapterMyTargetExtras i należy go ustawiać w przypadku każdego żądania reklamy. Aby go ustawić:

Swift

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

Objective-C

 *request = [ 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 . Uzupełnia te pola dla GADNativeAd

Pole	Wypełnianie przez 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 z pakietu myTarget SDK do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny zawierać niewielką lub zerową liczbę rozbieżności.

Kody błędów

Jeśli adapter nie otrzyma reklamy z obiektu myTarget, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, używając właściwości GADResponseInfo.adNetworkInfoArray w ramach tych zajęć:

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Oto kody i powiązane z nimi komunikaty wysyłane przez adapter myTarget, gdy nie można wczytać reklamy:

Kod błędu	Przyczyna
100	Pakiet myTarget SDK zwrócił błąd.
101	Brakuje parametrów serwera myTarget skonfigurowane w interfejsie Ad Manager lub są one nieprawidłowe.
102	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez myTarget.
103	Żądanie reklamy nie jest ujednoliconym żądaniem reklamy natywnej.
104	Wczytana reklama natywna z elementu myTarget różni się od żądanej reklamy natywnej.
105	W załadowanej reklamie natywnej z elementu myTarget brakuje niektórych wymaganych komponentów (np. obrazu lub ikony).
100	Pakiet myTarget SDK nie ma jeszcze dostępnej reklamy.
101	Brakuje parametrów serwera myTarget skonfigurowane w interfejsie Ad Manager lub są one nieprawidłowe.
102	Adapter myTarget nie obsługuje żądanego formatu reklamy.
103	Próbowałem/próbowałam wyświetlić niewczytaną reklamę myTarget.
104	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez myTarget.
105	Brak wymaganych komponentów reklamy natywnej.

Dziennik zmian adaptera zapośredniczenia na iOS myTarget

Wersja 5.21.0.1

Teraz wymagany jest 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 ramach platformy MyTargetAdapter.xcframework.

Stworzone i przetestowane w:

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

Wersja 5.21.0.0

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

Stworzone i przetestowane w:

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

Wersja 5.20.2.0

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

Stworzone i przetestowane w:

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

Wersja 5.20.1.0

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

Stworzone i przetestowane w:

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

Wersja 5.19.0.0

Zweryfikowana zgodność z pakietem myTarget SDK w wersji 5.19.0.
Teraz wymagany jest iOS w wersji co najmniej 12.4.

Stworzone i przetestowane w:

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

Wersja 5.18.0.0

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

Stworzone i przetestowane w:

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

Wersja 5.17.5.0

Zweryfikowana zgodność z pakietem myTarget SDK w wersji 5.17.5.
Usunięto obsługę architektury armv7.
Teraz wymagany jest iOS w wersji co najmniej 11.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Stworzone i przetestowane w:

Pakiet SDK do reklam mobilnych Google w wersji 10.5.0.
MyTarget SDK w wersji 5.17.5.

Wersja 5.17.4.0

Zweryfikowana zgodność z pakietem myTarget SDK w wersji 5.17.4.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Stworzone i przetestowane w:

Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
MyTarget SDK w wersji 5.17.4.

Wersja 5.16.0.0

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

Stworzone i przetestowane w:

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

Wersja 5.15.2.0

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

Stworzone i przetestowane w:

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

Wersja 5.15.1.0

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

Stworzone i przetestowane w:

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

Wersja 5.15.0.1

Dodano obsługę architektury symulatora Arm64.

Stworzone i przetestowane w:

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

Wersja 5.15.0.0

Zweryfikowana zgodność z pakietem myTarget SDK w wersji 5.15.0.
Zweryfikowana zgodność 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.

Stworzone i przetestowane w:

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