Segmentação


Este guia explica como fornecer informações de segmentação a uma solicitação de anúncio.

Pré-requisitos

RequestConfiguration

RequestConfiguration é uma estrutura que coleta informações de segmentação para serem aplicadas globalmente pela função global SetRequestConfiguration().

Para atualizar a configuração da solicitação, primeiro obtenha a configuração atual, faça as atualizações desejadas e defina da seguinte maneira:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Configuração direcionada a crianças

Para fins da Lei de Proteção da Privacidade On-line das Crianças (COPPA, na sigla em inglês), há uma configuração chamada "identificação para tratamento direcionado a crianças". Ao definir essa 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 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 quando você fizer uma solicitação de anúncio. Se você indicar que quer que o Google trate seu conteúdo como feito para crianças, tomaremos medidas para desativar a publicidade com base em interesses e os anúncios de remarketing nessa solicitação de anúncio.

A configuração pode ser definida atribuindo o membro tag_for_child_directed_treatment da estrutura RequestConfiguration a um dos seguintes valores enumerados:

  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue para indicar que você quer que seu conteúdo seja tratado como direcionado a crianças para fins de COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que você não quer que seu conteúdo seja tratado como feito para crianças para fins de conformidade com a COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se você 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 dirigido a crianças para fins da COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Ao definir essa 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 dessa configuração pode resultar no encerramento da sua Conta do Google.

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). É 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. As ferramentas do Google foram criadas para facilitar a conformidade, mas não liberam 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, na sigla em inglês) será 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 dirigidas a crianças, há um membro em RequestConfiguration para configurar o parâmetro TFUA: tag_for_under_age_of_consent, que pode ser configurado com os seguintes valores enumerados:

  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentTrue para indicar que você quer que a solicitação de anúncio seja tratada como direcionada a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).
  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse 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.
  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentUnspecified para indicar que você não especificou se a solicitação de anúncio precisa ser tratada como sendo direcionada a usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

As tags para ativar a configuração "Child-directed" e "Users under the Age of Consent" 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

Os apps podem definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncio usando o RequestConfiguration::max_ad_content_rating field. Os anúncios da AdMob retornados quando essa configuração é definida têm uma classificação de conteúdo igual ou inferior a esse nível. Os valores possíveis são baseados nas classificações de rótulo de conteúdo digital e precisam ser um dos seguintes valores enumerados:

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

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

URL de conteúdo

Ao solicitar um anúncio, os apps podem transmitir o URL do conteúdo que estiverem veiculando. Isso permite que a segmentação por palavras-chave faça uma correspondência entre o anúncio e o conteúdo.

Por exemplo, se o app estiver solicitando um anúncio enquanto exibe conteúdo de https://www.example.com, você poderá transmitir este URL para segmentar palavras-chave relevantes:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();