Kierowanie

Kierowanie umożliwia przekazywanie do Google Mobile Ads SDK for React Native informacji o kontekście i odbiorcach, dzięki czemu możesz wyświetlać użytkownikom trafne reklamy.

Kierowanie możesz skonfigurować na tych poziomach:

  • Globalna konfiguracja żądań: zastosuj ustawienia we wszystkich żądaniach reklam w aplikacji, w tym dotyczące traktowania treści jako skierowanych do dzieci i nastolatków, maksymalnych ocen treści reklam, traktowania wydawców pod kątem prywatności i identyfikatorów urządzeń testowych.
  • Kierowanie na żądanie: dostosowywanie poszczególnych żądań reklamy za pomocą obiektów żądań reklamy, w tym adresów URL treści i dodatkowych informacji wysyłanych z żądaniem reklamy.

Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu do Google Mobile Ads SDK for React Native.

Wymagania wstępne

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK for React Native.

Ustawianie konfiguracji żądania

Obiekt RequestConfiguration zbiera informacje o kierowaniu stosowane globalnie do każdego żądania reklamy.

Aby zastosować ustawienia kierowania z pierwszego żądania reklamy, ustaw właściwość requestConfiguration podczas wywoływania metody initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Zastąp TEST_DEVICE_HASHED_ID zaszyfrowanym identyfikatorem urządzenia testowego. Ten identyfikator określa urządzenie, na którym mają się wyświetlać reklamy testowe.

Aby zaktualizować ustawienia kierowania po zainicjowaniu Google Mobile Ads SDK for React Native, wywołaj metodę setRequestConfiguration. Metoda setRequestConfiguration zastępuje istniejącą konfigurację i ma zastosowanie do kolejnych żądań reklamy.

W tym przykładzie zmieniamy obiekt RequestConfiguration, aktualizując ustawienia kierowania, i stosujemy te ustawienia do żądań reklamy:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Ustawianie traktowania treści z uwzględnieniem wieku

Aby pomóc Ci zachować zgodność z obowiązującymi przepisami dotyczącymi prywatności dzieci i nastolatków, Google Mobile Ads SDK for React Native udostępnia ustawienie traktowania odpowiednio do wieku. Ustawienie traktowania ze względu na wiek pozwala określić, czy usługa Google Mobile Ads SDK for React Native 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 RequestConfiguration.

Poniższy przykład wskazuje, że żądania reklamy powinny być traktowane jako treści skierowane do dzieci:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Aby wskazać, że treści są skierowane do nastolatków lub że nie określono wieku, zastąp ustawienie AgeRestrictedTreatment.CHILD tym:

Gdy używasz tego ustawienia, Google Mobile Ads SDK for React Native 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 z aplikacji pod kątem przetwarzania z ograniczeniami wiekowymi.

Filtrowanie treści reklam

Maksymalna ocena treści reklam pozwala kontrolować zawartość reklam wyświetlanych użytkownikom. Aby zachować zgodność z zasadami platformy, możesz ustawić maksymalną ocenę treści.

Możesz ustawić maksymalną ocenę treści reklam w przypadku żądań reklamy w aplikacji, używając właściwości maxAdContentRating obiektu RequestConfiguration. Po skonfigurowaniu tego ustawienia zwracane reklamy będą miały ocenę treści równą tej ocenie lub niższą. Możliwe wartości tego ustawienia są oparte na klasyfikacjach oznaczeń treści cyfrowych i muszą być jedną z tych stałych:

W przykładzie poniżej skonfigurowano obiekt RequestConfiguration, aby określić, że zwracane treści reklamowe powinny odpowiadać etykiecie treści cyfrowych nie wyższej niż stała G:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Więcej informacji znajdziesz w tych artykułach:

Opcjonalnie: ustaw interfejs PPT API (beta)

Interfejs Publisher Privacy Treatment (PPT) API umożliwia określenie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy, za pomocą właściwości publisherPrivacyPersonalizationState obiektu RequestConfiguration. Gdy używasz tej funkcji, Google Mobile Ads SDK for React Native dołącza parametr Publisher Privacy Treatment (PPT) do wszystkich żądań reklamy do końca sesji.

Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. W tym przykładzie wyłączamy personalizację reklam we wszystkich żądaniach reklamy:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Ustaw obiekt AdRequest

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

W przeciwieństwie do konfiguracji globalnej ustawionej za pomocą metody setRequestConfiguration obiekt AdRequest jest przekazywany do metody load klasy formatu reklamy, np. InterstitialAd.load w przypadku reklam pełnoekranowych lub BannerAd.load w przypadku banerów reklamowych.

Dodawanie dodatkowych informacji wysyłanych z żądaniem reklamy

Aby przekazać do Google Mobile Ads SDK for React Native parametry specyficzne dla sieci, np. parametry reklam zwijanych, użyj właściwości extras.

W tym przykładzie ustawiono dodatkowy klucz parametru collapsible z wartością bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Podaj adres URL treści

Aby podać adres URL treści na potrzeby reklam kierowanych na treść strony i bezpieczeństwa marki, dodaj właściwość contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

Adres URL treści może mieć maksymalnie 512 znaków.