Kierowanie

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

Aby zobaczyć, jak działa kierowanie reklam, pobierz wersję demonstracyjną iOS API w języku Swift lub Objective-C.

Pobierz wersję demonstracyjną API

Wymagania wstępne

Wykonaj czynności opisane w przewodniku Pierwsze kroki.

GADRequestConfiguration

GADRequestConfiguration to obiekt zbierający dane kierowania, które są stosowane 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

Zgodnie z ustawą o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act, COPPA) dostępne jest 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 wskażesz, że Google ma traktować treści w Twojej witrynie jako skierowane do dzieci, Google wyłączy w tym żądaniu reklamy oparte na zainteresowaniach i reklamy remarketingowe. Dostępne są te opcje:

• Ustaw tagForChildDirectedTreatment na 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 na false, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.
• Nie używaj ustawienia tagForChildDirectedTreatment, jeśli nie chcesz określać, jak Twoje treści mają być traktowane w świetle ustawy COPPA.

Ten 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, poświadczasz, że to powiadomienie jest prawidłowe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Przyjmujesz do wiadomości, ż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, aby były traktowane jako dotyczące 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 inne obowiązki prawne. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się z 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 używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy będzie uwzględniany tag dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody w Europie. 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ć ze wszystkimi wersjami pakietu SDK do reklam mobilnych Google. Aby to zrobić, ustaw właściwość tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekaż wartość true.

• Ustaw tagForUnderAgeOfConsent na true, aby wskazać, że 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. Uniemożliwia to też przesyłanie identyfikatora wyświetlania reklam (IDFA).
• Jeśli nie skonfigurujesz ustawienia 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.

Ten 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 mieć jednocześnie wartości true. Jeśli tak, pierwszeństwo ma ustawienie dotyczące treści skierowanych do dzieci.

Ważne: ten parametr tagForUnderAgeOfConsent nie jest przekazywany do adapterów zapośredniczenia sieci reklamowej. Odpowiadasz za dbanie o to, 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 reklamy

Aplikacje mogą ustawiać maksymalną ocenę treści reklam w przypadku wszystkich żądań reklamy za pomocą właściwości maxAdContentRating GADRequestConfiguration. To ustawienie będzie stosowane do wszystkich przyszłych żądań reklamy 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, aby określić, że zwrócone treści reklamy powinny być zgodne z oznaczeniem 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 w interfejsie Ad Manager .

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Zasady ochrony prywatności dla wydawców (beta)

Zasady dotyczące ochrony prywatności wydawców Interfejs API PPT to opcjonalne narzędzie, które za pomocą właściwości publisherPrivacyPersonalizationState GADRequestConfiguration pozwala aplikacjom określić, czy mają one wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy. Gdy używasz tej funkcji, parametr ochrony prywatności wydawcy (PPT) będzie dołączany do wszystkich przyszłych żądań reklamy do końca sesji.

Domyślnie żądania reklam wysyłane do Google to 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ł. Więcej przykładów znajdziesz w dokumentacji Publisher Privacy Treatment API .

GAMRequest

Obiekt GAMRequest zbiera informacje o kierowaniu, które są wysyłane w odpowiedzi na żądanie reklamy.

URL treści

Gdy aplikacja wysyła żądanie reklamy, może przekazać adres URL treści, które wyświetla. Umożliwi to kierowanie reklam na słowa kluczowe w celu dopasowania reklamy do treści.

Jeśli na przykład aplikacja żąda reklamy i wyświetla treści z witryny https://www.example.com, możesz przekazać ten adres URL, by 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ść będą mogły wtedy realizować wyświetlenia w odpowiedzi na to żądanie reklamy. Aby kierować reklamy na wiele wartości 1 klucza, wpisz je w postaci ciągu znaków rozdzielonego 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ąsiadujące adresy URL 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 pliku danych, który zawiera również reklamy. Możesz poprosić o reklamy, które mają ocenę treści podobną do tych adresów URL, przesyłają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 pierwszych 4 adresów URL. Pozostałe są ignorowane.

Identyfikatory podawane przez wydawcę

Możesz ustawić identyfikator podawany przez wydawcę (PPID), który będzie używany na potrzeby ograniczenia liczby wyświetleń, podziału 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 jest niedostępna dla niektórych wydawców. Więcej informacji znajdziesz w sekcji Informacje o identyfikatorach podawanych przez wydawców.

Identyfikatora PPID można ustawić na stronie GAMRequest:

Swift

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

Objective-C

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

Zapoznaj się z przykładem użycia identyfikatora PPID w usłudze Ad Manager, by dowiedzieć się, jak wdrożyć identyfikatory podawane przez wydawcę (PPID) w aplikacji demonstracyjnej interfejsu API na iOS:

Swift Objective-C

Sygnały dostarczane przez wydawcę

W żądaniach reklam możesz wysyłać dane o odbiorcach i dane kontekstowe jako sygnały dostarczane przez wydawcę. Dzięki nim możesz używać danych o użytkownikach do polepszania automatyzacji generowania przychodu przez przekazywanie informacji o odbiorcach licytującym we wszystkich typach transakcji przy użyciu standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Charakterystyka odbiorców może obejmować dane o zachowaniach 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 kierowanie jest wykorzystywane, gdy reklama jest automatycznie odświeżana?

Po odświeżeniu reklamy podany wcześniej obiekt GAMRequest jest ponownie używany do kierowania. Aby ustawić nowe kierowanie, jawnie wywołaj loadRequest w metodzie GAMBannerView za pomocą nowego obiektu GAMRequest.

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

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