Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu w żądaniu reklamy.
Aby zobaczyć, jak działa kierowanie reklam, pobierz aplikację w wersji demonstracyjnej interfejsu API 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, aby można je było stosować globalnie za pomocą
wspólnej instancji GADMobileAds. Dostęp do niego można uzyskać za pomocą tego kodu:
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Aby mieć pewność, że wszystkie żądania reklamy uwzględniają zmiany konfiguracji żądania, ustaw konfigurację żądania przed zainicjowaniemGoogle Mobile Ads SDK.
Ustawianie ograniczeń wiekowych
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 dotyczące traktowania ze względu na wiek. Ustawienie dotyczące traktowania ze względu na wiek pozwala określić, czy Google Mobile Ads SDK ma stosować specjalne zabezpieczenia dotyczące wyświetlania reklam dzieciom, nastolatkom lub użytkownikom w nieokreślonym wieku.
Możesz ustawić traktowanie treści z uwzględnieniem wieku za pomocą właściwości ageRestrictedTreatment w przypadku elementu 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ć traktowanie treści jako skierowanych do nastolatków lub nieokreślonych, zastąp ustawienie .child tymi wartościami:
.teen.unspecified
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
Aby wskazać traktowanie treści jako skierowanych do nastolatków lub nieokreślonych, zastąp ustawienie GADAgeRestrictedTreatmentChild tymi wartościami:
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
Gdy używasz tego ustawienia,Google Mobile Ads SDK w żądaniach reklamy umieszcza parametr tfat. Skonsultuj się z prawnikiem, aby określić odpowiednie 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 ograniczenia wiekowego.
Migracja z tagów TFCD i TFUA na tagowanie treści pod kątem wieku odbiorców
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 w ustawieniach dotyczących traktowania treści z uwzględnieniem wieku:
TFCD
tagForChildDirectedTreatment |
Ograniczenia wiekowe |
|---|---|
tagForChildDirectedTreatment = true |
GADAgeRestrictedTreatmentChild |
tagForChildDirectedTreatment = false |
GADAgeRestrictedTreatmentUnspecified |
Brak przypisanej wartości do parametru tagForChildDirectedTreatment |
GADAgeRestrictedTreatmentUnspecified |
| Brak odpowiednika | GADAgeRestrictedTreatmentTeen |
TFUA
tagForUnderAgeOfConsent |
Ograniczenia wiekowe |
|---|---|
tagForUnderAgeOfConsent = true |
GADAgeRestrictedTreatmentChild |
tagForUnderAgeOfConsent = false |
GADAgeRestrictedTreatmentUnspecified |
Brak przypisanej wartości do parametru tagForUnderAgeOfConsent |
GADAgeRestrictedTreatmentUnspecified |
| Brak odpowiednika | GADAgeRestrictedTreatmentTeen |
Interakcje traktowania treści ze względu na wiek 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.
Ustawienie dotyczące treści skierowanych do dzieci
.Na potrzeby ustawy o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act, COPPA) istnieje ustawienie o nazwie 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 Twoje treści były traktowane jako skierowane do dzieci, Google podejmie działania mające na celu wyłączenie w tym żądaniu reklamy opartej na zainteresowaniach i reklamy remarketingowej. Dostępne opcje ustawień:
- Ustaw wartość
tagForChildDirectedTreatmentnatrue, aby wskazać, że Twoje treści mają być traktowane jako skierowane do dzieci na potrzeby ustawy COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam (IDFA). - Ustaw wartość
tagForChildDirectedTreatmentnafalse, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. - Nie ustawiaj wartości
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 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, by były traktowane jako dotyczące 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). Pamiętaj, że zgodnie z RODO możesz mieć także inne zobowiązania. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się ze swoim radcą prawnym. Pamiętaj, że 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
Jeśli użyjesz tej funkcji, do wszystkich przyszłych żądań reklamy dodamy 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.
Ustawienie można stosować we wszystkich wersjach Google Mobile Ads SDK, ustawiając właściwość tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekazując wartość true.
- Ustaw parametr
tagForUnderAgeOfConsentna wartośćtrue, aby wskazać, że żądania reklamy mają być obsługiwane w sposób odpowiedni dla użytkowników, którzy nie osiągnęli wieku samodzielnego wyrażania zgody. Zapobiega to również przesyłaniu identyfikatora wyświetlania reklam (IDFA). - Brak ustawienia
tagForUnderAgeOfConsentoznacza, ż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 samodzielnego wyrażania zgody.
Poniższy przykład pokazuje, że chcesz, aby w żądaniu reklamy był uwzględniony parametr 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 kierowanych do dzieci i tagForUnderAgeOfConsent nie powinny mieć jednocześnie wartości true.
Jeśli tak jest, ustawienie dotyczące aplikacji 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 obiektu GADRequestConfiguration. To ustawienie będzie obowiązywać w przypadku wszystkich przyszłych żądań reklam do końca sesji. Dostępne wartości tego atrybutu zależą od klasyfikacji etykiet treści cyfrowych i powinny być jedną z tych stałych:
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
Poniższy kod konfiguruje wszystkie żądania reklam tak, aby określały, że zwracane treści reklamowe powinny odpowiadać oznaczeniu etykiety treści cyfrowych nie wyższemu niż GADMaxAdContentRatingGeneral.
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Publisher Privacy Treatment API (beta)
Interfejs Publisher Privacy Treatment (PPT) to opcjonalne narzędzie, które umożliwia aplikacjom określenie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklam za pomocą właściwości publisherPrivacyPersonalizationState obiektu GADRequestConfiguration. Gdy używasz tej funkcji, w żądaniach reklam wysyłanych w dalszej części sesji znajduje się parametr dotyczący sposobu traktowania danych użytkowników przez wydawcę (PPT).
Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. Poniższy 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 wraz 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 jednego źródła reklam.
Ten fragment kodu ustawia w Google dodatkowy klucz parametru collapsible o wartości bottom:
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ą. Dzięki temu kierowanie na słowa kluczowe może dopasować reklamę do treści.
Jeśli na przykład Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z domeny 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 stosowane, gdy reklama odświeża się automatycznie?
- Po odświeżeniu reklamy do kierowania ponownie używany jest wcześniej określony obiekt
GADRequest. Aby ustawić nowe kierowanie, wywołaj jawnie funkcjęloadRequestw obiekcieGADBannerViewz nowym obiektemGADRequest. - Jak przekazywać dodatkowe parametry kierowania do sieci zapośredniczenia?
- W sekcji Zapośredniczenie znajdziesz informacje o tym, jak wysyłać kierowanie do sieci zapośredniczenia.