Segmentação

Este guia explica como fornecer informações de segmentação ao SDK de anúncios para dispositivos móveis do Google.

Para conferir um exemplo funcional, faça o download do app de demonstração da API Android.

Download da demonstração da API

Pré-requisito

• Concluir o Guia para iniciantes.

RequestConfiguration

RequestConfiguration coleciona informações de segmentação aplicadas globalmente a cada solicitação de anúncio. Para conferir as tags de segmentação disponíveis, consulte a documentação RequestConfiguration.Builder.

Para atualizar a configuração da solicitação, extraia um builder da configuração atual, faça as atualizações desejadas e defina-o da seguinte maneira:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Configuração direcionada a crianças

Para fins da Lei de Proteção da Privacidade On-line da Criança (COPPA), há uma configuração chamada "etiqueta de tratamento direcionado a crianças". Ao definir esta tag, você confirma que esta notificação é precisa e que tem autorização para agir em nome do proprietário do app. Você entende que o abuso desta configuração pode resultar no encerramento da sua conta Google.

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seu conteúdo como direcionado a crianças quando você fizer uma solicitação de anúncio. Se você indicar que quer que o Google trate seu conteúdo como direcionado a crianças, vamos tomar medidas para desativar o IBA e os anúncios de remarketing nessa solicitação de anúncio.

É possível aplicar a configuração voltada para crianças usando setTagForChildDirectedTreatment():

• Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE para indicar que você quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA. Isso impede a transmissão do ID de publicidade do Android (AAID).

• Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE para indicar que você não quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA.

• Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED se não quiser indicar como seu conteúdo será tratado em relação à COPPA nas solicitações de anúncios.

O exemplo a seguir indica que você quer que seu conteúdo seja tratado como voltado para crianças para fins da COPPA:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Observação: os apps no Programa Feito para Família como apps direcionados a crianças e os usuários conectados a Contas do Google gerenciadas com o Family Link têm todo o conteúdo tratado como direcionado a crianças para todas as solicitações de anúncios.

Usuários abaixo da idade de consentimento

Você pode marcar suas solicitações de anúncios para que sejam tratadas como direcionadas a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Esse recurso foi desenvolvido para ajudar a obedecer ao Regulamento geral de proteção de dados (GDPR). Talvez você tenha outras obrigações legais de acordo com o GDPR. Leia as orientações da União Europeia e consulte seu advogado. As ferramentas do Google foram criadas para facilitar a conformidade, mas não isentam os editores das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, um parâmetro de tag para usuários abaixo da idade de consentimento na Europa (TFUA) é incluído na solicitação de anúncio. Esse parâmetro desativa a publicidade personalizada, incluindo o remarketing, para todas as solicitações de anúncios. Além disso, ela desativa as solicitações para fornecedores de anúncios terceirizados, como pixels de medição de anúncios e servidores de anúncios de terceiros.

Assim como nas configurações para crianças, há um método em RequestConfiguration.Builder para definir o parâmetro TFUA: setTagForUnderAgeOfConsent(), com as seguintes opções.

• Chame setTagForUnderAgeOfConsent() com TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE para indicar que você quer que a solicitação de anúncio seja tratada como sendo direcionada a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Isso também impede a transmissão do ID de publicidade do Android (AAID).

• Chame setTagForUnderAgeOfConsent() com TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE para indicar que você quer que a solicitação de anúncio não seja tratada como sendo direcionada a usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.

• Chame setTagForUnderAgeOfConsent() com TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED para indicar que você não especificou se a solicitação de anúncio precisa ser tratada como sendo direcionada a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).

O exemplo a seguir indica que você quer incluir a TFUA nas suas solicitações de anúncios:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

As tags para ativar a Configuração para crianças e setTagForUnderAgeOfConsent() não podem ser definidas como true simultaneamente. Se forem, a configuração direcionada a crianças terá precedência.

Filtragem de conteúdo do anúncio

Para obedecer à política de anúncios inadequados do Google Play, que inclui ofertas associadas em um anúncio, todos os anúncios e as ofertas associadas a eles exibidos no app precisam ser adequados à classificação do conteúdo, mesmo que o conteúdo em si esteja em conformidade com as políticas do Google Play.

Ferramentas como a classificação máxima do conteúdo do anúncio ajudam você a ter mais controle sobre o conteúdo dos anúncios mostrados aos seus usuários. Você pode definir uma classificação máxima do conteúdo para estar de acordo com as políticas da plataforma.

Os apps podem definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncio usando o método setMaxAdContentRating . Os anúncios da AdMob retornados quando isso é configurado têm uma classificação de conteúdo igual ou inferior a esse nível. Os valores possíveis para esse extra de rede são baseados nas classificações de rótulo de conteúdo digital e precisam ser uma das seguintes strings:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

O código abaixo configura um objeto RequestConfiguration para especificar que o conteúdo do anúncio retornado precisa corresponder a uma designação de rótulo de conteúdo digital não superior a G:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Saiba mais sobre:

• Como definir a classificação máxima do conteúdo para cada solicitação de anúncio

• Como definir a classificação máxima do conteúdo do anúncio para um app ou conta

Observação: as configurações do filtro de classificação de conteúdo especificadas pelo SDK dos anúncios para dispositivos móveis do Google substituem as configurações definidas usando a interface AdMob .

Tratamento de privacidade do editor (Beta)

A Tratamento de privacidade do editor (API PPT, na sigla em inglês) é uma ferramenta opcional que permite que os apps indiquem se a personalização de anúncios deve ser desativada para todas as solicitações de anúncios usando o método setPublisherPrivacyPersonalizationState(). Ao usar esse recurso, um parâmetro de tratamento de privacidade do editor (PPT, na sigla em inglês) é incluído em todas as solicitações de anúncios futuras para o restante da sessão.

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Observação: para solicitações de anúncios com vários indicadores de privacidade do usuário, o indicador mais restritivo terá precedência. Consulte a documentação API Publisher Privacy Treatment para conferir exemplos específicos.

Solicitação de anúncio

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

Consulte o exemplo de segmentação de anúncios para conferir uma implementação de segmentação de anúncios no app de demonstração da Android API.