Kierowanie

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu w żądaniu reklamy.

Aby zobaczyć, jak działa kierowanie reklam, pobierz aplikację demonstracyjną interfejsu API na iOS w języku Swift lub Objective-C.

Pobierz wersję demonstracyjną interfejsu API

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration to obiekt, który zbiera informacje o kierowaniu, które mają być stosowane globalnie za pomocą udostępnionej instancji GADMobileAds. Można go stosować za pomocą tego kodu:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Aby mieć pewność, że wszystkie żądania reklamy będą uwzględniać zmiany w konfiguracji żądań, ustaw konfigurację żądań przed inicjalizacją Google Mobile Ads SDK.

Ustawianie traktowania treści z uwzględnieniem wieku

Aby pomóc Ci zachować zgodność z obowiązującymi przepisami dotyczącymi prywatności dzieci i nastolatków, Google Mobile Ads SDK udostępnia ustawienie traktowania odpowiednio do wieku. Ustawienie traktowania ze względu na wiek pozwala określić, czy usługa Google Mobile Ads SDK ma stosować określone zabezpieczenia dotyczące wyświetlania reklam dzieciom, nastolatkom lub osobom w nieokreślonym wieku.

Możesz ustawić traktowanie treści z uwzględnieniem wieku za pomocą właściwości ageRestrictedTreatment w GADRequestConfiguration.

Poniższy przykład wskazuje, że żądania reklamy powinny być traktowane jako treści skierowane do dzieci:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

Aby wskazać, że treści są przeznaczone dla nastolatków lub że nie określono wieku, zastąp ustawienie .child tym:

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Aby wskazać, że treści mają być traktowane jako skierowane do nastolatków lub użytkowników w nieokreślonym wieku, zastąp ustawienie GADAgeRestrictedTreatmentChild tym:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

Gdy używasz tego ustawienia, Google Mobile Ads SDK uwzględnia w żądaniach reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić ustawienia dotyczące traktowania użytkowników z uwzględnieniem wieku zgodnie z obowiązującymi Cię wymogami prawnymi i regulacyjnymi. Więcej informacji znajdziesz w artykule Tagowanie żądania reklamy z aplikacji pod kątem przetwarzania z ograniczeniami wiekowymi.

Przejście z TFCD i TFUA na traktowanie treści z uwzględnieniem wieku

Ustawienie dotyczące traktowania ze względu na wiek zastępuje wycofane właściwości tagForChildDirectedTreatment (TFCD) i tagForUnderAgeOfConsent (TFUA).

W tabeli poniżej znajdziesz ustawienia tagForChildDirectedTreatment i tagForUnderAgeOfConsent oraz ich odpowiedniki dotyczące traktowania treści z uwzględnieniem wieku:

TFCD

tagForChildDirectedTreatment	Ograniczenia wiekowe
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Brak wartości przypisanej do tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Ograniczenia wiekowe
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Brak wartości przypisanej do tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika	GADAgeRestrictedTreatmentTeen

Interakcje tagu TFAT z tagami TFCD i TFUA

Jeśli skonfigurujesz ustawienie dotyczące traktowania z uwzględnieniem wieku oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze traktowanie.

Uwaga: w przypadku użytkowników zalogowanych na konta Google zarządzane przez Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci w odniesieniu do wszystkich żądań reklamy.

Przekazywanie ustawień dotyczących wieku za pomocą zapośredniczenia AdMob

Jeśli ustawisz traktowanie z uwzględnieniem wieku za pomocą Google Mobile Ads SDK, adaptery zapośredniczenia będą przekazywać sygnał traktowania z uwzględnieniem wieku do pakietów SDK innych firm, które uczestniczą w zapośredniczeniu.

W tabeli poniżej znajdziesz wersje adaptera zapośredniczenia, które obsługują przekazywanie sygnału dotyczącego ograniczeń wiekowych do pakietu SDK zewnętrznego źródła reklam objętego zapośredniczeniem:

Nazwa adaptera zapośredniczenia	Najwcześniejsza obsługiwana wersja
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

Ustawienie dotyczące treści skierowanych do dzieci

Ostrzeżenie: właściwość tagForChildDirectedTreatment została wycofana. Zamiast tego ustaw właściwość ageRestrictedTreatment.

W celu zapewnienia zgodności z ustawą o ochronie prywatności dzieci w internecie (COPPA) dostępna jest opcja tagForChildDirectedTreatment.

Deweloper aplikacji może wskazać w żądaniu reklamy, czy Google ma traktować treści w tej aplikacji jako skierowane do dzieci. Gdy wskażesz, że chcesz, aby Google traktowało Twoje treści jako skierowane do dzieci, Google podejmie kroki, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy. Dostępne są te opcje:

• Ustaw parametr tagForChildDirectedTreatment na true, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam (IDFA).
• Ustaw parametr tagForChildDirectedTreatment na false, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.
• Nie ustawiaj parametru tagForChildDirectedTreatment, jeśli nie chcesz określać, jak Twoje treści mają być traktowane w świetle ustawy COPPA.

Poniższy przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ustawiając ten tag, potwierdzasz, że to powiadomienie jest poprawne i że posiadasz uprawnienia do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może być przyczyną zamknięcia Twojego konta Google.

Użytkownicy, którzy nie osiągnęli wieku świadomego wyrażenia zgody

Ostrzeżenie: właściwość tagForUnderAgeOfConsent została wycofana. Zamiast tego ustaw właściwość ageRestrictedTreatment.

Możesz oznaczyć swoje żądania reklamy, aby zostały objęte ograniczonym przetwarzaniem danych w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody. Ta funkcja ma na celu ułatwienie zachowania zgodności z Ogólnym rozporządzeniem o ochronie danych (RODO). RODO może nakładać na Ciebie także inne obowiązki prawne. Zapoznaj się z wytycznymi Unii Europejskiej i skonsultuj się ze swoim prawnikiem. Narzędzia Google pomagają w przestrzeganiu przepisów, ale nie zwalniają żadnego wydawcy z jego zobowiązań wobec prawa. Więcej informacji o tym, jak RODO wpływa na działalność wydawców

Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy znajdzie się parametr TFUA (tagowanie treści dla osób, które nie osiągnęły wieku świadomego wyrażenia zgody, w Europie). Wyłącza on reklamy spersonalizowane, w tym remarketingowe, w przypadku tego konkretnego żądania reklamy. Uniemożliwia też przesyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli pomiaru skuteczności reklam lub serwerów reklamowych firm zewnętrznych.

To ustawienie może być używane ze wszystkimi wersjami Google Mobile Ads SDK przez ustawienie właściwości tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekazanie true.

• Ustaw parametr tagForUnderAgeOfConsent na true, aby wskazać, że żądania reklam mają być obsługiwane w sposób odpowiedni dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody. Zapobiega to też przesyłaniu identyfikatora wyświetlania reklam (IDFA).
• Jeśli nie ustawisz parametru tagForUnderAgeOfConsent, oznacza to, że nie chcesz, aby żądania reklam były obsługiwane w sposób odpowiedni dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody.

Poniższy przykład pokazuje, że chcesz uwzględnić w żądaniu reklamy parametr TFUA:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Tagi umożliwiające traktowanie jako skierowane do dzieci i tagForUnderAgeOfConsent nie powinny mieć jednocześnie wartości true. Jeśli tak będzie, pierwszeństwo ma ustawienie „skierowane do dzieci”.

Ważna uwaga: ten parametr tagForUnderAgeOfConsent nie jest przekazywany do adapterów zapośredniczenia w przypadku zewnętrznych źródeł reklam. To Ty odpowiadasz za dopilnowanie, aby każda zewnętrzna sieć reklamowa w Twojej aplikacji wyświetlała reklamy odpowiednie dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody zgodnie z RODO.

Filtrowanie treści reklam

Aplikacje mogą ustawiać maksymalną ocenę treści reklam dla wszystkich żądań reklamy za pomocą właściwości maxAdContentRating obiektu GADRequestConfiguration. To ustawienie dotyczy wszystkich przyszłych żądań reklamy do końca sesji. Możliwe wartości tej właściwości są oparte na klasyfikacjach oznaczeń treści cyfrowych i powinny być jedną z tych stałych:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Poniższy kod konfiguruje wszystkie żądania reklamy, aby określić, że zwracane treści reklam powinny odpowiadać oznaczeniu etykiety treści cyfrowych nie wyższemu niż GADMaxAdContentRatingGeneral.

Ważne: ustawienia filtra oceny treści określone za pomocą pakietu SDK zastępują wszelkie ustawienia skonfigurowane w interfejsie AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (beta)

Interfejs Publisher Privacy Treatment (PPT) API to opcjonalne narzędzie, które umożliwia aplikacjom wskazywanie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy, za pomocą właściwości publisherPrivacyPersonalizationState obiektu GADRequestConfiguration. Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy w pozostałej części sesji uwzględniany jest parametr ustawień prywatności wydawcy (PPT).

Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. Ten kod wyłącza personalizację reklam w przypadku wszystkich żądań reklamy:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Uwaga: w przypadku żądań reklamy z wieloma sygnałami ochrony prywatności użytkowników pierwszeństwo ma sygnał najbardziej restrykcyjny. Przykłady znajdziesz w dokumentacji interfejsu Publisher Privacy Treatment API.

GADRequest

Obiekt GADRequest zbiera informacje o kierowaniu, które mają zostać wysłane z żądaniem reklamy.

Dodawanie dodatkowych informacji wysyłanych z żądaniem reklamy

Dodatkowe informacje wysyłane z żądaniem reklamy to dodatkowe szczegóły wysyłane z żądaniem reklamy, które są specyficzne dla jednego źródła reklam.

Ten fragment kodu ustawia dodatkowy klucz parametru collapsible z wartością bottom dla Google:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

URL treści

Podczas wysyłania żądania reklamy aplikacje mogą przekazywać adres URL treści, które wyświetlają. Umożliwia to kierowanie na słowa kluczowe, aby dopasować reklamę do treści.

Jeśli na przykład aplikacja żąda reklamy podczas wyświetlania treści z witryny https://www.example.com, możesz przekazać ten adres URL, aby kierować reklamy na odpowiednie słowa kluczowe:

Swift

let request = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

Najczęstsze pytania

Jakie kierowanie jest używane, gdy reklama odświeża się automatycznie?

Podczas odświeżania reklamy do kierowania ponownie używany jest wcześniej określony obiekt GADRequest. Aby ustawić nowe kierowanie, wywołaj loadRequest w GADBannerView z nowym obiektem GADRequest.

Jak przekazywać dodatkowe parametry kierowania do sieci zapośredniczenia?

Więcej informacji o wysyłaniu kierowania do sieci zapośredniczenia znajdziesz w artykule Zapośredniczenie.