Integracja elementu myTarget z zapośredniczeniem

Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z myTarget przy użyciu zapośredniczenia AdMob, w tym integracji kaskadowych. Wyjaśnia, jak dodać myTarget do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter myTarget z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter mediacji myTarget ma te możliwości:

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

Wymagania

iOS w wersji 13.0 lub nowszej

Najnowsze Google Mobile Ads SDK.
Zapoznaj się z przewodnikiem dla początkujących dotyczącym mediacji.

Krok 1. Skonfiguruj ustawienia w interfejsie myTarget

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 w iTunes aplikacji.

Podczas dodawania aplikacji myTarget wymaga utworzenia jednostki reklamowej, zanim będzie można dokończyć proces.

Z dostępnych formatów reklam wybierz BANER, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Pełnoekranowa

Wybierz REKLAMA PEŁNOEKRANOWA z dostępnych formatów reklam, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Z nagrodą

Z dostępnych formatów reklam wybierz REKLAMA WIDEO Z NAGRODĄ, a następnie kliknij przycisk DODAJ JEDNOSTKĘ REKLAMOWĄ.

Natywna

Wybierz NATYWNA z dostępnych formatów reklam, a następnie 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 miejsca docelowego zostanie użyty do skonfigurowania jednostki reklamowej AdMob w następnej sekcji.

Oprócz parametru slot_id do skonfigurowania identyfikatora jednostki reklamowej AdMob potrzebny będzie też stały token dostępu myTarget. Otwórz kartę Profil i kliknij Tokeny dostępu. Kliknij Create Token (Utwórz token) lub Show Token (Pokaż token), aby wyświetlić stały token dostępu myTarget.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec znacznej utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli nie zostało to jeszcze zrobione, skonfiguruj plik app-ads.txt pod kątem aplikacji.

Aby wdrożyć app-ads.txt w myTarget, zapoznaj się z tym artykułem: Jak utworzyć i opublikować plik.

Włączanie trybu testowego

Aby dodać i skonfigurować urządzenie testowe w interfejsie myTarget, postępuj zgodnie z instrukcjami podanymi w dokumentacji myTarget.

Krok 2. Skonfiguruj popyt myTarget w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać myTarget do konfiguracji mediacji w przypadku jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Mediacja. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i 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, na które chcesz kierować reklamy. Następnie ustaw stan grupy mediacyjnej na Włączona i kliknij Dodaj jednostki reklamowe.

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

Na karcie jednostek reklamowych powinny się teraz wyświetlać wybrane przez Ciebie jednostki:

Dodawanie myTarget jako źródła reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklam.

Wybierz myTarget i włącz przełącznik Optymalizuj. Wpisz stały token dostępu uzyskany w poprzedniej sekcji, aby skonfigurować optymalizację źródła reklam w myTarget. 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 miejsca uzyskany w poprzedniej sekcji. Następnie kliknij Gotowe.

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

Dodawanie Mail.ru do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Mail.ru do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi w interfejsie AdMob, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter myTarget

Używanie menedżera pakietów Swift

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 5.36.0.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

W Xcode kliknij File > Add Package Dependencies... (Plik > Dodaj zależności pakietu…).

W wyświetlonym wierszu poleceń wyszukaj ten adres URL pakietu:

https://github.com/googleads/googleads-mobile-ios-mediation-mytarget.git

W sekcji Reguła zależności wybierz Rozgałęzienie.
W polu tekstowym wpisz main.

Korzystanie z CocoaPods

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

Integracja ręczna

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

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

Zgoda użytkowników z UE i RODO

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. 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). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

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

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Objective-C

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

[MTRGPrivacy setUserConsent:YES];

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

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Objective-C

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

[MTRGPrivacy setUserAgeRestricted:YES];

Więcej informacji i wartości, które można podać w tej metodzie, znajdziesz w przewodniku myTarget Prywatność i RODO.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanów USA dotyczącymi ochrony 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 Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

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

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 można podać w tej metodzie, skontaktuj się z zespołem pomocy myTarget.

Krok 5. Dodaj wymagany kod

Wdrażanie SKAdNetwork

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

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w AdMob i włączono 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 ze źródeł reklam myTarget (kaskadowe).

Kroki opcjonalne:

Parametry dotyczące sieci

Adapter myTarget obsługuje parametr isDebugMode, który jest opcjonalnym dodatkiem umożliwiającym rejestrowanie logów. Jego wartość domyślna to YES. Ten parametr można przekazywać do adaptera za pomocą klasy GADMAdapterMyTargetExtras i musi być on 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 reklamy natywne jako obiekty GADNativeAd. Wypełnia te opisy pól w reklamach natywnych dla GADNativeAd:

Pole	Wypełniony 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ęć

Google Mobile Ads SDK używa wywołań zwrotnych pakietu SDK myTarget do śledzenia wyświetleń i kliknięć, więc raporty z obu źródeł powinny być zgodne i zawierać niewiele lub wcale rozbieżności.

Kody błędów

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

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Oto kody i komunikaty wyświetlane przez adapter myTarget, gdy nie uda się wczytać reklamy:

Kod błędu	Przyczyna
100	Pakiet SDK myTarget nie ma jeszcze dostępnej reklamy.
101	Parametry serwera myTarget skonfigurowane w interfejsie AdMob są nieprawidłowe lub ich brakuje.
102	Adapter myTarget nie obsługuje formatu reklamy, o który wysłano prośbę.
103	Próba wyświetlenia reklamy myTarget, która nie została wczytana.
104	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez myTarget.
105	Brak wymaganych komponentów reklamy natywnej.