Kierowanie

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

Aby zobaczyć, jak działa kierowanie reklam, pobierz aplikację iOS API Demo w Swift lub Objective-C.

Pobierz wersję demonstracyjną interfejsu API

Wymagania wstępne

Zapoznaj się z przewodnikiem dla początkujących.

GADRequestConfiguration

GADRequestConfiguration to obiekt, który gromadzi informacje kierowania, które mają być stosowane globalnie za pomocą GADMobileAds wspólnego wystąpienia. Dostęp do niego można uzyskać za pomocą tego kodu:

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Aby mieć pewność, że zmiany w konfiguracji żądania zostaną zastosowane do wszystkich żądań reklam, skonfiguruj żądanie przed inicjowaniem pakietu SDK do reklam mobilnych.

Ustawienie skierowane do dzieci

W związku z amerykańską ustawą 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. Jeśli oznaczysz swoje treści jako przeznaczone dla dzieci, Google wyłączy w przypadku tego żądania reklamy oparte na zainteresowaniach i reklamy remarketingowe. Dostępne opcje ustawień:

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

Ten przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako treści kierowane do dzieci na potrzeby ustawy COPPA:

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ustawiając ten tag, potwierdzasz, że ta informacja jest prawidłowa i masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że niewłaściwe użycie tego ustawienia może skutkować zamknięciem Twojego konta Google.

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

Możesz oznaczyć swoje żądania reklamy, aby 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 obowiązki prawne. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się ze swoim prawnikiem. 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 śledzących reklamy lub serwerów reklamowych firm zewnętrznych.

Ustawienia można używać we wszystkich wersjach pakietu SDK do reklam mobilnych Google, ustawiając właściwość tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekazując wartość true.

• Ustaw parametr tagForUnderAgeOfConsent na 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 też przesyłaniu identyfikatora wyświetlania reklam (IDFA).
• Brak ustawienia tagForUnderAgeOfConsent oznacza, ż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.

Ten przykład wskazuje, że chcesz uwzględnić w żądaniu reklamy TFUA:

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

Filtrowanie treści reklam

Aplikacje mogą ustawiać maksymalną ocenę treści reklam w przypadku wszystkich żądań reklamy za pomocą właściwości maxAdContentRating w usługach GADRequestConfiguration. To ustawienie będzie stosowane do wszystkich przyszłych żądań reklamy przez resztę sesji. Możliwe wartości tej właściwości są oparte na klasyfikacjach etykietek treści cyfrowych i powinny być jedną z tych stałych wartości:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Poniższy kod konfiguruje wszystkie żądania reklam, aby określić, że zwrócone treści reklamy powinny odpowiadać etykiecie treści cyfrowych o ocenie nie wyższej niż GADMaxAdContentRatingGeneral.

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment API (beta)

Publisher Privacy Treatment (PPT) API to opcjonalne narzędzie, które pozwala aplikacjom określić, czy wyłączyć personalizację reklam we wszystkich żądaniach reklamy za pomocą właściwości publisherPrivacyPersonalizationState GADRequestConfiguration. Gdy używasz tej funkcji, w przyszłych żądaniach reklamy w trakcie trwania sesji będzie dodawany parametr PPT (publisher privacy treatment).

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

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

Obiekt GAMRequest zbiera informacje kierowania, które mają być wysyłane z żądaniem reklamy.

URL treści

Podczas żą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 np. Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z witrynyhttps://www.example.com, możesz przekazać ten adres URL, aby kierować reklamy na odpowiednie słowa kluczowe:

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

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. W odpowiedzi na to żądanie mogą się wyświetlać elementy zamówienia kierowane według tych par. Aby kierować reklamy na wiele wartości dla jednego klucza, podaj je jako ciąg znaków rozdzielonych przecinkami.

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

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

Bezpieczeństwo marki (wersja beta)

Aplikacje wyświetlające treści dynamiczne przeznaczone dla różnych odbiorców mogą podawać krótką listę adresów URL za pomocą właściwości neighboringContentURLs. Adresy URL sąsiednich treści różnią się od właściwości contentURL tym, że służą tylko do ochrony 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 żądać reklam, które mają podobną ocenę treści do tych adresów URL. Aby to zrobić, podaj je w ten sposób:

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

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

Identyfikatory podawane przez wydawcę

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

Ustawienie identyfikatora PPID odbywa się za pomocą GAMRequest:

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

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

Przykład implementacji identyfikatorów podanych przez wydawcę (PPID) w aplikacji Demo interfejsu API iOS:

Swift Objective-C

Sygnały dostarczane przez wydawcę

Dane o odbiorcach i dane kontekstowe możesz wysyłać w żądaniach reklamy jako sygnały dostarczane przez wydawcę (PPS). Dzięki PPS możesz ulepszać zarabianie na automatyzacji, korzystając z danych o użytkownikach, aby przekazywać cechy odbiorców wszystkim licytującym we wszystkich typach transakcji, używając standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Twoje cechy odbiorców mogą obejmować dane o zachowaniu i zainteresowaniach (taksonomia odbiorców IAB w wersji 1.1) oraz dane kontekstowe (taksonomia treści IAB w wersji 2.2).

let extras = GADExtras()
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 = GAMRequest()
request.register(extras)

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 podczas automatycznego odświeżania reklamy?

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

Jak przekazywać dodatkowe parametry kierowania sieciom zapośredniczącym?

Aby dowiedzieć się, jak przesyłać ustawienia kierowania do sieci zapośredniczenia, zapoznaj się z artykułem Zaspośredniczenie.