Segmentação

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

Pré-requisito

Antes de continuar, configure o GMA Next-Gen SDK.

RequestConfiguration

RequestConfiguration coleta informações de segmentação aplicadas globalmente a todas as solicitações de anúncio. Consulte a documentação de RequestConfiguration.Builder para saber quais tags de segmentação estão disponíveis.

Crie um objeto RequestConfiguration com as tags de segmentação necessárias usando o builder e defina a configuração chamando MobileAds.setRequestConfiguration().

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Para aplicar tags de segmentação da primeira solicitação de anúncio, forneça a configuração da solicitação durante a inicialização do SDK:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

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 GMA Next-Gen SDK oferece uma configuração de tratamento por idade. A configuração de tratamento por idade permite indicar se o GMA Next-Gen SDK 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 o método setAgeRestrictedTreatment() usando a API RequestConfiguration.Builder.

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

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

  • TEEN
  • UNSPECIFIED

Ao usar a configuração, o GMA Next-Gen SDK 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.

Migrar para o tratamento por idade da TFCD e da TFUA

A configuração de tratamento por idade substitui as configurações descontinuadas .setTagForChildDirectedTreatment() (TFCD) e .setTagForUnderAgeOfConsent() (TFUA).

A tabela a seguir mostra as configurações de TFCD e TFUA e os equivalentes de tratamento por idade:

TFCD

TFCD Tratamento por idade
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Nenhum valor foi atribuído .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
Não há equivalente AgeRestrictedTreatment.TEEN

TFUA

TFUA Tratamento por idade
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Nenhum valor foi atribuído .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
Não há equivalente AgeRestrictedTreatment.TEEN

Sobre as interações de tratamento por idade com a TFCD e a TFUA

Se você definir a configuração de tratamento por idade e as configurações de TFCD ou TFUA, o Google vai aplicar o tratamento mais conservador.

Encaminhar o tratamento por idade com a Mediação da AdMob

Se você definir o tratamento por idade usando GMA Next-Gen SDK, os adaptadores de mediação vão encaminhar o indicador de tratamento por idade aos SDKs mediados de terceiros.

A tabela abaixo lista as versões do adaptador de mediação que aceitam o encaminhamento do indicador de tratamento com restrição de idade para o SDK de terceiros mediado:

Nome do adaptador de mediação Versão mínima compatível
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize (Vungle) 7.7.4.2
LY (Line) 3.1.1.1
maio 2.0.9.0
Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

Configuração voltada para crianças

De acordo com a Lei de Proteção da Privacidade On-line das Crianças (COPPA), há uma configuração chamada Tag de Tratamento para Direcionamento a Crianças. Ao configurar 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ê está ciente de que o abuso dessa configuração poderá 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. Nesse caso, vamos desativar a IBA e os anúncios de remarketing na solicitação de anúncio.

Você pode usar a configuração voltada para crianças em setTagForChildDirectedTreatment():

  • Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE para indicar que seu conteúdo deve ser 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 seu conteúdo não deve ser tratado como feito para crianças para fins da COPPA.

  • Chame setTagForChildDirectedTreatment com TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED se não quiser indicar como tratar seu conteúdo em relação à COPPA nas 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:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Você pode marcar suas solicitações de anúncios para receber tratamento aos usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. 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 sua assessoria jurídica. Com as ferramentas do Google, é mais fácil obedecer às diretrizes, mas os publishers ainda precisam seguir as obrigações legais. Saiba mais sobre como o GDPR afeta os publishers.

Quando você usar esse recurso, um parâmetro TFUA (Tag para usuários abaixo da idade de consentimento, aplicável à Europa) será incluído na solicitação de anúncio. Este parâmetro 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 de tratamento para direcionamento 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 a solicitação de anúncio deve receber tratamento 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 a solicitação de anúncio não deve receber tratamento 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 se não quiser indicar como tratar a solicitação de anúncio em relação à idade de consentimento no Espaço Econômico Europeu (EEE).

O exemplo a seguir indica que a TFUA deve ser incluída nas suas solicitações de anúncio:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

As tags para ativar a configuração voltada para crianças e setTagForUnderAgeOfConsent() não podem ser definidas ao mesmo tempo como true. Se isso acontecer, a configuração 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 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 a ter mais controle sobre o que é exibido nos anúncios. Você pode definir essa classificação para que fique mais fácil obedecer às 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 que a AdMob retorna com essa configuração têm uma classificação do conteúdo igual ou inferior a esse nível. Os valores possíveis para esse extra de rede consideram as classificações de conteúdo digital e podem 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 classificação de conteúdo digital inferior a G:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.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 = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Coletar localização aproximada

O GMA Next-Gen SDK pode coletar a localização aproximada para segmentar anúncios com base na localização do dispositivo. Se um usuário conceder permissão de localização no seu app, o GMA Next-Gen SDK vai coletar a localização aproximada.

A partir da versão 1.7.0 do GMA Next-Gen SDK, a coleta de localização aproximada fica ativada por padrão. É possível desativar a coleta de localização aproximada usando o método setCoarseLocationCollectionEnabled().

O exemplo a seguir desativa a coleta de localização aproximada:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Disable automatic coarse location collection by the SDK.
    .setCoarseLocationCollectionEnabled(false)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Disable automatic coarse location collection by the SDK.
        .setCoarseLocationCollectionEnabled(false)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Solicitação de anúncio

O objeto AdRequest coleta as informações de segmentação que serão 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, específicos a 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 =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);