Segmentação

Com a segmentação, você pode fornecer informações contextuais e de público-alvo ao Google Mobile Ads SDK for React Native para veicular anúncios relevantes aos usuários.

É possível configurar a segmentação nestes níveis:

  • Configuração de solicitação global: aplique configurações a todas as solicitações de anúncio no seu app, incluindo tratamentos para crianças e adolescentes, classificações máximas de conteúdo do anúncio, tratamentos de privacidade do publisher e IDs de dispositivos de teste.
  • Segmentação por solicitação: personalize solicitações de anúncio individuais usando objetos de solicitação de anúncio, incluindo URLs de conteúdo e extras de rede.

Este guia explica como fornecer informações de segmentação para Google Mobile Ads SDK for React Native.

Pré-requisitos

Antes de continuar, configure o Google Mobile Ads SDK for React Native.

Definir a configuração da solicitação

O objeto RequestConfiguration coleta informações de segmentação aplicadas globalmente a todas as solicitações de anúncio.

Para aplicar as configurações de segmentação da sua primeira solicitação de anúncio, defina a propriedade requestConfiguration ao chamar o método 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.
});

Substitua TEST_DEVICE_HASHED_ID por um ID de dispositivo de teste com hash. Esse ID especifica um dispositivo que deve receber anúncios de teste.

Para atualizar as configurações de segmentação depois de inicializar Google Mobile Ads SDK for React Native, chame o método setRequestConfiguration. O método setRequestConfiguration substitui uma configuração atual e entra em vigor nas solicitações de anúncio seguintes.

O exemplo a seguir revisa um objeto RequestConfiguration com configurações de segmentação atualizadas e as aplica às solicitações de anúncio:

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

setRequestConfiguration(requestConfiguration);

Definir o tratamento por idade

Para ajudar você a gerenciar a conformidade com os regulamentos de privacidade aplicáveis relacionados a crianças e adolescentes, o Google Mobile Ads SDK for React Native oferece uma configuração de tratamento por idade. A configuração de tratamento por idade permite indicar se o Google Mobile Ads SDK for React Native deve aplicar proteções específicas de veiculação de anúncios para crianças, adolescentes ou uma idade não especificada.

É possível definir o tratamento para menores com a propriedade ageRestrictedTreatment em RequestConfiguration.

O exemplo a seguir indica que as solicitações de anúncio devem receber o tratamento para direcionamento a crianças:

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

setRequestConfiguration(requestConfiguration);

Para indicar o tratamento por idade para adolescentes ou idade não especificada, substitua a configuração AgeRestrictedTreatment.CHILD pelo seguinte:

Ao usar essa configuração, o Google Mobile Ads SDK for React Native inclui um parâmetro tfat nas solicitações de anúncios. Consulte sua assessoria jurídica para determinar o tratamento por idade mínima aos seus usuários com base nas obrigações legais e regulatórias. Para mais informações, consulte Incluir tags nas solicitações de anúncios de um app para tratamento com restrição de idade.

Filtrar conteúdo do anúncio

Com a classificação máxima do conteúdo do anúncio, você controla o conteúdo dos anúncios mostrados aos usuários. Você pode definir essa classificação para que fique mais fácil obedecer às políticas da plataforma.

É possível definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncio no seu app usando a propriedade maxAdContentRating no objeto RequestConfiguration. Depois que você definir essa configuração, os anúncios retornados terão uma classificação de conteúdo igual ou inferior a essa. Os valores possíveis para essa configuração consideram as classificações de conteúdo digital e precisam ser uma das seguintes constantes:

O exemplo a seguir configura um objeto RequestConfiguration para especificar que o conteúdo do anúncio retornado deve corresponder a uma classificação de conteúdo digital inferior à constante G:

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

setRequestConfiguration(requestConfiguration);

Se quiser saber mais, consulte estas referências:

Opcional: definir a API PPT (Beta)

A API Publisher Privacy Treatment (PPT) permite indicar se a personalização de anúncios precisa ser desativada para todas as solicitações de anúncio usando a propriedade publisherPrivacyPersonalizationState no objeto RequestConfiguration. Ao usar esse recurso, o Google Mobile Ads SDK for React Native inclui um parâmetro de tratamento de privacidade do publisher (PPT) em todas as solicitações de anúncio pelo restante da sessão.

Por padrão, as solicitações de anúncios ao Google veiculam anúncios personalizados. O exemplo a seguir desativa a personalização de anúncios para todas as solicitações de anúncios:

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

setRequestConfiguration(requestConfiguration);

Definir o objeto AdRequest

O objeto AdRequest coleta as informações de segmentação enviadas com uma solicitação de anúncio.

Ao contrário da configuração global definida com o método setRequestConfiguration, o objeto AdRequest é transmitido ao método load de uma classe de formato de anúncio, por exemplo, InterstitialAd.load para anúncios intersticiais ou BannerAd.load para anúncios de banner.

Adicionar extras de rede

Para transmitir parâmetros específicos da rede para Google Mobile Ads SDK for React Native, como parâmetros para anúncios que podem ser recolhidos, use a propriedade extras.

O exemplo a seguir define uma chave de parâmetro extra de collapsible com um valor de bottom:

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

Forneça um URL de conteúdo

Para fornecer um URL de conteúdo para anúncios segmentados por conteúdo e brand safety, adicione a propriedade contentUrl:

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

O URL do conteúdo pode ter até 512 caracteres.