Segmentação

Selecione a plataforma: Android iOS Unity Flutter

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

Para um exemplo funcional, faça o download do app Android API Demo.

Fazer o download da demonstração da API

Pré-requisito

RequestConfiguration

RequestConfiguration coleta informações de segmentação aplicadas globalmente a todas as solicitações de anúncio. Para ver 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);

Para garantir que todas as solicitações de anúncio apliquem as mudanças na configuração, defina a configuração de solicitação antes de inicializar o SDK de anúncios para dispositivos móveis.

Configuração "feito para crianças"

Para fins da Lei de Proteção da Privacidade On-line das Crianças (COPPA), existe uma configuração chamada "Identificar para tratamento direcionado a crianças". Ao definir essa tag, você certifica que esta notificação está correta e que 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 feito para crianças quando 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 desativar a publicidade com base em interesses e os anúncios de remarketing nessa solicitação de anúncio.

Você pode aplicar a configuração de direcionamento a crianças em 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 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 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 de acordo com a COPPA em solicitações de anúncio.

O exemplo a seguir indica que você quer que seu conteúdo seja tratado como direcionado a 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);

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 obedecer ao Regulamento geral de proteção de dados (GDPR). É possível que 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 e não livram os publishers das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, um parâmetro TFUA (Tag para usuários abaixo da idade de consentimento na Europa) é incluído na solicitação de anúncio. Ele desativa a publicidade personalizada, incluindo o remarketing, para todas as solicitações de anúncio. As solicitações para 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 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 para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. Isso também impede a transmissão do identificador de publicidade do Android (AAID).

  • Chame setTagForUnderAgeOfConsent() com TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE para indicar que você não quer que a solicitação de anúncio seja tratada para 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 deve receber tratamento para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.

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

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 direcionamento a crianças e setTagForUnderAgeOfConsent() não devem ser definidas como true simultaneamente. Se forem, a configuração "feito para crianças" terá precedência.

Filtragem de conteúdo de anúncios

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 mostrados no seu app precisam ser adequados à classificação do conteúdo dele, mesmo que o conteúdo em si esteja de acordo 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 exibidos. 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 complemento de rede são baseados em classificações de rótulos 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 deve corresponder a uma designação de classificação 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:

Tratamento de privacidade do publisher (Beta)

A API Publisher Privacy Treatment (PPT) é uma ferramenta opcional que permite aos apps indicar se a personalização de anúncios precisa ser desativada para todas as solicitações de anúncio usando o método setPublisherPrivacyPersonalizationState(). Ao usar esse recurso, um parâmetro de tratamento de privacidade do publisher (PPT) é incluído em todas as solicitações de anúncio futuras pelo restante da sessão.

Por padrão, as solicitações de anúncios ao Google veiculam anúncios personalizados. O código a seguir 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);

Solicitação de anúncio

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

Adicionar extras de rede

Os extras de rede são detalhes adicionais enviados com uma solicitação de anúncio que são específicos de uma única origem de anúncio.

O snippet de código a seguir define uma chave de parâmetro extra de collapsible com um valor de bottom para o Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()
adLoader.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();
adLoader.loadAd(adRequest);