Kierowanie

Wybierz platformę: Android iOS Unity Flutter

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 na iOS w języku Swift lub Objective-C.

Pobierz aplikację 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 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 traktowania treści jako skierowanych do dzieci

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 traktowania treści jako skierowanych do dzieci. Ustawienie traktowania treści jako skierowanych do dzieci pozwala określić, czy Google Mobile Ads SDK ma stosować określone zabezpieczenia dotyczące wyświetlania reklam dzieciom i nastolatkom. Gdy używasz tego ustawienia, Google Mobile Ads SDK dodaje do żądań reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić odpowiednie traktowanie treści jako skierowanych do dzieci w przypadku Twoich użytkowników na podstawie Twoich obowiązków prawnych i regulacyjnych.

Traktowanie treści jako skierowanych do dzieci możesz ustawić za pomocą właściwości ageRestrictedTreatment w GADRequestConfiguration.

Ustawianie traktowania treści jako skierowanych do dzieci

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

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

Ustawianie traktowania treści jako skierowanych do nastolatków

Poniższy przykład pokazuje, że żądania reklamy powinny być traktowane jako skierowane do nastolatków:

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

Ustawianie braku konkretnego traktowania treści jako skierowanych do dzieci

Poniższy przykład pokazuje, że żądania reklamy nie powinny być traktowane jako skierowane do dzieci:

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

Migracja do traktowania treści jako skierowanych do dzieci z TFCD i TFUA

Ustawienie traktowania treści jako skierowanych do dzieci 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 zakresie traktowania treści jako skierowanych do dzieci:

TFCD

tagForChildDirectedTreatment Traktowanie treści jako skierowanych do dzieci
tagForChildDirectedTreatment = true GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false GADAgeRestrictedTreatmentUnspecified
Do tagForChildDirectedTreatment nie przypisano żadnej wartości GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent Traktowanie treści jako skierowanych do dzieci
tagForUnderAgeOfConsent = true GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false GADAgeRestrictedTreatmentUnspecified
Do tagForUnderAgeOfConsent nie przypisano żadnej wartości GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika GADAgeRestrictedTreatmentTeen

Omówienie interakcji traktowania treści jako skierowanych do dzieci z TFCD i TFUA

Jeśli ustawisz traktowanie treści jako skierowanych do dzieci oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej restrykcyjne traktowanie.

Ustawienie dotyczące treści skierowanych do dzieci

Na potrzeby ustawy o ochronie prywatności dzieci w internecie (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 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 ustawienia:

  • Ustaw tagForChildDirectedTreatment na true, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam (IDFA).
  • Ustaw tagForChildDirectedTreatment na false, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby COPPA.
  • Nie ustawiaj tagForChildDirectedTreatment, jeśli nie chcesz wskazywać, jak mają być traktowane Twoje treści w odniesieniu do COPPA.

Poniższy przykład pokazuje, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby 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.

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. Dodaliśmy tę funkcję, by ułatwić spełnianie wymogów Ogólnego rozporządzenia 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 prawnikiem. Pamiętaj, że narzędzia Google mają ułatwiać zachowanie zgodności z przepisami i nie zwalniają wydawców z obowiązków wynikających z 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 TFUA (Tag For Users under the Age of Consent in Europe – tag stosowany w przypadku użytkowników z Europy, którzy nie osiągnęli wieku świadomego wyrażenia zgody). Ten parametr wyłącza reklamy spersonalizowane, w tym remarketing, 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 to można stosować we wszystkich wersjach Google Mobile Ads SDK, ustawiając tagForUnderAgeOfConsent właściwość w obiekcie GADMobileAds.requestConfiguration i przekazując wartość true.

  • Ustaw tagForUnderAgeOfConsent na true, 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 samodzielnego wyrażania zgody. Zapobiega to też przesyłaniu identyfikatora wyświetlania reklam (IDFA).
  • Nieustawienie tagForUnderAgeOfConsent oznacza, ż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 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 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. Dostępne wartości tej właściwości są oparte na klasyfikacjach etykiet treści cyfrowychi powinny być jedną z tych stałych:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

Poniższy kod konfiguruje wszystkie żądania reklamy tak, aby zwracane treści reklam odpowiadały 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)

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

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 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.

Poniższy fragment kodu ustawia w Google dodatkowy parametr o kluczu collapsible i 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 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 stosowane, 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łaj loadRequest w GADBannerView z nowym obiektem GADRequest.
Jak przekazywać dodatkowe parametry kierowania do sieci zapośredniczenia?
Aby dowiedzieć się, jak wysyłać kierowanie do sieci zapośredniczenia, zapoznaj się z informacjami o zapośredniczeniu.