Kierowanie

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

Aby zobaczyć, jak działa kierowanie reklam, pobierz aplikację demonstracyjną interfejsu API iOS w języku 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 zbiera informacje o kierowaniu, aby można je było stosować globalnie za pomocą instancji udostępnionej GADMobileAds. Dostęp do niego można uzyskać za pomocą tego kodu:

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Aby mieć pewność, że wszystkie żądania reklamy uwzględniają zmiany w konfiguracji żądania, ustaw konfigurację żądania przed zainicjowaniem pakietu SDK do reklam mobilnych Google.

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 Google traktowało Twoje treści jako skierowane do dzieci, podejmie ono działania mające na celu wyłączenie w tym żądaniu reklamy opartej na zainteresowaniach i reklamy remarketingowej. Dostępne opcje ustawień:

• Ustaw wartość 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 wyświetlania reklam (IDFA).
• Ustaw wartość tagForChildDirectedTreatment na false, 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 w rozumieniu ustawy COPPA:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ustawiając ten tag, potwierdzasz, że to powiadomienie jest prawidłowe 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 samodzielnego wyrażania 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 śledzących reklamy lub serwerów reklamowych firm zewnętrznych.

To ustawienie można stosować we wszystkich wersjach pakietu SDK do reklam mobilnych Google, konfigurując właściwość tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekazując wartość true.

• Ustaw wartość 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.

Poniższy przykład pokazuje, że chcesz, aby w żądaniu reklamy był uwzględniony parametr TFUA:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

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 maxAdContentRatingGADRequestConfiguration. To ustawienie będzie stosowane do wszystkich przyszłych żądań reklam w pozostałej części sesji. Dostępne wartości tego atrybutu zależą od klasyfikacji etykiet treści cyfrowych i powinny być jedną z tych stałych:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment API (beta)

Interfejs Publisher Privacy Treatment (PPT) to opcjonalne narzędzie, które umożliwia aplikacjom wskazywanie, 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 uwzględniany jest parametr dotyczący traktowania danych zgodnie z zasadami ochrony prywatności wydawcy (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:

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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 wraz z żądaniem reklamy, które są specyficzne dla jednego źródła reklam.

Ten fragment kodu ustawia w Google dodatkowy klucz parametru collapsible z wartością bottom:

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

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

let request = AdManagerRequest()
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 niestandardowe kierowanie za pomocą wartości kluczy w żądaniu reklamy. Elementy zamówienia kierowane według tych par klucz-wartość mogą wtedy realizować wyświetlenia w odpowiedzi na to żądanie reklamy. Aby kierować reklamy na wiele wartości jednego klucza, wpisz wartości jako ciąg znaków rozdzielony przecinkami.

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

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

Załóżmy, że Twoja aplikacja wyświetla treści z 4 adresów URL w kanale, 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:

let request = AdManagerRequest()
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 podawany przez wydawcę (PPID) do wykorzystania 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.

Identyfikator PPID ustawia się za pomocą GAMRequest:

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

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

Przykład implementacji identyfikatorów podawanych przez wydawcę (PPID) w aplikacji demonstracyjnej interfejsu iOS API znajdziesz w przykładzie identyfikatora PPID w usłudze Ad Manager:

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ę. Sygnały dostarczane przez wydawcę umożliwiają Ci wykorzystywanie danych o użytkownikach do poprawy zarabiania w sposób zautomatyzowany poprzez przekazywanie charakterystyki odbiorców podmiotom ustalającym stawki we wszystkich rodzajach transakcji z użyciem standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Charakterystyka odbiorców może obejmować dane związane z zachowaniem i zainteresowaniami (taksonomia odbiorców IAB w wersji 1.1) oraz dane kontekstowe (taksonomia treści IAB w wersji 2.2).

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)

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 stosowane, gdy reklama odświeża się automatycznie?

Po odświeżeniu 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 do sieci zapośredniczenia?

W sekcji Zapośredniczenie znajdziesz informacje o tym, jak wysyłać kierowanie do sieci zapośredniczenia.