Kierowanie

Z tego przewodnika dowiesz się, jak podać 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 wersję demonstracyjną interfejsu API

Wymagania wstępne

Zapoznaj się z przewodnikiem Pierwsze kroki.

GADRequestConfiguration

GADRequestConfiguration to obiekt zbierający informacje o kierowaniu, które można stosować globalnie za pomocą współdzielonej instancji GADMobileAds. Dostęp do niego można uzyskać za pomocą tego kodu:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Ustawienie skierowane 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. Jeśli określisz, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci, wyłączymy reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy. Dostępne są następujące opcje ustawień:

• Ustaw tagForChildDirectedTreatment jako true, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. Uniemożliwia to przesyłanie identyfikatora wyświetlania reklam (IDFA).
• Ustaw tagForChildDirectedTreatment jako false, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.
• Nie ustawiaj atrybutu tagForChildDirectedTreatment, jeśli nie chcesz określać, jak Twoje treści mają być traktowane w świetle ustawy COPPA.

Poniższy przykład wskazuje, że Twoje treści mają być traktowane jako skierowane do dzieci zgodnie z ustawą COPPA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ustawiając ten tag, zaświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może spowodować zamknięcie 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 skierowane do użytkowników z Europejskiego Obszaru Gospodarczego, 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 RODO może nakładać na Ciebie 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 wydawców

Gdy będziesz używać tej funkcji, do wszystkich przyszłych żądań reklam będzie uwzględniany parametr „Dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody w Europie (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.

Tego ustawienia można używać we wszystkich wersjach pakietu SDK do reklam mobilnych Google. W tym celu ustaw właściwość tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekaż wartość true.

• Ustaw tagForUnderAgeOfConsent na true, aby wskazać, że chcesz obsługiwać żądania reklam w sposób odpowiedni dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody. Zapobiega to też przesyłaniu identyfikatora wyświetlania reklam (IDFA).
• Jeśli nie ustawisz tagForUnderAgeOfConsent, oznacza to, że nie chcesz, aby żądania reklamy były przetwarzane w sposób odpowiedni dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Tagi włączające ustawienie kierowania do dzieci i tag tagForUnderAgeOfConsent nie powinny jednocześnie mieć wartości true. Jeśli tak, ustawienie dotyczące treści skierowanych do dzieci ma pierwszeństwo.

Ważne: parametr tagForUnderAgeOfConsent nie jest przekazywany do adapterów zapośredniczenia sieci reklamowej. Twoim obowiązkiem jest dopilnowanie, by 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 reklamy

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ń reklam do końca sesji. Możliwe wartości tej właściwości opierają się na klasyfikacjach etykiet treści cyfrowych i powinny być jedną z tych stałych:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Ten kod konfiguruje wszystkie żądania reklam tak, aby zwracana treść reklamy była zgodna z oznaczeniem etykiety treści cyfrowych nie wyższym niż GADMaxAdContentRatingGeneral.

Ważne: ustawienia filtra oceny treści określone w pakiecie SDK zastępują wszystkie ustawienia skonfigurowane za pomocą Ad Manager interfejsu.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Zasady traktowania wydawców (beta)

Publisher Privacy Treatment Interfejs API (PPT) to opcjonalne narzędzie, które pozwala aplikacjom za pomocą właściwości publisherPrivacyPersonalizationState GADRequestConfiguration wskazać, czy należy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy. Gdy ta funkcja jest włączona, we wszystkich przyszłych żądaniach reklamy wyświetlanych w pozostałej sesji sesji będzie uwzględniany parametr PPP.

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

Swift

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

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Uwaga: w przypadku żądań reklamy z wieloma sygnałami dotyczącymi prywatności użytkownika pierwszeństwo ma najbardziej restrykcyjny sygnał. Zapoznaj się z Publisher Privacy Treatment API dokumentacją dotyczącą konkretnych przykładów.

GAMRequest

Obiekt GAMRequest zbiera informacje o kierowaniu wysyłane z żądaniem reklamy.

URL treści

Aplikacja, która wysyła żądanie reklamy, może przekazać adres URL treści, którą wyświetlają. Dzięki temu kierowanie na słowa kluczowe będzie mogło dopasować reklamę do treści.

Jeśli na przykład Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z witryny https://www.example.com, możesz przekazać ten adres URL, aby kierować reklamy na odpowiednie słowa kluczowe:

Swift

let request = GAMRequest()
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ą par klucz-wartość w żądaniu reklamy. Elementy zamówienia kierowane na te pary klucz-wartość mogą realizować wyświetlenia w odpowiedzi na to żądanie reklamy. Aby kierować według wielu wartości jednego klucza, wpisz wartości w postaci ciągu znaków, rozdzielając je przecinkami.

Swift

let request = GAMRequest()
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ą dostarczać krótką listę adresów URL za pomocą właściwości neighboringContentURLs. Sąsiednie adresy URL treści różnią się od właściwości contentURL tym, że są używane tylko do zapewnienia 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 wysyłać żądania reklam o ocenie treści podobnej do tych adresów URL, przekazując je w ten sposób:

Swift

let request = GAMRequest()
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 4 pierwszych adresów URL. Pozostałe są ignorowane.

Identyfikatory podawane przez wydawcę

Możesz skonfigurować identyfikator podawany 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.

Uwaga: ta funkcja jest niedostępna dla niektórych wydawców. Więcej informacji znajdziesz w artykule Informacje o identyfikatorach podawanych przez wydawców.

Identyfikator PPID można skonfigurować za pomocą usługi GAMRequest:

Swift

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

Objective-C

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

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

Swift Objective-C

Sygnały dostarczane przez wydawcę

Możesz wysyłać dane o odbiorcach i dane kontekstowe jako sygnały dostarczane przez wydawcę w żądaniach reklamy. Dzięki sygnacjom PPS możesz wykorzystywać dane użytkowników, aby ulepszać automatyzację z automatyzacją, przekazując licytującym cechy odbiorców licytującym we wszystkich typach transakcji za pomocą standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Cechy odbiorców mogą obejmować dane o zachowaniu i zainteresowaniach (taksonomia odbiorców IAB 1.1) oraz dane kontekstowe (taksonomia treści IAB 2.2).

Swift

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)

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 ustawienia kierowania są stosowane, gdy reklama jest automatycznie odświeżana?

Po odświeżeniu reklamy wskazany wcześniej obiekt GAMRequest jest ponownie używany do kierowania. Aby ustawić nowe kierowanie, jawnie wywołaj loadRequest w obiekcie GAMBannerView z nowym obiektem GAMRequest.

Jak przekazać dodatkowe parametry kierowania do sieci zapośredniczenia?

Aby dowiedzieć się, jak wysyłać kierowanie do sieci zapośredniczenia, przeczytaj sekcję Zapośredniczenie.