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 na iOS w języku Swift lub Objective-C.

Pobierz wersję demonstracyjną interfejsu API

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration to obiekt, który zbiera informacje o kierowaniu, które mają być stosowane globalnie za pomocą udostępnionej instancji GADMobileAds. Można go stosować za pomocą tego kodu:

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Aby mieć pewność, że wszystkie żądania reklamy będą uwzględniać zmiany w konfiguracji żądań, ustaw konfigurację żądań przed inicjalizacją Google Mobile Ads SDK.

Ustawianie traktowania treści z uwzględnieniem wieku

Aby ułatwić Ci zachowanie zgodności z obowiązującymi przepisami dotyczącymi prywatności dzieci i nastolatków, Google Mobile Ads SDK udostępnia ustawienie traktowania odpowiednio do wieku. Ustawienie traktowania ze względu na wiek pozwala określić, czy usługa Google Mobile Ads SDK ma stosować określone zabezpieczenia dotyczące wyświetlania reklam dzieciom, nastolatkom lub osobom w nieokreślonym wieku.

Możesz ustawić traktowanie treści z uwzględnieniem wieku 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:

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Gdy używasz tego ustawienia, Google Mobile Ads SDK uwzględnia w żądaniach reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić ustawienia dotyczące traktowania użytkowników z uwzględnieniem wieku 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.

Przejście z TFCD i TFUA na traktowanie z uwzględnieniem wieku

Ustawienie dotyczące traktowania ze względu na wiek zastępuje wycofane właściwości tagForChildDirectedTreatment (TFCD) i tagForUnderAgeOfConsent (TFUA).

W tabeli poniżej znajdziesz ustawienia tagForChildDirectedTreatment i tagForUnderAgeOfConsent oraz ich odpowiedniki dotyczące traktowania treści z uwzględnieniem wieku:

Interakcje tagu TFAT z tagami TFCD i TFUA

Jeśli skonfigurujesz ustawienie dotyczące traktowania z uwzględnieniem wieku oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze traktowanie.

Przekazywanie informacji o traktowaniu treści z uwzględnieniem wieku w zapośredniczeniu

Jeśli ustawisz traktowanie z uwzględnieniem wieku za pomocą Google Mobile Ads SDK, adaptery zapośredniczenia będą przekazywać sygnał traktowania z uwzględnieniem wieku do pakietów SDK innych firm, które uczestniczą w zapośredniczeniu.

W tabeli poniżej znajdziesz wersje adaptera zapośredniczenia, które obsługują przekazywanie sygnału dotyczącego ograniczeń wiekowych do pakietu SDK zewnętrznego źródła reklam objętego zapośredniczeniem:

Ustawienie dotyczące treści skierowanych do dzieci

W celu zapewnienia zgodności z ustawą o ochronie prywatności dzieci w internecie (COPPA) dostępna jest opcja 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, Google podejmie kroki, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy. Dostępne są te opcje:

• Ustaw parametr tagForChildDirectedTreatment na true, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam (IDFA).
• Ustaw parametr 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 parametru 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 zgodnie z ustawą COPPA:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

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

Możesz oznaczyć swoje żądania reklamy, aby zostały objęte ograniczonym przetwarzaniem danych w przypadku 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). RODO może nakładać na Ciebie także inne obowiązki prawne. Zapoznaj się z wytycznymi Unii Europejskiej i skonsultuj się ze swoim prawnikiem. 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

Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy znajdzie się parametr TFUA (tagowanie treści dla osób, które nie osiągnęły 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 pomiaru skuteczności reklam lub serwerów reklamowych firm zewnętrznych.

To ustawienie może być używane ze wszystkimi wersjami Google Mobile Ads SDK przez ustawienie właściwości tagForUnderAgeOfConsent w obiekcie GADMobileAds.requestConfiguration i przekazanie true.

• Ustaw parametr tagForUnderAgeOfConsent na true, aby wskazać, że żądania reklam mają być obsługiwane 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 parametru tagForUnderAgeOfConsent, oznacza to, ż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 świadomego wyrażenia zgody.

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

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

Filtrowanie treści reklam

Aplikacje mogą ustawiać maksymalną ocenę treści reklam dla wszystkich żądań reklamy za pomocą właściwości maxAdContentRating obiektu GADRequestConfiguration. To ustawienie dotyczy wszystkich przyszłych żądań reklamy do końca sesji. Możliwe wartości tej właściwości są oparte na klasyfikacjach oznaczeń treści cyfrowych i powinny być jedną z tych stałych:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Poniższy kod konfiguruje wszystkie żądania reklamy, aby określić, że zwracane treści reklam 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 (beta)

Interfejs Publisher Privacy Treatment (PPT) API to opcjonalne narzędzie, które umożliwia aplikacjom wskazywanie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy, za pomocą właściwości publisherPrivacyPersonalizationState obiektu GADRequestConfiguration. Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy w pozostałej części sesji uwzględniany jest parametr ustawień prywatności wydawcy (PPT).

Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. Ten 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ą zostać wysłane z żądaniem reklamy.

Dodawanie dodatkowych informacji wysyłanych z żądaniem reklamy

Dodatkowe informacje wysyłane z żądaniem reklamy to dodatkowe szczegóły wysyłane z żądaniem reklamy, które są specyficzne dla jednego źródła reklam.

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

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ą. Umożliwia to kierowanie na słowa kluczowe, aby dopasować reklamę do treści.

Jeśli na przykład aplikacja żąda 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:

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 kierowanie niestandardowe z użyciem par klucz-wartość w żądaniu reklamy. W odpowiedzi na żądanie elementy zamówienia kierowane według tych par klucz-wartość mogą realizować wyświetlenia. Aby kierować reklamy na wiele wartości jednego klucza, wpisz wartości jako ciąg znaków rozdzielonych 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ą zawartość dynamiczną przeznaczoną dla różnych odbiorców, mogą udostępniać krótką listę adresów URL we właściwości neighboringContentURLs. Adresy URL treści sąsiadujących różnią się od właściwości contentURL tym, że są używane tylko do zapewniania bezpieczeństwa marki.

Załóżmy, że Twoja aplikacja wyświetla treści z 4 adresów URL w kanale, który zawiera też reklamy. Możesz żądać reklam, które mają podobną ocenę treści jak te adresy 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 identyfikatora PPID w usłudze Ad Manager, który pokazuje implementację identyfikatorów podawanych przez wydawcę (PPID) w aplikacji demonstracyjnej interfejsu API na 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ę. Dzięki sygnałom dostarczanym przez wydawcę możesz używać danych użytkowników do ulepszania zarabiania automatycznego przez przekazywanie licytującym informacji o charakterystyce odbiorców we wszystkich typach transakcji za pomocą standardowych taksonomii, bez konieczności udostępniania identyfikatorów użytkowników. Cechy odbiorców mogą obejmować dane związane z zachowaniem i dane oparte na zainteresowaniach (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 używane, gdy reklama odświeża się automatycznie?

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

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

Więcej informacji o wysyłaniu kierowania do sieci zapośredniczenia znajdziesz w artykule Zapośredniczenie.