Alvejando

Este guia explica como fornecer informações de segmentação para uma solicitação de anúncio. Para ver um exemplo prático, faça o download do app de demonstração da API do Android.

Fazer o download da demonstração da API

Pré-requisito

• Conclua o Guia de primeiros passos.

RequestConfiguration

RequestConfiguration é um objeto que coleta informações de segmentação para serem aplicadas globalmente usando um método estático MobileAds.

Para atualizar a configuração da solicitação, consiga um builder com base na configuração existente. Faça as atualizações desejadas e defina-as da seguinte maneira:

Java

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

Kotlin

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

Configuração "feito para crianças"

De acordo com a Lei de Proteção da Privacidade On-line das Crianças (COPPA, na sigla em inglês), há uma configuração chamada "tag para tratamento para direcionamento a crianças" Ao definir essa tag, você certifica que essa notificação está correta e que você tem autorização para agir em nome do proprietário do app. Você entende que o abuso dessa configuração pode resultar no encerramento da sua Conta do Google.

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seu conteúdo como direcionado a crianças ao fazer uma solicitação de anúncio. Se você quiser que o Google trate seu conteúdo como direcionado ao público infantil, tomaremos medidas para desativar a IBA e os anúncios de remarketing nessa solicitação de anúncio.

A configuração pode ser usada com todas as versões do SDK do Google Play Services via RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• 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 os fins da COPPA. Isso impedirá a transmissão do identificador 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 os fins da COPPA.

• Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED se não quiser indicar como você quer que seu conteúdo seja tratado em relação à COPPA em solicitações de anúncios.

O exemplo a seguir indica que seu conteúdo deve ser tratado como direcionado a crianças para fins da COPPA:

Java

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

Kotlin

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

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

Usuários abaixo da idade de consentimento

É possível marcar suas solicitações de anúncios para que sejam tratadas como sendo direcionadas a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Esse recurso foi projetado para ajudar a facilitar a conformidade com o Regulamento geral de proteção de dados (GDPR). É possível que você tenha outras obrigações legais nos termos do GDPR. Leia a orientação da União Europeia e consulte seu advogado. As ferramentas do Google foram criadas para facilitar a conformidade e não livram os editores das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, uma tag para usuários abaixo da idade de consentimento na Europa (TFUA, na sigla em inglês) será incluída na solicitação de anúncio. Ele desativará a publicidade personalizada, incluindo o remarketing, para todas as solicitações de anúncios. As solicitações a fornecedores de anúncio terceirizados também serão desativadas, como pixels de medição de anúncios e servidores de anúncios de terceiros.

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

• Chame setTagForUnderAgeOfConsent() com TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE para indicar que você quer que a solicitação de anúncio receba tratamento para usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Isso também impedirá a transmissão do identificador 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 receba tratamento para usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).

• 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 receber tratamento para usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).

O exemplo a seguir indica que você quer que a TFUA seja incluída nas solicitações de anúncios:

Java

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

Kotlin

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

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

Filtragem de conteúdo do anúncio

Os apps podem definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncios 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 essa rede são baseados em 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 a seguir configura um objeto RequestConfiguration para especificar que o conteúdo do anúncio retornado precisa corresponder a uma designação de classificação de conteúdo digital não superior a G:

Java

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

Kotlin

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

Observação: as configurações de filtro de classificação do conteúdo especificadas pelo SDK substituirão as configurações definidas na IU da AdMob.

Solicitação de anúncio

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

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