Segmentação


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

Pré-requisitos

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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 aplicativo. 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.

A configuração pode ser definida atribuindo o membro tag_for_child_directed_treatment do struct RequestConfiguration a um dos seguintes valores de enumeração:

  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue para indicar que seu conteúdo deve ser tratado como direcionado a crianças para fins da COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que seu conteúdo não deve ser tratado como feito para crianças para fins da COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se não quiser indicar como tratar seu conteúdo em relação à COPPA nas solicitações de anúncio.

O exemplo a seguir indica que seu conteúdo deve ser tratado como direcionado 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 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.

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. Ele desativará a publicidade personalizada, incluindo o remarketing, para todas as solicitações. 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 direcionamento para 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 de enumeração:

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

O exemplo a seguir indica que a TFUA deve ser incluída 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 de direcionamento a crianças e de usuários abaixo da idade de consentimento não devem ser definidas simultaneamente como "true". Se isso acontecer, a configuração 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 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 isso são baseados nas classificações de conteúdo digital e precisam ser um dos seguintes valores de enumeração:

  • 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 classificação de conteúdo digital inferior 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 as informações de segmentação que serão 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 corresponda o anúncio ao conteúdo.

Por exemplo, se o app estiver solicitando um anúncio enquanto mostra conteúdo de https://www.example.com, você poderá transmitir esse 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();