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 można je było stosować 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 z uwzględnieniem wieku

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 z uwzględnieniem wieku. 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.

Traktowanie treści z uwzględnieniem wieku 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
RequestConfigurationSnippets.swift

Aby wskazać traktowanie treści jako skierowanych 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;
RequestConfigurationSnippets.m

Aby wskazać traktowanie treści jako skierowanych do nastolatków lub użytkowników w nieokreślonym wieku, zastąp ustawienie GADAgeRestrictedTreatmentChild jednym z tych ustawień:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

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 z uwzględnieniem wieku użytkowników zgodnie z obowiązującymi Cię wymogami prawnymi i regulacyjnymi. Więcej informacji znajdziesz w artykule Tagowanie żądania reklamy jako wymagającego traktowania z uwzględnieniem wieku.

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

Ustawienie traktowania treści z uwzględnieniem wieku 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 z uwzględnieniem wieku:

TFCD

tagForChildDirectedTreatment	Traktowanie treści z uwzględnieniem wieku
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Brak przypisanej wartości do tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Traktowanie treści z uwzględnieniem wieku
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Brak przypisanej wartości do tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
Brak odpowiednika	GADAgeRestrictedTreatmentTeen

Informacje o interakcjach traktowania treści z uwzględnieniem wieku z TFCD i TFUA

Jeśli ustawisz ustawienie dotyczące traktowania ze względu na wiek oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze traktowanie.

Uwaga: w przypadku użytkowników zalogowanych na konta Google zarządzane za pomocą Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci we wszystkich żądaniach reklamy.

Ustawienie dotyczące treści skierowanych do dzieci

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

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ł Twoje treści jako skierowane do dzieci, Google podejmie kroki w celu wyłączenia w tym żądaniu reklamy reklam opartych na zainteresowaniach i reklam remarketingowych. 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 związku z COPPA.

Poniższy przykład wskazuje, ż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.

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

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

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 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). Ten parametr wyłącza reklamy spersonalizowane, w tym remarketing, w przypadku tego konkretnego żądania reklamy. Uniemożliwia również przesłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli śledzących reklamy 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 wskazuje, ż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.

Ważne:ten parametr nie jest przekazywany do adapterów zapośredniczenia w przypadku zewnętrznych źródeł reklam.tagForUnderAgeOfConsent Twoim obowiązkiem jest 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ą 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 reklamowe odpowiadały 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ą wszystkie ustawienia skonfigurowane w interfejsie Ad Managera.

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 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, 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;

Uwaga: w przypadku żądań reklamy z wieloma sygnałami prywatności użytkownika pierwszeństwo ma sygnał najbardziej restrykcyjny. Konkretne przykłady znajdziesz w dokumentacji Publisher Privacy Treatment API.

GAMRequest

Obiekt GAMRequest 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 w Google dodatkowy parametr collapsible z 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ć 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 URL, aby kierować reklamy na odpowiednie słowa kluczowe:

Swift

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

Objective-C

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

Kierowanie niestandardowe

Po skonfigurowaniu par klucz-wartość w interfejsie Ad Managera ustaw kierowanie niestandardowe za pomocą wartości kluczy w żądaniu reklamy. Elementy zamówienia kierowane według tych wartości kluczy mogą się wtedy wyświetlać w odpowiedzi na to żądanie reklamy. Aby kierować reklamy na wiele wartości jednego klucza, wpisz wartości jako ciąg znaków rozdzielonych przecinkami.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Bezpieczeństwo marki (beta)

Aplikacje, które wyświetlają treści dynamiczne przeznaczone dla różnych odbiorców, mogą podać krótką listę adresów URL za pomocą właściwości neighboringContentURLs. Adresy URL sąsiadujących treści różnią się od właściwości contentURL tym, że są używane tylko do bezpieczeństwa marki.

Załóżmy, że Twoja aplikacja wyświetla treści z 4 adresów URL w pliku danych, który zawiera też reklamy. Możesz poprosić o reklamy o podobnej ocenie treści do tych adresów URL, przekazując je w ten sposób:

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Ważne: pakiet SDK używa tylko pierwszych 4 adresów URL. Wszystkie pozostałe są ignorowane.

Identyfikatory podawane przez wydawcę

Możesz ustawić identyfikator podawany przez wydawcę (PPID) do użycia na potrzeby ograniczenia liczby wyświetleń, segmentacji odbiorców, kierowania, sekwencyjnej rotacji reklam i innych funkcji sterujących wyświetlaniem reklam w zależności od odbiorców na różnych urządzeniach.

Uwaga: ta funkcja nie jest dostępna dla wszystkich wydawców. Więcej informacji znajdziesz w artykule Informacje o identyfikatorach podawanych przez wydawców.

Ustawienie identyfikatora PPID odbywa się za pomocą GAMRequest:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Przykład implementacji identyfikatorów podawanych przez wydawcę (PPID) w aplikacji w wersji demonstracyjnej interfejsu API na iOS znajdziesz w przykładzie PPID w Ad Managerze:

Swift Objective-C

Sygnały dostarczane przez wydawcę

W żądaniach reklamy możesz wysyłać dane o odbiorcach i dane kontekstowe jako sygnały dostarczane przez wydawcę. Dzięki sygnałom dostarczanym przez wydawcę możesz używać danych o użytkownikach do zwiększania przychodów z reklam programowych, przekazując charakterystykę odbiorców licytującym we wszystkich typach transakcjiza pomocą standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Charakterystyka odbiorców może obejmować dane behawioralne i dane o zainteresowaniach ( taksonomia odbiorców IAB 1.1) oraz dane kontekstowe ( taksonomia treści IAB 2.2).

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Najczęstsze pytania

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

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

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.