Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu w żądaniu reklamy.
Aby zobaczyć, jak działa kierowanie reklam, pobierz aplikację demonstracyjną iOS API w języku Swift lub Objective-C.
Pobierz aplikację demonstracyjną API
Wymagania wstępne
Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK.
GADRequestConfiguration
GADRequestConfiguration
to obiekt, który zbiera informacje o kierowaniu, aby zastosować je globalnie za pomocą
współdzielonej instancji
GADMobileAds. Można uzyskać do niego dostęp 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ą stosować zmiany konfiguracji żądania, ustaw konfigurację żądania przed zainicjowaniem Google Mobile Ads SDK.
Ustawianie ograniczeń wiekowych
Aby ułatwić Ci przestrzeganie obowiązujących przepisów dotyczących prywatności dzieci i nastolatków, Google Mobile Ads SDK udostępnia ustawienie dotyczące ograniczeń wiekowych. Ustawienie to pozwala określić, czy Google Mobile Ads SDK ma stosować określone zabezpieczenia wyświetlania reklam w przypadku dzieci, nastolatków lub użytkowników w nieokreślonym wieku.
Ograniczenia wiekowe możesz ustawić 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
Aby wskazać, że treści mają być traktowane jako skierowane do nastolatków lub użytkowników w nieokreślonym wieku, zastąp ustawienie .child jednym z tych ustawień:
.teen.unspecified
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
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 jednym z tych ustawień:
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
Gdy używasz tego ustawienia,
Google Mobile Ads SDK dodaje do żądań reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić ustawienia dotyczące traktowania użytkowników z uwzględnieniem obowiązującego 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.
Migracja do ustawienia dotyczącego ograniczeń wiekowych z TFCD i TFUA
Ustawienie dotyczące ograniczeń wiekowych zastępuje wycofane
tagForChildDirectedTreatment (TFCD) i tagForUnderAgeOfConsent (TFUA)
właściwości.
W tabeli poniżej znajdziesz ustawienia tagForChildDirectedTreatment i tagForUnderAgeOfConsent oraz ich odpowiedniki w ustawieniu dotyczącym ograniczeń wiekowych:
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 |
Informacje o interakcjach ustawienia dotyczącego ograniczeń wiekowych z TFCD i TFUA
Jeśli wybierzesz ustawienie dotyczące ograniczeń wiekowych oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze ograniczenie.
Przekazywanie ustawienia dotyczącego ograniczeń wiekowych za pomocą zapośredniczenia AdMob
Jeśli ustawisz ograniczenia wiekowe za pomocą Google Mobile Ads SDK, adaptery zapośredniczenia przekażą sygnał dotyczący ograniczeń wiekowych do pakietów SDK innych firm, które uczestniczą w zapośredniczeniu.
W tabeli poniżej znajdziesz listę wersji adapterów zapośredniczenia, które obsługują przekazywanie sygnału dotyczącego ograniczeń wiekowych do pakietu SDK innej firmy uczestniczącej w zapośredniczeniu:
| 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
Na potrzeby ustawy o ochronie prywatności dzieci w internecie
(COPPA)
istnieje ustawienie
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 działania, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy. Dostępne są te opcje ustawienia:
- Ustaw
tagForChildDirectedTreatmentnatrue, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam (IDFA). - Ustaw
tagForChildDirectedTreatmentnafalse, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA. - Nie ustawiaj
tagForChildDirectedTreatment, jeśli nie chcesz wskazywać, 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 na potrzeby ustawy 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
Możesz oznaczyć swoje żądania reklamy, tak 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). Możesz mieć inne obowiązki prawne wynikające z RODO. 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. Dowiedz się więcej 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 Tag For Users under the Age of Consent in Europe (TFUA). 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.
Tego ustawienia można używać we wszystkich wersjach Google Mobile Ads SDK przez
ustawienie
tagForUnderAgeOfConsent właściwości w obiekcie
GADMobileAds.requestConfiguration i przekazanie wartości true.
- Ustaw
tagForUnderAgeOfConsentnatrue, aby wskazać, że chcesz, aby żądania reklamy były 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). - Nieustawienie
tagForUnderAgeOfConsentoznacza, że nie chcesz, aby żądania reklamy 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 wskazuje, że chcesz, aby w żądaniu reklamy był uwzględniony tag TFUA:
Swift
MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Tagi umożliwiające włączenie ustawienia dotyczącego treści skierowanych do dzieci
i tagForUnderAgeOfConsent nie powinny mieć jednocześnie wartości true.
Jeśli jednak tak jest, ustawienie dotyczące treści skierowanych do dzieci ma pierwszeństwo.
Filtrowanie treści reklam
Aplikacje mogą ustawić maksymalną ocenę treści reklam dla wszystkich żądań reklamy za pomocą właściwości maxAdContentRating w GADRequestConfiguration. To ustawienie dotyczy wszystkich przyszłych żądań reklamy w pozostałej części sesji. Możliwe wartości
tej właściwości są oparte na klasyfikacjach etykiet treści cyfrowychi powinny być jedną
z tych stałych:
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
Ten kod konfiguruje wszystkie żądania reklamy tak, aby zwracane treści reklam odpowiadały etykiecie treści cyfrowych nie wyższej niż GADMaxAdContentRatingGeneral.
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Publisher Privacy Treatment API (beta)
The
Publisher Privacy Treatment
(PPT) API to opcjonalne narzędzie, które umożliwia aplikacjom określenie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy za pomocą
publisherPrivacyPersonalizationState
właściwości GADRequestConfiguration. Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy w pozostałej części sesji znajdzie się parametr Publisher Privacy Treatment (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;
GADRequest
Obiekt GADRequest zbiera informacje o kierowaniu, które mają być wysyłane z żądaniem reklamy.
Dodawanie dodatkowych informacji o sieci
Dodatkowe informacje o sieci to dodatkowe szczegóły wysyłane z żądaniem reklamy, które są specyficzne dla danego źródła reklam.
Ten fragment kodu ustawia dodatkowy klucz parametru collapsible z wartością bottom w 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 wyświetlanych treści. Umożliwia to kierowanie na słowa kluczowe, aby dopasować reklamę do treści.
Jeśli na przykład Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z adresu 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, wyraźnie wywołajloadRequestwGADBannerViewz nowym obiektemGADRequest. - Jak przekazywać dodatkowe parametry kierowania do sieci zapośredniczenia?
- Informacje o tym, jak wysyłać kierowanie do sieci zapośredniczenia, znajdziesz w artykule Zapośredniczenie.